Installez & configurez NRDOT pour le monitoring d’Oracle avec une CDB auto-hébergée

Installer le collecteur NRDOT

Sélectionnez la méthode de distribution de l'installation appropriée pour votre environnement Linux :

Configurer l'utilisateur de la base de données

Créez un utilisateur de monitoring avec les privilèges nécessaires pour votre base de données Oracle multitenant. Cela nécessite de créer un utilisateur commun avec le préfixe C##.

1. Pour définir votre contexte de conteneur actif actuel sur CDB$ROOT, exécutez l’instruction suivante en tant qu’utilisateur SYS :

   ALTER SESSION SET CONTAINER = CDB$ROOT;

   Copier

2. Pour les bases de données multi-locataires :

   1. Connectez-vous à la base de données racine en tant qu'administrateur.

   2. Pour créer un nouvel utilisateur, exécutez l'instruction CREATE USER suivante :

      CREATE USER c##<YOUR_DB_USERNAME> IDENTIFIED BY "<YOUR_DB_PASSWORD>" CONTAINER=ALL;
      GRANT CREATE SESSION TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;

      Copier

      Conseil

      L’utilisateur nouvellement créé sera un utilisateur commun avec le préfixe C##. Le préfixe C## est requis pour les utilisateurs communs par Oracle.

3. Pour permettre à l’utilisateur de monitoring de voir les lignes de chaque PDB dans les vues de données de conteneur, exécutez l’instruction suivante en tant que SYSDBA sur la racine CDB. Ceci est requis pour les métriques et événements par PDB.

   ALTER USER c##<YOUR_DB_USERNAME> SET CONTAINER_DATA=ALL CONTAINER=CURRENT;

   Copier

   Conseil

   Assurez-vous que votre USER_PASSWORD respecte les exigences d'Oracle en matière de mot de passe du nouvel utilisateur.

Accorder des privilèges de monitoring pour une base de données multitenant

Exécutez les GRANT instructions suivantes en tant que SYSDBA sur la racine CDB. Celles-ci couvrent la détection d’instance, la collecte de métriques, le monitoring par PDB, et la collecte d’événements. Vous pouvez les exécuter ensemble sous forme de script unique, ou exécuter chaque instruction individuellement.

GRANT SELECT ON V_$INSTANCE   TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON V_$DATABASE   TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON V_$CONTAINERS TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON V_$DATAFILE   TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON V_$SYSSTAT                    TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON V_$CON_SYSSTAT                TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON V_$SYSMETRIC                  TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON V_$CON_SYSMETRIC              TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON V_$SESSION                    TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON V_$RESOURCE_LIMIT             TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON V_$OSSTAT                     TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON V_$SGAINFO                    TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON V_$ROWCACHE                   TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON V_$PARAMETER                  TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON CDB_TABLESPACE_USAGE_METRICS  TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON CDB_TABLESPACES               TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON DBA_DATA_FILES                TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON DBA_FREE_SPACE                TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON DBA_RECYCLEBIN                TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON V_$SQL            TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON V_$SQL_PLAN_STATISTICS_ALL       TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON V_$LOCK           TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON V_$SESSION_EVENT  TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON DBA_PROCEDURES    TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON DBA_OBJECTS       TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON V_$PDBS           TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON CDB_SERVICES      TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON CDB_DATA_FILES    TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON CDB_PROCEDURES    TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON CDB_OBJECTS       TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON V_$ASM_DISKGROUP_STAT TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON V_$ASM_DISK_STAT      TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;

Configurer le collecteur NRDOT

Configurez le Collector NRDOT avec vos paramètres spécifiques à la CDB.

1. Créez le fichier de configuration. Le nom du fichier doit être oracle-config.yaml.

   bash

   Copier

   $
   sudo nano /etc/nrdot-collector/oracle-config.yaml

2. Ajoutez le contenu de configuration ci-dessous au fichier oracle-config.yaml que vous avez créé à l'étape précédente.

   configuration complète

   Cette configuration capture les métriques de base de référence essentielles. Pour voir le catalogue complet des métriques, consultez la référence de configuration.

   Nom d’hôte/IP CDB Oracle

   Saisissez le nom d’hôte ou l’adresse IP de votre base de données Oracle

   Port CDB Oracle

   Saisissez le numéro de port de votre base de données Oracle. La valeur par défaut est 1521.

   Nom d’utilisateur de base de données (sans le préfixe C##)

   Saisissez le nom d’utilisateur de votre base de données. Le préfixe d’utilisateur commun C## requis par Oracle est ajouté automatiquement.

   Mot de passe de la base de données

   Saisissez le mot de passe que vous avez défini pour l'utilisateur de monitoring

   Nom du service CDB

   Saisissez le nom de votre service CDB Oracle

   Point de terminaison OTLP New Relic

   Saisissez votre point de terminaison OTLP New Relic. Pour plus d’informations, consultez https://docs.newrelic.com/docs/opentelemetry/best-practices/opentelemetry-otlp/

   Clé de licence New Relic

   Entrez votre clé de licence New Relic

   oracle-config.yaml

   DownloadCopier

   1
   receivers:
   2
   nroracledb:
   3
     endpoint: oracle.example.com:1521
   4
     username: C##newrelic
   5
     password: YOUR_PASSWORD
   6
     service: YOUR_CDB_SERVICE_NAME
   7
     collection_interval: 15s
   8
   events:
   9
      db.server.query_sample:
   10
        enabled: true
   11
      db.server.top_query:
   12
        enabled: true
   13
      db.server.session.wait_sample:
   14
        enabled: true
   15
      db.server.top_procedure:
   16
        enabled: true
   17
      db.server.query_plan:
   18
        enabled: true
   19
   
   20
   top_query_collection:
   21
      max_query_sample_count: 1000
   22
      top_query_count: 200
   23
      collection_interval: 60s
   24
      allowed_comment_keys:
   25
        - nr_service_guid
   26
   
   27
   query_sample_collection:
   28
      max_rows_per_query: 100
   29
      allowed_comment_keys:
   30
        - nr_service_guid
   31
   
   32
   session_wait_event_collection:
   33
      max_rows_per_query: 100
   34
   
   35
   top_procedure_collection:
   36
      max_procedure_sample_count: 1000
   37
      top_procedure_count: 250
   38
      collection_interval: 60s
   39
   
   40
     # Metrics configuration - This baseline configuration captures essential metrics. To enable advanced monitoring and extended telemetry, refer to the full configuration documentation
   41
   metrics:
   42
      oracledb.buffer_cache.utilization:
   43
        enabled: true
   44
        attributes:
   45
          - oracle.db.pdb
   46
      oracledb.consistent_gets:
   47
        enabled: true
   48
        attributes:
   49
          - oracle.db.pdb
   50
      oracledb.cpu_time:
   51
        enabled: true
   52
        attributes:
   53
          - oracle.db.pdb
   54
      oracledb.database.cpu.utilization:
   55
        enabled: true
   56
        attributes:
   57
          - oracle.db.pdb
   58
      oracledb.database.wait.utilization:
   59
        enabled: true
   60
        attributes:
   61
          - oracle.db.pdb
   62
      oracledb.db_block_gets:
   63
        enabled: true
   64
        attributes:
   65
          - oracle.db.pdb
   66
      oracledb.enqueue_deadlocks:
   67
        enabled: true
   68
        attributes:
   69
          - oracle.db.pdb
   70
      oracledb.execution.utilization:
   71
        enabled: true
   72
        attributes:
   73
          - oracledb.parse.type
   74
          - oracle.db.pdb
   75
      oracledb.executions:
   76
        enabled: true
   77
        attributes:
   78
          - oracle.db.pdb
   79
      oracledb.hard_parses:
   80
        enabled: true
   81
        attributes:
   82
          - oracle.db.pdb
   83
      oracledb.host.cpu.utilization:
   84
        enabled: true
   85
        attributes:
   86
          - oracle.db.pdb
   87
      oracledb.library_cache.utilization:
   88
        enabled: true
   89
        attributes:
   90
          - oracle.db.pdb
   91
      oracledb.logical_reads:
   92
        enabled: true
   93
        attributes:
   94
          - oracle.db.pdb
   95
      oracledb.logons:
   96
        enabled: true
   97
        attributes:
   98
          - oracle.db.pdb
   99
      oracledb.parse.rate:
   100
        enabled: true
   101
        attributes:
   102
          - oracledb.parse.result
   103
          - oracle.db.pdb
   104
      oracledb.parse_calls:
   105
        enabled: true
   106
        attributes:
   107
          - oracle.db.pdb
   108
      oracledb.pga_memory:
   109
        enabled: true
   110
        attributes:
   111
          - oracle.db.pdb
   112
      oracledb.physical_io.requests:
   113
        enabled: true
   114
        attributes:
   115
          - disk.io.direction
   116
          - disk.io.block_size
   117
          - oracle.db.pdb
   118
      oracledb.physical_reads:
   119
        enabled: true
   120
        attributes:
   121
          - oracle.db.pdb
   122
      oracledb.physical_writes:
   123
        enabled: true
   124
        attributes:
   125
          - oracle.db.pdb
   126
      oracledb.processes.usage:
   127
        enabled: true
   128
      oracledb.sessions.usage:
   129
        enabled: true
   130
        attributes:
   131
          - session_type
   132
          - session_status
   133
          - oracle.db.pdb
   134
      oracledb.sga.usage:
   135
        enabled: true
   136
        attributes:
   137
          - oracledb.sga.component.name
   138
      oracledb.shared_pool.utilization:
   139
        enabled: true
   140
        attributes:
   141
          - oracle.db.pdb
   142
      oracledb.sql_service.response.duration:
   143
        enabled: true
   144
        attributes:
   145
          - oracle.db.pdb
   146
      oracledb.sqlnet.io.transferred:
   147
        enabled: true
   148
        attributes:
   149
          - network.io.direction
   150
          - destination.type
   151
          - oracle.db.pdb
   152
      oracledb.tablespace_size.usage:
   153
        enabled: true
   154
        attributes:
   155
          - tablespace_name
   156
          - oracle.db.pdb
   157
      oracledb.transactions.usage:
   158
        enabled: true
   159
      oracledb.user_commits:
   160
        enabled: true
   161
        attributes:
   162
          - oracle.db.pdb
   163
      oracledb.user_rollbacks:
   164
        enabled: true
   165
        attributes:
   166
          - oracle.db.pdb
   167
   
   168
     # Resource attributes attached to all metrics/logs (all enabled by default)
   169
   resource_attributes:
   170
      oracle.db.edition:
   171
        enabled: true
   172
   exporters:
   173
     otlp/newrelic:
   174
     endpoint: https://otlp.nr-data.net:4318
   175
   headers:
   176
      api-key: YOUR_LICENSE_KEY
   177
     compression: gzip
   178
   retry_on_failure:
   179
      enabled: true
   180
      initial_interval: 5s
   181
      max_interval: 30s
   182
      max_elapsed_time: 300s
   183
   sending_queue:
   184
      enabled: true
   185
      sizer: bytes
   186
      queue_size: 100_000_000
   187
      num_consumers: 10
   188
      batch:
   189
        sizer: bytes
   190
        max_size: 1_000_000
   191
        min_size: 0
   192
        flush_timeout: 5s
   193
   service:
   194
   pipelines:
   195
     metrics/oracledb:
   196
      receivers: [nroracledb]
   197
      exporters: [otlp/newrelic]
   198
     logs/oracledb:
   199
      receivers: [nroracledb]
   200
      exporters: [otlp/newrelic]

3. Dans la section Événements, activez ces types d’événements pour collecter leurs métriques :

   Événement	Description
   db.server.query_sample	Échantillons de requêtes actives par session capturant le SQL actuel, l’état d’attente et les détails de blocage.
   db.server.top_query	Top N des instructions SQL par CPU ou temps écoulé, y compris les statistiques d’exécution et les plans de requête.
   db.server.session.wait_sample	Nombres et durées d’attente cumulés par session à partir de v$session_event .
   db.server.top_procedure	Top N des procédures stockées classées par utilisation des ressources, y compris les statistiques d'exécution.
   db.server.query_plan	Détails du plan d'exécution pour les requêtes principales et échantillonnées.

4. Configurez les paramètres de collecte pour chaque type d’événement :

   Section de configuration	paramètres	Valeur
   top_query_collection	max_query_sample_count	1000
   top_query_collection	top_query_count	200
   top_query_collection	collection_interval	60s
   query_sample_collection	max_rows_per_query	100
   session_wait_event_collection	max_rows_per_query	100
   top_procedure_collection	max_procedure_sample_count	1000
   top_procedure_collection	top_procedure_count	250
   top_procedure_collection	collection_interval	60s

   Conseil

   Pour plus de détails sur la configuration du point de terminaison OTLP New Relic et les bonnes pratiques OpenTelemetry, consultez la documentation OpenTelemetry OTLP.

Mettre à jour la configuration du Collector NRDOT

Mettez à jour la configuration du Collector NRDOT pour utiliser votre fichier oracle-config.yaml :

$
sudo sed -i 's|OTELCOL_OPTIONS="--config=/etc/nrdot-collector/config.yaml"|OTELCOL_OPTIONS="--config=/etc/nrdot-collector/oracle-config.yaml"|' /etc/nrdot-collector/nrdot-collector.conf

Redémarrer NRDOT Collector

Après avoir mis à jour votre configuration, redémarrez le Collector NRDOT :

$
sudo systemctl restart nrdot-collector.service
$
sudo systemctl status nrdot-collector.service

Trouvez et utilisez vos données

Une fois vos données collectées, vous pouvez accéder à un monitoring complet de la base de données Oracle via l'UI de New Relic.

Pour trouver votre entité de base de données Oracle dans New Relic :

1. Allez à https://one.newrelic.com > All Capabilities > Databases.
2. Définissez les critères de recherche comme instrumentation.provider = opentelemetry.
3. Sélectionnez votre base de données Oracle dans la liste des entités.