본문으로 건너뛰기

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이면 디스크 사용률을 수집하지 않습니다.

  • process String

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

    xos.conf
    process={process_name}

    예를 들어, top과 lock.sh 프로세스를 감시 대상으로 설정하려면 다음과 같이 옵션을 설정하세요.

    xos.conf
    process=top,lock.sh
    노트

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

  • iplist_interval Second

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

  • 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 에이전트 2.2.0 버전 이상에서 지원합니다.

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

XOS 에이전트 실행​

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

start.bat

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

  • 서비스 등록

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

    install_WindowsService.bat create WhatapXOSAgent

  • 서비스 삭제

    install_WindowsService.bat delete WhatapXOSAgent