Installez & configurez OpenTelemetry CNCF pour le monitoring de la base de données Oracle

Prérequis

• OpenTelemetry Collector Contrib (otelcol-contrib) installé & 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 les différentes métriques dans votre fichier de configuration otelcol-contrib. En utilisant la configuration fournie dans cette section, vous pouvez alimenter les données des pages suivantes de 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

  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
  
      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

  Copier

  Activer les métriques de groupe de disques et de disque ASM

  Le Récepteur de base de données Oracle prend en charge le monitoring des instances ASM (Automatic Storage Management). Le Récepteur collecte des métriques critiques de santé du stockage, y compris la capacité du groupe de disques, l’espace libre utilisable, les disques hors ligne, et les erreurs de lecture/écriture des disques physiques.

  Exécutez ce qui suit en tant qu'utilisateur Oracle privilégié pour accorder l'accès :

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

  Copier

  Ajoutez la configuration suivante à votre fichier de configuration otelcol-contrib. Les 5 métriques sont désactivées par défaut (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

  Copier

  Pour une description de ces métriques, consultez la référence des métriques.

Redémarrez le Collector OpenTelemetry

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

$
sudo systemctl restart otelcol-contrib