오라클 데이터베이스 모니터링을 위한 OpenTelemetry CNCF 설치 및 구성

전제 조건

• 시스템에 OpenTelemetry Collector Contrib(otelcol-contrib)이(가) 설치 및 설정되었습니다. OpenTelemetry Collector 릴리스 페이지에서 최신 릴리스를 다운로드할 수 있습니다.

UI 메트릭 활성화

otelcol-contrib 설정 파일에 다양한 메트릭을 추가하고 활성화하여 뉴렐릭 플랫폼 환경을 개선할 수 있습니다. 이 섹션에 제공된 설정을 사용하면 뉴렐릭 플랫폼의 다음 페이지에 데이터를 채울 수 있습니다:

• Overview

• Query performance

• Wait events

• Sessions

  개요 페이지 메트릭 활성화

  Overview 페이지는 CPU 사용률, 대기 시간, I/O, 메모리 및 세션 사용량과 같은 주요 메트릭을 포함하여 오라클 데이터베이스 인스턴스의 상위 수준 뷰를 표시합니다.

  뉴렐릭 플랫폼의 Overview 페이지에 데이터를 채우려면 otelcol-contrib 설정 파일에 다음 설정을 추가하십시오:

  receivers:
    oracledb:
      # Metrics required by the "Oracle Database Monitoring (OTel)" dashboard
      metrics:
        oracledb.buffer_cache.utilization:
          enabled: true
        oracledb.consistent_gets:
          enabled: true
        oracledb.cpu_time:
          enabled: true
        oracledb.database.cpu.utilization:
          enabled: true
        oracledb.database.wait.utilization:
          enabled: true
        oracledb.db_block_gets:
          enabled: true
        oracledb.enqueue_deadlocks:
          enabled: true
        oracledb.execution.utilization:
          enabled: true
        oracledb.executions:
          enabled: true
        oracledb.hard_parses:
          enabled: true
        oracledb.host.cpu.utilization:
          enabled: true
        oracledb.library_cache.utilization:
          enabled: true
        oracledb.logical_reads:
          enabled: true
        oracledb.logons:
          enabled: true
        oracledb.parse.rate:
          enabled: true
        oracledb.parse_calls:
          enabled: true
        oracledb.pga_memory:
          enabled: true
        oracledb.physical_io.requests:
          enabled: true
        oracledb.physical_reads:
          enabled: true
        oracledb.physical_writes:
          enabled: true
        oracledb.processes.usage:
          enabled: true
        oracledb.sessions.usage:
          enabled: true
        oracledb.sga.usage:
          enabled: true
        oracledb.shared_pool.utilization:
          enabled: true
        oracledb.sql_service.response.duration:
          enabled: true
        oracledb.sqlnet.io.transferred:
          enabled: true
        oracledb.tablespace_size.usage:
          enabled: true
        oracledb.transactions.usage:
          enabled: true
        oracledb.user_commits:
          enabled: true
        oracledb.user_rollbacks:
          enabled: true

  카피

  쿼리 성능, 세션 및 대기 메트릭 활성화

  Query performance, Wait events 및 Sessions 페이지에 데이터를 채우려면 otelcol-contrib 설정 파일에 다음 설정을 추가하십시오:

  receivers:
    oracledb:
      events:
        db.server.query_sample:
          enabled: true
        db.server.top_query:
          enabled: true
        db.server.session.wait_sample:
          enabled: true
  
      top_query_collection:
        max_query_sample_count: 1000
        top_query_count: 200
        collection_interval: 60s
        allowed_comment_keys:
          - nr_service_guid
  
      query_sample_collection:
        max_rows_per_query: 100
        allowed_comment_keys:
          - nr_service_guid
  
      session_wait_event_collection:
        max_rows_per_query: 100

  카피

  ASM 디스크 그룹 및 디스크 메트릭을 활성화하십시오.

  오라클 데이터베이스 리시버는 ASM(Automatic Storage Management) 인스턴스 모니터링을 지원합니다. 리시버는 디스크 그룹 용량, 사용 가능한 여유 공간, 오프라인 디스크 및 물리적 디스크 읽기/쓰기 오류를 포함한 중요한 스토리지 상태 메트릭을 수집합니다.

  액세스 권한을 부여하려면 권한이 있는 오라클 사용자로 다음을 실행하십시오:

  GRANT SELECT ON V_$ASM_DISKGROUP_STAT TO <username>;
  GRANT SELECT ON V_$ASM_DISK_STAT TO <username>;

  카피

  다음 설정을 otelcol-contrib 설정 파일에 추가하십시오. 5개의 메트릭은 모두 기본적으로 비활성화 되어 있습니다(옵트인):

  receivers:
    oracledb:
      datasource: "oracle://otel:password@localhost:51521/XE"
      metrics:
        oracledb.asm.disk_group.free:
          enabled: true
        oracledb.asm.disk_group.capacity:
          enabled: true
        oracledb.asm.disk_group.usable_free:
          enabled: true
        oracledb.asm.disk_group.offline_disks:
          enabled: true
        oracledb.asm.disk.errors:
          enabled: true

  카피

  이러한 메트릭에 대한 설명은 메트릭 참조를 참고하십시오.

OpenTelemetry Collector 다시 시작

설정 변경 사항을 적용하려면 OpenTelemetry Collector를 다시 시작합니다:

$
sudo systemctl restart otelcol-contrib