Installez & configurez NRDOT pour le monitoring Oracle avec Autonomous Database

Obtenez des informations détaillées complètes sur les performances de votre Oracle Autonomous Database (ADB) 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).

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_aarch64.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 instance de base de données Oracle ADB. Exécutez les instructions suivantes en tant que SYS dans votre ADB cible pour créer un utilisateur de monitoring local :

CREATE USER <YOUR_DB_USERNAME> IDENTIFIED BY "<YOUR_DB_PASSWORD>";
GRANT CREATE SESSION TO <YOUR_DB_USERNAME>;

Accorder des privilèges de monitoring pour Autonomous Database

Exécutez ces commandes en tant qu’administrateur dans votre ADB. Cela donne à l’outil de monitoring l’accès de base dont il a besoin pour collecter des métriques, suivre des événements, et trouver vos instances de base de données.

GRANT SELECT ON SYS.V_$INSTANCE   TO <YOUR_DB_USERNAME>;
GRANT SELECT ON SYS.V_$DATABASE   TO <YOUR_DB_USERNAME>;
GRANT SELECT ON SYS.V_$CONTAINERS TO <YOUR_DB_USERNAME>;
GRANT SELECT ON SYS.V_$DATAFILE   TO <YOUR_DB_USERNAME>;
GRANT SELECT ON SYS.V_$PDBS       TO <YOUR_DB_USERNAME>; 
GRANT SELECT ON SYS.V_$SYSSTAT                    TO <YOUR_DB_USERNAME>;
GRANT SELECT ON SYS.V_$SYSMETRIC                  TO <YOUR_DB_USERNAME>;
GRANT SELECT ON SYS.V_$SESSION                    TO <YOUR_DB_USERNAME>;
GRANT SELECT ON SYS.V_$RESOURCE_LIMIT             TO <YOUR_DB_USERNAME>;
GRANT SELECT ON SYS.V_$OSSTAT                     TO <YOUR_DB_USERNAME>;
GRANT SELECT ON SYS.V_$SGAINFO                    TO <YOUR_DB_USERNAME>;
GRANT SELECT ON SYS.V_$ROWCACHE                   TO <YOUR_DB_USERNAME>;
GRANT SELECT ON SYS.V_$PARAMETER                  TO <YOUR_DB_USERNAME>;
GRANT SELECT ON SYS.DBA_TABLESPACE_USAGE_METRICS  TO <YOUR_DB_USERNAME>;
GRANT SELECT ON SYS.DBA_TABLESPACES               TO <YOUR_DB_USERNAME>;
GRANT SELECT ON SYS.DBA_DATA_FILES                TO <YOUR_DB_USERNAME>;
GRANT SELECT ON SYS.DBA_FREE_SPACE                TO <YOUR_DB_USERNAME>;
GRANT SELECT ON SYS.DBA_RECYCLEBIN                TO <YOUR_DB_USERNAME>;
GRANT SELECT ON SYS.V_$SQL            TO <YOUR_DB_USERNAME>;
GRANT SELECT ON SYS.V_$SQL_PLAN_STATISTICS_ALL       TO <YOUR_DB_USERNAME>;
GRANT SELECT ON SYS.V_$LOCK           TO <YOUR_DB_USERNAME>;
GRANT SELECT ON SYS.V_$SESSION_EVENT  TO <YOUR_DB_USERNAME>;
GRANT SELECT ON SYS.DBA_PROCEDURES    TO <YOUR_DB_USERNAME>;
GRANT SELECT ON SYS.DBA_OBJECTS       TO <YOUR_DB_USERNAME>;
GRANT SELECT ON SYS.V_$PROCESS        TO <YOUR_DB_USERNAME>;
GRANT SELECT ON SYS.V_$TRANSACTION    TO <YOUR_DB_USERNAME>;
GRANT SELECT ON SYS.CDB_SERVICES      TO <YOUR_DB_USERNAME>;

Configurer le collecteur NRDOT

Configurez le NRDOT Collector avec vos paramètres spécifiques à ADB. Créez un fichier de configuration (par exemple, adb-config.yaml) avec le contenu suivant :

configuration complète

Cette configuration capture les métriques de base de référence essentielles. Pour consulter le catalogue complet des métriques, reportez-vous à la référence de configuration.

Nom d'utilisateur de base de données

Mot de passe de la base de données

Nom d’hôte Oracle ADB

Port Oracle ADB

Nom du service

Point de terminaison OTLP New Relic

Clé de licence New Relic

adb-config.yaml

1
receivers:
2
  nroracledb/adb:
3
  datasource: "oracle://newrelic:YOUR_PASSWORD@adb.example.oraclecloud.com:1522/YOUR_SERVICE_NAME?ssl=true&ssl%20verify=true"
4
  collection_interval: 15s
5
events:
6
   db.server.query_sample:
7
     enabled: true
8
   db.server.top_query:
9
     enabled: true
10
   db.server.session.wait_sample:
11
     enabled: true
12
   db.server.top_procedure:
13
     enabled: true
14
   db.server.query_plan:
15
     enabled: true
16

17
top_query_collection:
18
   max_query_sample_count: 1000
19
   top_query_count: 200
20
   collection_interval: 60s
21
   allowed_comment_keys:
22
     - nr_service_guid
23

24
query_sample_collection:
25
   max_rows_per_query: 100
26
   allowed_comment_keys:
27
     - nr_service_guid
28

29
session_wait_event_collection:
30
   max_rows_per_query: 100
31

32
top_procedure_collection:
33
   max_procedure_sample_count: 1000
34
   top_procedure_count: 250
35
   collection_interval: 60s
36

37
  # Metrics configuration - This baseline configuration captures essential metrics. To enable advanced monitoring and extended telemetry, refer to the full configuration documentation
38
metrics:
39
   oracledb.buffer_cache.utilization:
40
     enabled: true
41
     attributes:
42
       - oracle.db.pdb
43
   oracledb.consistent_gets:
44
     enabled: true
45
     attributes:
46
       - oracle.db.pdb
47
   oracledb.cpu_time:
48
     enabled: true
49
     attributes:
50
       - oracle.db.pdb
51
   oracledb.database.cpu.utilization:
52
     enabled: true
53
     attributes:
54
       - oracle.db.pdb
55
   oracledb.database.wait.utilization:
56
     enabled: true
57
     attributes:
58
       - oracle.db.pdb
59
   oracledb.db_block_gets:
60
     enabled: true
61
     attributes:
62
       - oracle.db.pdb
63
   oracledb.enqueue_deadlocks:
64
     enabled: true
65
     attributes:
66
       - oracle.db.pdb
67
   oracledb.execution.utilization:
68
     enabled: true
69
     attributes:
70
       - oracledb.parse.type
71
       - oracle.db.pdb
72
   oracledb.executions:
73
     enabled: true
74
     attributes:
75
       - oracle.db.pdb
76
   oracledb.hard_parses:
77
     enabled: true
78
     attributes:
79
       - oracle.db.pdb
80
   oracledb.host.cpu.utilization:
81
     enabled: true
82
     attributes:
83
       - oracle.db.pdb
84
   oracledb.library_cache.utilization:
85
     enabled: true
86
     attributes:
87
       - oracle.db.pdb
88
   oracledb.logical_reads:
89
     enabled: true
90
     attributes:
91
       - oracle.db.pdb
92
   oracledb.logons:
93
     enabled: true
94
     attributes:
95
       - oracle.db.pdb
96
   oracledb.parse.rate:
97
     enabled: true
98
     attributes:
99
       - oracledb.parse.result
100
       - oracle.db.pdb
101
   oracledb.parse_calls:
102
     enabled: true
103
     attributes:
104
       - oracle.db.pdb
105
   oracledb.pga_memory:
106
     enabled: true
107
     attributes:
108
       - oracle.db.pdb
109
   oracledb.physical_io.requests:
110
     enabled: true
111
     attributes:
112
       - disk.io.direction
113
       - disk.io.block_size
114
       - oracle.db.pdb
115
   oracledb.physical_reads:
116
     enabled: true
117
     attributes:
118
       - oracle.db.pdb
119
   oracledb.physical_writes:
120
     enabled: true
121
     attributes:
122
       - oracle.db.pdb
123
   oracledb.processes.usage:
124
     enabled: true
125
   oracledb.sessions.usage:
126
     enabled: true
127
     attributes:
128
       - session_type
129
       - session_status
130
       - oracle.db.pdb
131
   oracledb.sga.usage:
132
     enabled: true
133
     attributes:
134
       - oracledb.sga.component.name
135
   oracledb.shared_pool.utilization:
136
     enabled: true
137
     attributes:
138
       - oracle.db.pdb
139
   oracledb.sql_service.response.duration:
140
     enabled: true
141
     attributes:
142
       - oracle.db.pdb
143
   oracledb.sqlnet.io.transferred:
144
     enabled: true
145
     attributes:
146
       - network.io.direction
147
       - destination.type
148
       - oracle.db.pdb
149
   oracledb.tablespace_size.usage:
150
     enabled: true
151
     attributes:
152
       - tablespace_name
153
       - oracle.db.pdb
154
   oracledb.transactions.usage:
155
     enabled: true
156
   oracledb.user_commits:
157
     enabled: true
158
     attributes:
159
       - oracle.db.pdb
160
   oracledb.user_rollbacks:
161
     enabled: true
162
     attributes:
163
       - oracle.db.pdb
164

165
  # Resource attributes attached to all metrics/logs (all enabled by default)
166
resource_attributes:
167
   oracle.db.edition:
168
     enabled: true
169
exporters:
170
  otlp/newrelic:
171
  endpoint: https://otlp.nr-data.net:4318
172
headers:
173
   api-key: YOUR_LICENSE_KEY
174
  compression: gzip
175
retry_on_failure:
176
   enabled: true
177
   initial_interval: 5s
178
   max_interval: 30s
179
   max_elapsed_time: 300s
180
sending_queue:
181
   enabled: true
182
   sizer: bytes
183
   queue_size: 100_000_000
184
   num_consumers: 10
185
   batch:
186
     sizer: bytes
187
     max_size: 1_000_000
188
     min_size: 0
189
     flush_timeout: 5s
190
service:
191
pipelines:
192
  metrics/oracledb:
193
   receivers: [nroracledb/adb]
194
   exporters: [otlp/newrelic]
195
  logs/oracledb:
196
   receivers: [nroracledb/adb]
197
   exporters: [otlp/newrelic]

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 configuré le collecteur, redémarrez le service NRDOT Collector pour appliquer les modifications :

bash

$sudo systemctl restart nrdot-collector

Pour vérifier que le collecteur fonctionne correctement, vérifiez l'état du service :

bash

$sudo systemctl status nrdot-collector

Conseil

Redémarrez toujours le Collector NRDOT après avoir modifié la configuration pour garantir la prise en compte des nouveaux paramètres.

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 ADB dans la liste des entités.

Dépannage

Découvrez comment dépanner votre configuration de monitoring Oracle ADB 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.

Cette traduction automatique est fournie pour votre commodité.

Installez & configurez NRDOT pour le monitoring Oracle avec Autonomous Database

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

Accorder des privilèges de monitoring pour Autonomous Database

Configurer le collecteur NRDOT

configuration complète

Conseil

Redémarrer NRDOT Collector

Conseil

Trouvez et utilisez vos données

Dépannage

Référence des métriques

Instrumentation RDS

Cette traduction automatique est fournie pour votre commodité.

Installez & configurez NRDOT pour le monitoring Oracle avec Autonomous Database

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

Accorder des privilèges de monitoring pour Autonomous Database

Configurer le collecteur NRDOT

configuration complète

Conseil

Redémarrer NRDOT Collector

Conseil

Trouvez et utilisez vos données

Articles connexes

Dépannage

Référence des métriques

Instrumentation RDS

Prérequis