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

  • process String

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

    xos.conf
    process={process_name}

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

    xos.conf
    process=top,lock.sh
    Note

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

  • iplist_interval Second

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

  • file String

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

    다음 예시를 참조하세요.

    xos.conf
    # example
    file=C:/Program Files/Microsoft SQL Server/MSSQL16.MSSQLSERVER/MSSQL/Log/ERRORLOG
    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.2.0 버전 이상에서 지원합니다.

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

XOS 에이전트 실행​

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

start.bat

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

  • 서비스 등록

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

    install_WindowsService.bat create WhatapXOSAgent

  • 서비스 삭제

    install_WindowsService.bat delete WhatapXOSAgent