본문으로 건너뛰기

XOS 에이전트 설정

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

노트

  • 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

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

    port_check

  • process_check String

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

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

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

    process_check

    노트

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

  • process_check_interval Second

    기본값 6

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

  • iplist_interval Second

    기본값 0 (Off)

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

    노트

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

  • file String

    로그 메뉴(라이브 테일, 로그 트렌드, 로그 검색, 로그 설정)를 이용하려면 file 옵션에 모니터링하려는 로그 파일명의 절대 경로로 입력하세요.

    다음 예시를 참조하세요.

    xos.conf
    # example
    file=C:/Program Files/Microsoft SQL Server/MSSQL16.MSSQLSERVER/MSSQL/Log/ERRORLOG
    팁

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

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

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

사용자 지표 수집 (SHMON)​

SHMON으로 사용자 정의 Shell Script 결과를 주기적으로 수집해 메트릭스로 저장합니다.

  • shmon Int

    기본값 1

    지원 버전: dbx 2.55.01 & xos 1.2.0f 이상

설정​

  1. 에이전트 설치 경로에 shmon 디렉터리를 생성합니다.
  2. 수집할 쿼리를 .sh 파일로 저장합니다.
  3. xos.conf에 SQLMON을 활성화합니다.
  4. 에이전트를 재기동합니다.
  5. 메트릭스 조회에서 shmon 카테고리를 확인합니다.
# xos.conf
shmon=1
노트
  • file 옵션은 DBX 에이전트 2.2.0 버전 이상에서 지원합니다.

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

XOS 에이전트 실행​

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

start.bat

화면에 표시되는 실행 로그에 에러가 없는지 확인하고 실행을 종료한 후, 다음 순서에 따라 서비스에 등록하세요.

  • 서비스 등록

    xos 폴더에 있는 install_WindowsService.bat 파일을 다음과 같이 실행하여 서비스에 등록하세요. 만약 create 옵션 다음에 이름을 입력하지 않으면 WhatapXOSAgent 이름으로 서비스에 기본 등록됩니다.

    install_WindowsService.bat create WhatapXOSAgent

  • 서비스 삭제

    install_WindowsService.bat delete WhatapXOSAgent
최종 수정: 에