Instale & configure o OpenTelemetry CNCF para monitoramento de banco de dados Oracle

Pré-requisitos

• OpenTelemetry Collector Contrib (otelcol-contrib) instalado e configurado no seu sistema. É possível fazer o download da versão mais recente na página de releases do OpenTelemetry Collector.

Habilite as métricas da interface

É possível enriquecer a experiência na plataforma New Relic adicionando e ativando as várias métricas no arquivo de configuração otelcol-contrib. Usando a configuração fornecida nesta seção, é possível preencher dados para as seguintes páginas na plataforma New Relic:

• Overview

• Query performance

• Wait events

• Sessions

  Ativar métricas da página Overview

  A página Overview exibe uma visão de alto nível da sua instância do banco de dados Oracle, incluindo métricas principais, como utilização de CPU, tempo de espera, I/O, memória e uso de sessão.

  Para preencher os dados da página Overview na plataforma New Relic, adicione a seguinte configuração ao arquivo de configuração 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

  Copiar

  Ativar métricas de desempenho de consulta, sessão e espera

  Para preencher os dados das páginas Query performance, Wait events e Sessions, adicione a seguinte configuração ao seu arquivo de configuração 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

  Copiar

  Ativar métricas de grupo de discos e disco ASM

  O receiver do banco de dados Oracle oferece suporte ao monitoramento de instâncias do ASM (Automatic Storage Management). O receiver coleta métricas críticas de integridade do armazenamento, incluindo capacidade do grupo de discos, espaço livre utilizável, discos offline e erros de leitura/gravação de disco físico.

  Execute o seguinte como um usuário Oracle privilegiado para conceder acesso:

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

  Copiar

  Adicione a seguinte configuração ao seu arquivo de configuração otelcol-contrib. Todas as 5 métricas estão desativadas por padrão (opt-in):

  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

  Copiar

  Para uma descrição dessas métricas, consulte a referência de métricas.

Reinicie o OpenTelemetry Collector

Reinicie o OpenTelemetry Collector para aplicar as alterações de configuração:

$
sudo systemctl restart otelcol-contrib