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

Obtenez des informations détaillées complètes sur les performances de votre base de données conteneur (CDB) Oracle avec le monitoring de base de données, l’analyse des requêtes, et les métriques de santé du système à l’aide du collecteur New Relic Distribution of OpenTelemetry (NRDOT). Toutes les bases de données enfichables (PDB) sous la CDB configurée sont monitorées.

Installation guidée

Pour installer plutôt via l’UI de New Relic, accédez à one.newrelic.com > Integrations & Agents > Oracle (Database 360). Cette page traite uniquement de l’installation manuelle.

Prérequis

Avant de commencer, assurez-vous d’avoir les éléments suivants :

Une clé de licenceNew Relic valide
Architecture prise en charge : Linux avec AMD64 et ARM64
Connectivité réseau vers le point de terminaison OTLP de New Relic
Oracle Database 19c ou version ultérieure

Installer le collecteur NRDOT

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

Pour les systèmes Debian/Ubuntu, exécutez :
bash
```
$NRDOT_VERSION=$(curl -s https://api.github.com/repos/newrelic/nrdot-collector-releases/releases/latest | grep '"tag_name":' | awk -F'"' '{print $4}') && curl -L "https://github.com/newrelic/nrdot-collector-releases/releases/download/${NRDOT_VERSION}/nrdot-collector_${NRDOT_VERSION}_linux_amd64.deb" --output nrdot-collector.deb && sudo dpkg -i nrdot-collector.deb
```

Pour les systèmes RHEL/CentOS/OEL, exécutez :

bash

$NRDOT_VERSION=$(curl -s https://api.github.com/repos/newrelic/nrdot-collector-releases/releases/latest | grep '"tag_name":' | awk -F'"' '{print $4}') && curl -L "https://github.com/newrelic/nrdot-collector-releases/releases/download/${NRDOT_VERSION}/nrdot-collector_${NRDOT_VERSION}_linux_x86_64.rpm" --output nrdot-collector.rpm && sudo rpm -ivh nrdot-collector.rpm

Pour les systèmes Debian/Ubuntu, exécutez :

bash

$NRDOT_VERSION=$(curl -s https://api.github.com/repos/newrelic/nrdot-collector-releases/releases/latest | grep '"tag_name":' | awk -F'"' '{print $4}') && curl -L "https://github.com/newrelic/nrdot-collector-releases/releases/download/${NRDOT_VERSION}/nrdot-collector_${NRDOT_VERSION}_linux_arm64.deb" --output nrdot-collector.deb && sudo dpkg -i nrdot-collector.deb

Pour les systèmes RHEL/CentOS/OEL, exécutez :

bash

$NRDOT_VERSION=$(curl -s https://api.github.com/repos/newrelic/nrdot-collector-releases/releases/latest | grep '"tag_name":' | awk -F'"' '{print $4}') && curl -L "https://github.com/newrelic/nrdot-collector-releases/releases/download/${NRDOT_VERSION}/nrdot-collector_${NRDOT_VERSION}_linux_arm64.rpm" --output nrdot-collector.rpm && sudo rpm -ivh nrdot-collector.rpm

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

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;
```
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;
  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.
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;
```
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;

Conseil

Les droits V_$ASM_DISKGROUP_STAT et V_$ASM_DISK_STAT ne sont requis que si vous souhaitez collecter les métriques de disque et de groupe de disques ASM.

Configurer le collecteur NRDOT

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

Créez le fichier de configuration. Le nom du fichier doit être oracle-config.yaml.
bash
```
$sudo nano /etc/nrdot-collector/oracle-config.yaml
```
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

Port CDB Oracle

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

Mot de passe de la base de données

Nom du service CDB

Point de terminaison OTLP New Relic

Clé de licence New Relic

oracle-config.yaml

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]

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.

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 :

bash

$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

Conseil

Vous pouvez également :

Configurer plusieurs récepteurs: pour monitorer plusieurs instances de base de données Oracle à partir d’un seul collecteur.
Configurez le Récepteur de requêtes SQL: pour collecter des métriques personnalisées depuis votre base de données Oracle.
Liez votre base de données Oracle avec APM: pour corréler les performances de vos applications avec les opérations de base de données. Cela vous permet de voir exactement quelles applications génèrent des workloads de base de données spécifiques.
Configurer la gestion des secrets: pour gérer en toute sécurité des informations sensibles, telles que les identifiants de base de données. Cela permet de renforcer la sécurité de votre configuration de monitoring en évitant de coder en dur des données sensibles dans les fichiers de configuration.

Redémarrer NRDOT Collector

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

bash

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

Conseil

Redémarrez toujours le Collector NRDOT après avoir modifié la configuration pour que les nouveaux paramètres soient pris en compte.

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 :

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

Dépannage

Découvrez comment dépanner votre configuration de monitoring Oracle CDB dans New Relic.

Référence des métriques

Découvrez les métriques disponibles collectées par le collecteur NRDOT.

Instrumentation RDS

Découvrez comment configurer votre base de données Oracle pour le monitoring RDS dans New Relic.

Installation Docker

Découvrez comment exécuter le Collector NRDOT en tant que conteneur frère d'une instance de base de données Oracle s'exécutant déjà dans Docker.

Cette traduction automatique est fournie pour votre commodité.

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

Installation guidée

Prérequis

Installer le collecteur NRDOT

Pour l'architecture AMD64

Pour l'architecture ARM64

Configurer l'utilisateur de la base de données

Conseil

Conseil

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

Conseil

Configurer le collecteur NRDOT

configuration complète

Conseil

Mettre à jour la configuration du Collector NRDOT

Conseil

Redémarrer NRDOT Collector

Conseil

Trouvez et utilisez vos données

Dépannage

Référence des métriques

Instrumentation RDS

Installation Docker

Cette traduction automatique est fournie pour votre commodité.

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

Installation guidée

Prérequis .css-21sua1{background:none;border:none;width:0;padding:0;}

Installer le collecteur NRDOT

Pour l'architecture ARM64

Configurer l'utilisateur de la base de données

Conseil

Conseil

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

Conseil

Configurer le collecteur NRDOT

configuration complète

Conseil

Mettre à jour la configuration du Collector NRDOT

Conseil

Redémarrer NRDOT Collector

Conseil

Trouvez et utilisez vos données

Articles connexes

Dépannage

Référence des métriques

Instrumentation RDS

Installation Docker

Prérequis