IBM Db2 모니터링

이 센서는 IBM Db2 10.5 및 이후 버전을 지원합니다.

다음 표는 최신 지원 버전 및 지원 정책을 보여줍니다:

지원 정책에 대한 자세한 내용은 ‘센서 지원 전략’을 참조하십시오.

이 센서는 인증 보안 DATA_ENCRYPT 메커니즘을 사용하는 Db2 인스턴스의 모니터링을 지원하지 않습니다.

이 기술과 관련하여, Instana 은 다음 언어 및 런타임에 대한 클라이언트 측 추적을 지원합니다:

• Java
• Node.js
• PHP
• .NET Framework
• .NET Core

사용자 정의 포트, 데이터베이스, 사용자, 비밀번호, 인스턴스 또는 폴링 비율을 사용하려면 에이전트 구성 파일 <agent_install_dir>/etc/instana/configuration.yaml에서 다음 필드를 구성해야 합니다.

Instana 에이전트가 Db2 서버에 안전하게 연결되려면 다음 위치에서 구성을 <agent_install_dir>/etc/instana/configuration.yaml설정해야 합니다:

Instana Red Hat OpenShift Container Platform 에서 IBM Db2 에 대한 로컬 모니터링을 지원합니다. 컨테이너 환경 내의 IBM Db2 데이터베이스 인스턴스는 StatefulSets 로 생성됩니다. 사용자 정의 자원 (CR) 을 사용하여 동일한 팟 (Pod) 템플리트에서 렌더링됩니다. 다음 예제에는 ` IBM Db2 `의 구성 예시가 나와 있습니다:

com.instana.plugin.db2:
  local:
    - host: 'c-db2ucluster-sample-one-db2u.openshift-operators.svc'
      instance: 'db2inst1'
      port: '50000'
      environment: 'OCP'
      tabschema: 'SYSTOOLS'
      user: 'db2inst1'
      password: 'db2inst1'
      availabilityZone: 'DB2 Monitoring'
      poll_rate: 5 # seconds
      databases:
        - 'BLUDB'
    - host: 'c-db2ucluster-sample-two-db2u.openshift-operators.svc'
      instance: 'db2inst1'
      port: '50000'
      environment: 'OCP'
      tabschema: 'SYSTOOLS'
      user: 'db2inst1'
      password: 'db2inst1'
      availabilityZone: 'DB2 Monitoring'
      poll_rate: 5 # seconds
      databases: # multiple databases are supported
        - 'database1'
        - 'database2'
 

동일한 워커 노드에 여러 개의 ` IBM Db2 ` 인스턴스가 존재하는 경우, 이를 동일한 구성 파일에 추가할 수 있습니다.

IBM Db2 서비스의 호스트 URL 는 서비스 이름과 데이터베이스 인스턴스가 생성된 OpenShift Container Platform 클러스터의 네임스페이스가 결합된 형태입니다. URL 는 일반적으로 다음과 같은 형식을 갖습니다 *serviceName*.*namespace*.svc. 예를 들어, 가 c-db2ucluster-sample-one 서비스 이름이고 openshift-operators 가 네임스페이스라면, 호스트 URL 의 네임스페이스는 입니다 c-db2ucluster-sample-one-db2u.openshift-operators.svc.

포드를 다시 생성할 경우, Instana 의 데이터베이스 기록을 유지하려면 동일한 서비스 이름을 사용하십시오.

로그인 제한시간은 센서가 데이터베이스에 연결하기 위해 대기하는 최대 시간 (초) 을 정의합니다. Instana 의 Db2 센서에서 `.conf` configuration.yaml 파일의 ` loginTimeout property`를 사용하여 로그인 시간 제한을 설정할 수 있습니다. 지정된 loginTimeout 간격 내에 연결이 확보되지 않으면 연결 오류가 표시됩니다. 이 특성의 기본값은 5초입니다. 이 특성은 선택사항이며 로컬 및 원격 구성 모두에 적용 가능합니다. 다음 예제는loginTimeout 특성을 사용자 정의하는 방법을 보여줍니다.

      port: '50000'
      tabschema: 'SYSTOOLS'
      user: 'db2inst1'
      password: 'db2inst1'
      poll_rate: 5 # seconds
      loginTimeout: 20 #value in seconds
 

Instana 의 Db2 센서에서 잠금 대기 및 장시간 실행되는 쿼리의 개수를 확인하기 위해, 파일의 configuration.yaml 속성을 lockAndLongQueryInterval 사용하여 시간 간격을 사용자 지정할 수 있습니다. 기본적으로 센서가 조회 또는 잠금 대기를 장기 실행으로 분류하는 데 걸리는 시간은 100초입니다. 이 메트릭은 경보 또는 이벤트 구성에 사용할 수 있습니다. lockAndLongQueryInterval 특성은 선택사항이며 로컬 및 원격 구성 모두에 적용 가능합니다. 다음 예제는 이 특성을 사용자 정의하는 방법을 보여줍니다.

      port: '50000'
      tabschema: 'SYSTOOLS'
      user: 'db2inst1'
      password: 'db2inst1'
      poll_rate: 5 # seconds
      lockAndLongQueryInterval: 60 # value in seconds
 

이제 runstats및 reorg 메트릭을 수집하기 위한 시간 간격을 사용자 정의할 수 있습니다. 시간 간격을 사용자 정의하려면 configuration.yaml 파일에서 customRunStatsPollRate 특성을 사용하십시오. 기본적으로 지표는 180분마다 수집됩니다. customRunStatsPollRate 특성은 선택사항이며 로컬 및 원격 구성 모두에 적용 가능합니다. 다음 예제는 이 특성을 사용자 정의하는 방법을 보여줍니다.

      port: '50000'
      tabschema: 'SYSTOOLS'
      user: 'db2inst1'
      password: 'db2inst1'
      poll_rate: 5 # seconds
      customRunStatsPollRate: 30 # value in minutes
 

이제 스키마당 테이블 크기에 대해 표시되는 행 수를 사용자 정의할 수 있습니다. 행 수를 사용자 정의하려면 configuration.yaml 파일에서 tableSizeRowsLimit 특성을 사용하십시오. 기본적으로 스키마당 크기별로 처음 50개의 테이블만 표시됩니다. tableSizeRowsLimit 특성은 선택사항이며 로컬 및 원격 구성 모두에 적용 가능합니다. 다음 예제는 이 특성을 사용자 정의하는 방법을 보여줍니다.

      port: '50000'
      tabschema: 'SYSTOOLS'
      user: 'db2inst1'
      password: 'db2inst1'
      poll_rate: 5 # seconds
      tableSizeRowsLimit: 100 # number of rows to fetch
 

JSON 웹 토큰(JWT)은 Db2 에서 지원하는 인증 메커니즘으로, 1.0.27 버전부터 Db2 센서에서도 지원됩니다. Instana 에이전트가 Db2 서버와의 JWT 연결을 지원하도록 하려면 다음 내용대로 파일을 <agent_install_dir>/etc/instana/configuration.yaml 구성해야 합니다:

로컬 및 원격 모니터링 모두에 대해 다중 인스턴스 모니터링이 지원됩니다. 다음은 configuration.yaml 파일 내에서 구성할 수 있는 방법의 예제입니다.

로컬 및 원격으로 Db2 pureScale 인스턴스를 모니터할 수 있습니다. 다음 예는 configuration.yaml 파일에서 Db2 pureScale 인스턴스에 대한 로컬 및 원격 모니터링을 구성하는 방법을 보여줍니다.

Instana 가 사용하는 ‘ Db2 ’ 사용자 계정에 다음 권한을 부여해야 합니다:

GRANT DBADM ON DATABASE TO USER db2inst1;

또는

GRANT DATAACCESS ON DATABASE TO USER db2inst1;
GRANT SQLADM ON DATABASE TO USER db2inst1;
 

또는 다음 테이블 함수/뷰 또는 프로시저에 대한 EXECUTE 특권:

GRANT EXECUTE ON FUNCTION SYSPROC.MON_GET_CONTAINER TO USER db2inst1;
GRANT EXECUTE ON FUNCTION SYSPROC.MON_GET_TRANSACTION_LOG TO USER db2inst1;
GRANT EXECUTE ON FUNCTION SYSPROC.MON_GET_DATABASE TO USER db2inst1;
GRANT EXECUTE ON FUNCTION SYSPROC.MON_GET_TABLESPACE TO USER db2inst1;
GRANT EXECUTE ON FUNCTION SYSPROC.MON_GET_PKG_CACHE_STMT TO USER db2inst1;
GRANT EXECUTE ON FUNCTION SYSPROC.MON_GET_AGENT TO USER db2inst1;
GRANT EXECUTE ON FUNCTION SYSPROC.MON_GET_HADR TO USER db2inst1;
GRANT EXECUTE ON FUNCTION SYSPROC.MON_GET_CONNECTION TO USER db2inst1;
GRANT EXECUTE ON FUNCTION SYSPROC.MON_GET_UTILITY TO USER db2inst1;
GRANT EXECUTE ON FUNCTION SYSPROC.MON_GET_WORKLOAD TO USER db2inst1;
GRANT EXECUTE ON FUNCTION SYSPROC.MON_GET_UNIT_OF_WORK TO USER db2inst1;
GRANT EXECUTE ON FUNCTION SYSPROC.MON_GET_INSTANCE TO USER db2inst1;
GRANT EXECUTE ON FUNCTION SYSPROC.PD_GET_DIAG_HIST TO USER db2inst1;
GRANT EXECUTE ON FUNCTION SYSPROC.PD_GET_LOG_MSGS TO USER db2inst1;
GRANT SELECT ON SYSIBMADM.MON_TRANSACTION_LOG_UTILIZATION TO USER db2inst1;
GRANT SELECT ON TABLE SYSCAT.INDEXES TO USER db2inst1;
GRANT SELECT ON TABLE SYSCAT.TABLES TO USER db2inst1;
GRANT SELECT ON TABLE SYSIBMADM.MON_CURRENT_SQL TO USER db2inst1;
GRANT SELECT ON TABLE SYSIBMADM.DB_HISTORY TO USER db2inst1;
GRANT SELECT ON TABLE SYSIBMADM.DBCFG TO USER db2inst1;
GRANT SELECT ON TABLE SYSIBMADM.MON_CONNECTION_SUMMARY TO USER db2inst1;
GRANT SELECT ON TABLE SYSIBMADM.MON_DB_SUMMARY TO USER db2inst1;
GRANT SELECT ON TABLE SYSIBMADM.MON_LOCKWAITS TO USER db2inst1;
GRANT SELECT ON TABLE SYSIBMADM.SNAP_REORG TO USER db2inst1;
GRANT EXECUTE ON FUNCTION SYSPROC.DB_GET_CFG() TO USER db2inst1;
GRANT EXECUTE ON FUNCTION SYSPROC.DBM_GET_CFG TO USER db2inst1;
GRANT EXECUTE ON FUNCTION SYSPROC.ENV_GET_INST_INFO TO USER db2inst1;

SYSIBMADM.SNAP_REORG

GRANT SELECT ON TABLE SYSIBMADM.SNAPTAB_REORG TO USER db2inst1;

예:

db2 connect to db
 

db2 "grant dataaccess, sqladm on database to user db2inst1"
 

db2 "grant execute on FUNCTION SYSPROC.MON_GET_DATABASE to USER db2inst1"
 

참고:

• IBM Db2 LUW 센서에 대한 폴링 구성이 활성화되었습니다. 이 기능을 사용하여 필요한 간격으로 통계를 페치하기 위한 사용자 정의 구성을 설정하고 관련 없는 통계를 사용 안함으로 설정할 수도 있습니다.
• 사용자 정의 폴링 구성을 사용하는 경우 이 설정은 기본 시스템 설정보다 우선합니다.
• 폴링 사용자 정의는 구성 가능한 통계 섹션의 표에 설명된 통계에 대해서만 사용 가능합니다. 폴링 사용자 정의가 사용으로 설정되지 않은 통계는 덜 자주 수집되며 시스템에 중요합니다. 수집된 통계 및 기본 폴링 간격에 대한 자세한 정보는 구성 가능한 통계 절을 참조하십시오.
• 간격 구성을 기본값 미만으로 설정할 수 없습니다. 올바르지 않은 구성을 작성하는 경우 이 항목은 사용 가능한 다음으로 높은 폴링 비율의 구성 버킷으로 이동됩니다.
• 구성 가능한 항목에서 통계를 생략하면 (통계가 poll_intervals 또는 disabled_metrics 버킷에 추가되지 않음) 사용 가능한 다음 상위 버킷에 자동으로 추가됩니다. 그러나 이러한 버킷이 없는 경우에는 사용 안함으로 설정된 메트릭 목록으로 이동됩니다.
• 로컬 및 원격 모니터링 모두에 대해 폴링 간격을 사용자 정의할 수 있습니다. 모든 폴링 간격을 초 단위로 설정하십시오.
• 통계 이름 및 버킷 이름 (disabled_metrics, poll_rate_1, poll_rate_2, poll_rate_3및 poll_rate_4) 은 고정되어 있습니다. 구성 통계 섹션의 테이블에 표시된 대로 또는 다음 샘플 구성에서와 같이 이름을 지정해야 합니다.

로컬 및 원격 모니터링 모두에 대한 폴링을 사용자 정의하려면 다음과 같이 구성하십시오.

      poll_rate: 5 # seconds
      custom_polling:
        disabled_metrics:
          metrics: DBM_CONFIG_STATS, AGENT_STATS #Stats that you don't want to be monitored
        poll_rate_1:
          poll_interval: 30
          metrics: TOP_QUERIES_STATS, TABLE_SPACE_STATS
        poll_rate_2:
          poll_interval: 200
          metrics: ELAPSED_TIME_STATS, WORKLOAD_STATS, TOP_TOTAL_STMT_IDS_STATS
        poll_rate_3:
          poll_interval: 900
          metrics: LOG_DISK_WAIT_STATS, DB_CONFIG_STATS, UNIT_OF_WORK_STATS
        poll_rate_4:
          poll_interval: 2000
          metrics: HADR_STATS, VMON_LOCK_STATS
      databases:
        - 'database1'
 

DB2 테이블 함수를 사용하면 표준 메트릭 외에도 사용자 정의 메트릭을 수집할 수 있습니다. 수집할 테이블 함수와 메트릭을 지정하면, 센서가 구성에 따라 적절한 SQL 쿼리를 자동으로 생성하고 모든 메트릭을 Prometheus 형식으로 내보냅니다.

에이전트 구성 파일에서 <agent_install_dir>/etc/instana/configuration.yaml 다음과 같이 IBM Db2 의 로컬 및 원격 모니터링을 위한 사용자 정의 메트릭 구성을 설정할 수 있습니다:

• 프로세스 ID
• 포트
• 버전
• 시작 시간/작동 시간