IBM i

Supported OS Mac OS

통합 버전4.1.0

개요

이 검사는 Datadog Agent를 통해 IBM i를 원격으로 모니터링합니다.

설정

아래 지침을 따라 호스트에서 실행되는 에이전트에 대해 이 점검을 설치하고 설정하세요. 컨테이너화된 환경의 경우 이러한 지침을 적용하는 데 가이드가 필요하면 오토파일럿 통합 템플릿을 참조하세요.

참고: 이 검사는 Unix 계열 운영 체제에 특정한 fcntl() 시스템 호출을 사용하므로 Windows에서는 사용할 수 없습니다.

설치

IBM i 점검은 Datadog Agent 패키지에 포함되어 있습니다. 서버에 추가 설치가 필요하지 않습니다.

ODBC 드라이버

IBM i 검사는 IBM i ODBC 드라이버를 사용하여 IBM i 호스트에 원격으로 연결합니다.

IBM i Access - Client Solutions 페이지에서 드라이버를 다운로드하세요. Downloads for IBM i Access Client Solutions을 클릭하고 로그인하면 다운로드 페이지에 액세스할 수 있습니다.

Linux 호스트용 ACS Linux App Pkg 등 플랫폼에 맞는 ACS App Pkg 패키지를 선택합니다. 패키지를 다운로드하고 설치 지침에 따라 드라이버를 설치합니다.

구성

IBM i 검사는 Datadog Agent를 실행하는 호스트에서 원격으로 IBM i 시스템을 쿼리합니다. IBM i 시스템과 통신하려면 Datadog Agent를 실행하는 호스트에 IBM i ODBC 드라이버를 설정해야 합니다.

ODBC 드라이버

ODBC 드라이버가 설치되면 ODBC 구성 파일인 odbc.ini 및 odbcinst.ini를 찾으세요. 위치는 시스템에 따라 다를 수 있습니다. Linux에서는 /etc 디렉터리나 /etc/unixODBC 디렉터리에 위치할 수 있습니다.

이러한 구성 파일을 내장된 Agent 환경(예: Linux 호스트의 /opt/datadog-agent/embedded/etc/)에 복사합니다.

odbcinst.ini 파일은 Agent에 사용 가능한 ODBC 드라이버를 정의합니다. 각 섹션은 하나의 드라이버를 정의합니다. 예를 들어 다음 섹션에서는 IBM i Access ODBC Driver 64-bit라는 드라이버를 정의합니다.

[IBM i Access ODBC Driver 64-bit]
Description=IBM i Access for Linux 64-bit ODBC Driver
Driver=/opt/ibm/iaccess/lib64/libcwbodbc.so
Setup=/opt/ibm/iaccess/lib64/libcwbodbcs.so
Threading=0
DontDLClose=1
UsageCount=1

IBM i 검사를 구성하려면 IBM i ODBC 드라이버의 이름이 필요합니다.

IBM i 검사

  1. Agent의 구성 디렉터리 루트에 있는 conf.d/ 폴더에서 ibm_i.d/conf.yaml 파일을 편집하여 IBM i 성능 데이터 수집을 시작하세요. 사용 가능한 모든 구성 옵션은 샘플 ibm_i.d/conf.yaml을 참조하세요. obdcinst.ini 파일의 드라이버 이름을 사용하세요.

  2. Agent를 재시작합니다.

검증

Agent의 상태 하위 명령을 실행하고 Checks 섹션에서 ibm_i를 찾습니다.

수집한 데이터

메트릭

ibm_i.asp.io_requests_per_s
(gauge)		The average number of I/O requests for read and write operations that occurred per second
Shown as unit
ibm_i.asp.percent_busy
(gauge)		The percentage of time the disk unit is in use
Shown as percent
ibm_i.asp.percent_used
(gauge)		The percentage consumed from the disk unit
Shown as percent
ibm_i.asp.unit_space_available
(gauge)		The space on the unit available for use
Shown as byte
ibm_i.asp.unit_storage_capacity
(gauge)		The storage capacity of the unit
Shown as byte
ibm_i.job.active_duration
(gauge)		The amount of time a job has been active
Shown as second
ibm_i.job.cpu_usage
(gauge)		The CPU usage by a job
ibm_i.job.cpu_usage.pct
(gauge)		The CPU usage by a job as a percentage
Shown as percent
ibm_i.job.jobq_duration
(gauge)		The amount of time a job has been in the JOBQ status
Shown as second
ibm_i.job.status
(gauge)		Whether a job is currently active or not.
ibm_i.job.temp_storage
(gauge)		The amount of temporary storage that is currently allocated to a job
Shown as mebibyte
ibm_i.job_queue.held_size
(gauge)		The number of jobs in *HELD status in a job queue
Shown as unit
ibm_i.job_queue.released_size
(gauge)		The number of jobs in *RELEASED status in a job queue
Shown as unit
ibm_i.job_queue.scheduled_size
(gauge)		The number of jobs in *SCHEDULED status in a job queue
Shown as unit
ibm_i.job_queue.size
(gauge)		The number of jobs in a job queue
Shown as unit
ibm_i.message_queue.critical_size
(gauge)		The number of critical messages in a system message queue
Shown as unit
ibm_i.message_queue.size
(gauge)		The number of messages in a system message queue
Shown as unit
ibm_i.pool.defined_size
(gauge)		The size of a pool as defined in the shared pool, subsystem description, or system value QMCHPOOL
Shown as mebibyte
ibm_i.pool.reserved_size
(gauge)		The amount of storage in a pool reserved for system use
Shown as mebibyte
ibm_i.pool.size
(gauge)		The amount of main storage in a pool
Shown as mebibyte
ibm_i.subsystem.active
(gauge)		Whether a subsystem is currently active
ibm_i.subsystem.active_jobs
(gauge)		The number of jobs currently active in a subsystem
Shown as unit
ibm_i.system.configured_cpus
(gauge)		The total number of configured CPUs for the partition.
Shown as unit
ibm_i.system.cpu_usage
(gauge)		The average CPU utilization for all the active processors.
Shown as percent
ibm_i.system.current_cpu_capacity
(gauge)		The processor units that are being used in the partition.
ibm_i.system.normalized_cpu_usage
(gauge)		The normalized percentage of CPU utilization for processing units in use.
Shown as percent
ibm_i.system.shared_cpu_usage
(gauge)		The percentage of the total shared processor pool capacity used by all partitions using the pool.
Shown as percent

이벤트

IBM i 검사는 이벤트를 포함하지 않습니다.

트러블슈팅

도움이 필요하신가요? Datadog 고객 지원팀에 문의해주세요.