Configurer le monitoring de la base de données Oracle avec OpenTelemetry Collector Contrib (CNCF)

Prérequis

• OpenTelemetry Collector Contrib (otelcol-contrib) installé et configuré sur votre système. Vous pouvez télécharger la dernière sortie depuis la page des sorties de l’OpenTelemetry Collector.

Activer les métriques UI

Vous pouvez enrichir votre expérience de la plateforme New Relic en ajoutant, et en activant des métriques dans votre fichier de configuration otelcol-contrib. En utilisant la configuration fournie dans cette section, vous pouvez alimenter les données pour les pages suivantes dans la plateforme New Relic :

• Overview

• Query performance

• Wait events

• Sessions

  Activer les métriques de la page Overview

  La page Overview affiche une vue d’ensemble de votre instance de base de données Oracle, y compris des métriques clés telles que l’utilisation du CPU, le temps d’attente, les I/O, la mémoire, et l’utilisation des sessions.

  Pour renseigner les données de la page Overview dans la plateforme New Relic, ajoutez la configuration suivante à votre fichier de configuration 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
      resource_attributes:
        oracle.db.edition:
          enabled: true

  Copier

  Activez les métriques de performance des requêtes, de session, et d'attente

  Pour alimenter les données des pages Query performance, Wait events, et Sessions, ajoutez la configuration suivante à votre fichier de configuration otelcol-contrib :

  receivers:
    oracledb:
      events:
        db.server.query_sample:
          enabled: true
        db.server.top_query:
          enabled: true
        db.server.session.wait_sample:
          enabled: true
        db.server.top_procedure:
          enabled: true
        db.server.query_plan:
          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
  
      top_procedure_collection:
        max_procedure_sample_count: 1000
        top_procedure_count: 250
        collection_interval: 60s

  Copier

Redémarrez le Collector OpenTelemetry

Redémarrez l'OpenTelemetry Collector pour appliquer les modifications de configuration :

$
sudo systemctl restart otelcol-contrib