개요

이 검사는 Datadog Agent를 통해 IBM Db2를 모니터링합니다.

설정

설치

IBM Db2 검사는 Datadog Agent 패키지에 포함되어 있습니다.

종속성

ibm_db 클라이언트 라이브러리가 필요합니다. 설치하려면 작동하는 컴파일러가 있는지 확인하고 다음을 실행하세요.

Unix

sudo -Hu dd-agent /opt/datadog-agent/embedded/bin/pip install ibm_db==3.2.3

참고: Python 2를 실행하는 Agent의 경우 ibm_db=3.1.0 대신 ibm_db==3.0.1을 사용하세요.

Windows

에이전트 버전 6.11 미만인 경우:

"C:\Program Files\Datadog\Datadog Agent\embedded\python.exe" -m pip install ibm_db==3.0.1

Agent 버전 6.12 이상 및 7.0 미만인 경우:

"C:\Program Files\Datadog\Datadog Agent\embedded<PYTHON_MAJOR_VERSION>\python.exe" -m pip install ibm_db==3.0.1

Agent 버전 7.0 이상 7.58 미만의 경우,

"C:\Program Files\Datadog\Datadog Agent\embedded3\python.exe" -m pip install ibm_db==3.1.4

Agent 버전 7.58 이상인 경우,

"C:\Program Files\Datadog\Datadog Agent\embedded3\python.exe" -m pip install ibm_db==3.2.3

Linux에서는 XML 기능이 필요할 수 있습니다. 빌드 과정 중에 오류가 발생하는 경우 libxslt-dev(또는 RPM의 경우 libxslt-devel)를 설치하세요.

모니터링 활성화

IBM Db2 통합은 다음 테이블 함수를 사용하여 데이터를 가져옵니다.

• MON_GET_TABLESPACE
• MON_GET_TRANSACTION_LOG
• MON_GET_BUFFERPOOL
• MON_GET_DATABASE
• MON_GET_INSTANCE

이러한 테이블 함수에 대한 자세한 내용은 공식 IBM 문서를 참조하세요.

Db2 인스턴스를 모니터링하려면 위의 5개 테이블 함수에 대한 EXECUTE 권한이 있는 Db2 사용자를 생성하거나 Db2 사용자에게 다음 역할 중 하나를 부여합니다.

• DATAACCESS 권한
• DBADM 권한
• SQLADM 권한

인스턴스, 연결된 데이터베이스 및 데이터베이스 개체의 상태를 모니터링하려면, 모니터링하려는 각 개체에 데이터베이스 시스템 모니터 스위치를 활성화합니다.

• Statement
• Lock
• 테이블
• Buffer pool

인스턴스 마스터 사용자로 전환하고 db2 프롬프트에서 다음 명령을 실행합니다.

update dbm cfg using HEALTH_MON on
update dbm cfg using DFT_MON_STMT on
update dbm cfg using DFT_MON_LOCK on
update dbm cfg using DFT_MON_TABLE on
update dbm cfg using DFT_MON_BUFPOOL on

다음으로 get dbm cfg를 실행하면 다음이 표시됩니다.

 Default database monitor switches
   Buffer pool                         (DFT_MON_BUFPOOL) = ON
   Lock                                   (DFT_MON_LOCK) = ON
   Sort                                   (DFT_MON_SORT) = OFF
   Statement                              (DFT_MON_STMT) = ON
   Table                                 (DFT_MON_TABLE) = ON
   Timestamp                         (DFT_MON_TIMESTAMP) = ON
   Unit of work                            (DFT_MON_UOW) = OFF
 Monitor health of instance and databases   (HEALTH_MON) = ON

구성

검증

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

수집한 데이터

메트릭

이벤트

• 테이블스페이스 상태가 변경될 때마다 ibm_db2.tablespace_state_change가 트리거됩니다.

서비스 점검

트러블슈팅

CLI Driver SQL1531N 오류

다음과 같은 오류 로그를 생성하는 문제가 발생하는 경우:

2023-08-10 23:34:47 UTC | CORE | ERROR | (pkg/collector/python/datadog_agent.go:129 in LogMessage) | ibm_db2:c051131490335a94 | (ibm_db2.py:563) | Unable to connect to database `datadog` as user `db2inst1`: [IBM][CLI Driver] SQL1531N  The connection failed because the name specified with the DSN connection string keyword could not be found in either the db2dsdriver.cfg configuration file or the db2cli.ini configuration file.  Data source name specified in the connection string: "DATADOG". SQLCODE=-1531

다음 시나리오 중 하나로 인해 발생할 가능성이 높습니다.

• 구성(conf.yaml)에 호스트 및 포트 구성이 누락되었습니다.
• CLI 드라이버는 db2cli.ini 및 db2dsdriver.cfg가 없기 때문에 데이터베이스를 찾을 수 없습니다.

Agent는 데이터베이스에 적절하게 연결할 위치를 결정하기 위해 위의 두 시나리오 모두에 대한 정보가 필요합니다. 이 문제를 해결하려면 이 문제가 발생한 모든 ibm_db2 검사 인스턴스에 대해 호스트 또는 포트 파라미터를 포함할 수 있습니다. 다른 방법으로는 db2cli.ini 또는 db2dsdriver.cfg 파일에 정의된 DSN을 사용하려는 경우 Agent가 사용하는 clidriver 디렉터리에 해당 파일을 복사할 수 있습니다. 일반적인 상황에서 해당 디렉터리는 Linux의 경우에 /opt/datadog-agent/embedded/lib/python3.9/site-packages/clidriver/cfg에 있습니다.

ibm_db 클라이언트 라이브러리를 오프라인으로 설치

Air-Gapped 환경에 있거나 pip install ibm_db==x.y.z(버전 번호: x.y.z) 실행이 불가능한 제한된 네트워크에 있는 경우 다음 방법을 사용하여 ibm_db를 설치할 수 있습니다.

1. 네트워크 액세스가 가능한 머신에서 ibm_db 라이브러리 및 ODBC 및 CLI에 대한 소스 tarball을 다운로드합니다. ODBC와 CLI는 ibm_db 라이브러리에서 필요하기 때문에 별도로 다운로드해야 하지만 pip를 통해서는 다운로드할 수 없습니다. 다음 스크립트는 Linux 시스템에 ibm_db==x.y.z(버전 번호: x.y.z)에 대한 아카이브 파일을 설치합니다.

   curl -Lo ibm_db.tar.gz https://github.com/ibmdb/python-ibmdb/archive/refs/tags/vx.y.z.tar.gz
   
   curl -Lo linuxx64_odbc_cli.tar.gz https://public.dhe.ibm.com/ibmdl/export/pub/software/data/db2/drivers/odbc_cli/linuxx64_odbc_cli.tar.gz
   

2. 두 파일을 제한된 호스트로 전송한 다음 아카이브를 추출합니다.

   tar -xvf ibm_db.tar.gz
   
   tar -xvf linuxx64_odbc_cli.tar.gz
   

3. linuxx64_odbc_cli.tar.gz에서 /clidriver가 추출된 위치로 IBM_DB_HOME 환경 변수를 설정합니다. 이렇게 하면 설치가 실패하므로 ibm_db 라이브러리가 새 버전의 ODBC 및 CLI를 설치하는 것을 방지할 수 있습니다.

   export IBM_DB_HOME=/path/to/clidriver
   

4. Agent에 내장된 pip를 사용하여 ibm_db 라이브러리를 로컬로 설치합니다. 이 라이브러리의 파일은 ibm_db.tar.gz에서 추출된 python-ibmdb-x.y.z 내에 포함되어 있습니다.

   /opt/datadog-agent/embedded/bin/pip install --no-index --no-deps --no-build-isolation  /path/to/python-ibmdb-x.y.z/IBM_DB/ibm_db/
   

다음 오류가 나타나는 경우:

  error: subprocess-exited-with-error

  × Preparing metadata (pyproject.toml) did not run successfully.
  | exit code: 1
   -> [8 lines of output]
      Detected 64-bit Python
      Detected platform = linux, uname = x86_64
      Downloading https://public.dhe.ibm.com/ibmdl/export/pub/software/data/db2/drivers/odbc_cli/linuxx64_odbc_cli.tar.gz
       Downloading DSDriver from url =  https://public.dhe.ibm.com/ibmdl/export/pub/software/data/db2/drivers/odbc_cli/linuxx64_odbc_cli.tar.gz
      Pre-requisite check [which gcc] : Failed

      No Gcc installation detected.
      Please install gcc and continue with the installation of the ibm_db.
      [end of output]

gcc 설치가 필요할 수 있습니다.

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

참고 자료

기타 유용한 문서, 링크 및 기사:

• Datadog으로 IBM DB2 모니터링