Skip to main content

XOS 에이전트 설정

Not translated
This page is currently being translated. We will complete the translation as soon as possible.

데이터베이스 서버의 자원을 추가로 모니터링하려면 데이터베이스 서버에 별도의 XOS 에이전트를 실행해 데이터를 수집할 수 있습니다.

Note

  • x86 아키텍쳐 기반에서 동작하는 OS 환경에만 적용할 수 있습니다.

  • XOS 에이전트 설치에 대한 자세한 내용은 다음 문서를 참조하세요.

whatap.conf 파일 설정​

XOS 에이전트를 실행하기 전에 whatap.conf 파일에 다음 옵션을 설정하세요.

  • xos Int

    기본값 0

    XOS 에이전트 사용 여부를 설정하세요. 값이 0인 경우 데이터를 수집하지 않습니다. 값을 1 또는 XOS 에이전트의 IP 주소를 입력하세요. IP 주소를 설정하면 해당 XOS 에이전트로부터만 데이터를 수집합니다.

  • xos_port String

    기본값 3002

    XOS 에이전트와 통신할 포트를 설정하세요. XOS 에이전트와는 UDP로 통신합니다. 해당 포트에 방화벽을 설정했다면 UDP 통신을 위해 방화벽을 해제하세요.

  • xos_cpu_iowait Int

    기본값 1

    XOS 에이전트로부터 수집한 CPU 사용률에 iowait의 값을 포함할 수 있습니다. 값을 1로 설정하면 iowait를 포함하고, 0으로 설정하면 iowait를 포함하지 않습니다.

  • xos_mem_buffcache Int

    기본값 0

    XOS 에이전트로부터 수집한 메모리 사용률에 buffcache의 값을 포함할 수 있습니다. 값을 1로 설정하면 buffcache를 포함하고, 0으로 설정하면 buffcache를 포함하지 않습니다.

xos.conf 파일 설정​

xos 디렉터리를 데이터베이스 서버로 복사한 다음, xos.conf 파일에 에이전트 서버 정보를 입력하고 추가 옵션을 설정하세요.

  • dbx_ip String

    DBX 에이전트를 설치한 서버의 IP 주소를 입력하세요.

  • dbx_port String

    기본값 3002

    DBX 에이전트와 통신할 포트를 설정하세요. DBX 에이전트와는 UDP로 통신합니다. 해당 포트에 방화벽을 설정했다면 UDP 통신을 위해 방화벽을 해제하세요.

  • cpu_limit Int

    기본값 0

    limit 설정값보다 큰 값을 가진 프로세스 정보를 수집합니다. 1/100% 단위로 1.23%인 경우 123으로 설정하세요.

  • mem_limit Int

    기본값 10240

    limit 설정값보다 큰 값을 가진 프로세스 정보를 수집합니다. K bytes 단위로 10240은 10M bytes입니다.

  • disk_usage_interval Second

    기본값 60

    인스턴스별 디스크 사용률과 사용 가능 크기, 전체 크기 정보를 표시합니다. 값이 0이면 디스크 사용률을 수집하지 않습니다.

  • port_check String

    XOS 에이전트에서 옵션값으로 지정한 포트로 직접 접속을 시도한 후, 실패 시 해당 포트 리스트를 db_port_check 카테고리로 전송합니다.

    xos.conf
    port_check=192.168.122.113:3333,192.168.122.113:3334

    지정한 포트로 접속이 안될 경우 Analysis > Metrics Search 메뉴에서 db_port_check 카테고리를 선택한 후 확인할 수 있습니다.

    port_check

  • process_check String

    프로세스의 실행 상태를 모니터링할 수 있습니다. 옵션값으로 프로세스 이름을 입력하세요. 쉼표(,)를 구분자로 이용해 여러 개를 등록할 수 있습니다.

    xos.conf
    process_check=pmon,smon,tnslsnr,melong,haha

    해당 문자열을 포함한 프로세스가 모니터링되지 않을 때, db_process_check 카테고리로 데이터를 전송합니다. 예를 들어, melong, haha 2개 프로세스가 없을 경우 Analysis > Metrics Search 메뉴에서 db_process_check 카테고리를 선택한 후 확인할 수 있습니다.

    process_check

    Note

    process_check 옵션을 이용해 데이터베이스에서 실행 중인 프로세스가 종료될 경우 경고 알림을 보낼 수 있습니다. 자세한 내용은 다음 문서를 참조하세요.

  • process_check_interval Second

    기본값 6

    process_check 옵션을 통해 프로세스의 실행 상태를 수집하는 시간 간격을 설정합니다.

  • iplist_interval Second

    기본값 0 (Off)

    데이터베이스 서버의 IP 목록을 수집하는 시간 간격을 설정합니다. 초 단위(최소 3초)로 시간 간격(interval)을 설정할 수 있습니다.

    Note

    whatap.conf 파일에 xos_dbip=true 옵션을 설정하면 db_ip_list 카테고리로 전송합니다. Analysis > Metrics Search 메뉴에서 db_ip_list 카테고리를 선택한 후 확인할 수 있습니다.

  • file String

    Log 메뉴(Live Tail, Log Trend, Log Search, Log Configuration)를 이용하려면 file 옵션에 모니터링하려는 로그 파일명의 절대 경로로 입력하세요.

    다음 예시를 참조하세요.

    xos.conf
    # example
    file=/home/dbuser/sqllib/db2dump/db2diag.log
    Note

    IBM DB2에서 로그 파일의 위치에 대한 자세한 내용은 다음 링크를 참조하세요.

    Tip

    모니터링하려며는 로그 파일을 추가하려면 file, file1, file2과 같은 방식으로 옵션을 추가하세요.

    xos.conf
    file={log_file_path1}
    file1={log_file_path2}
    file2={log_file_path3}
    file3={log_file_path4}
Note
  • file 옵션은 DBX 에이전트 2.3.3 버전 이상에서 지원합니다.

  • Log 메뉴에 대한 자세한 내용은 다음 문서를 참조하세요.

XOS 에이전트 실행​

데이터베이스 서버에서 다음 배치 파일을 실행하세요.

$ ./start.sh

# 또는

$ ./startd.sh # 백그라운드로 실행할 경우