Installez et configurez le NRDOT Collector pour le monitoring d'AWS RDS

Aperçu

Nous travaillons toujours sur cette fonctionnalité, mais nous aimerions que vous l'essayiez !

Cette fonctionnalité est actuellement fournie dans le cadre d'un aperçu conformément à nos politiques de pré-sortie.

Obtenez des informations détaillées complètes sur les performances de votre base de données Amazon RDS Oracle grâce au monitoring de base de données, à l'analyse des requêtes, et aux 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 (OpenTelemetry) . Cette page couvre uniquement l'installation via la CLI.

Prérequis

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

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

Inscrivez-vous à la préversion

Cette intégration est disponible dans le cadre du programme d'aperçu public de New Relic. Contactez le responsable de votre organisation pour vous inscrire à partir de la page Previews & Trials.

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

Connectez-vous à la base de données racine en tant qu'administrateur :
```
CREATE USER <USERNAME> IDENTIFIED BY "<USER_PASSWORD>";
```
Accorder les privilèges CONNECT à l'utilisateur nouvellement créé :
```
GRANT CONNECT TO <USERNAME>;
```

Accorder des privilèges de monitoring pour la base de données RDS

Exécutez les instructions SQL suivantes pour accorder des privilèges de monitoring. Remplacez <USERNAME_IN_UPPERCASE> par votre nom d'utilisateur en majuscules :

EXEC rdsadmin.rdsadmin_util.grant_sys_object('V_$SYSMETRIC',      '<USERNAME_IN_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('V_$CON_SYSMETRIC',  '<USERNAME_IN_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('V_$CONTAINERS',     '<USERNAME_IN_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('V_$SESSION',        '<USERNAME_IN_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('V_$SESSION_EVENT',  '<USERNAME_IN_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('V_$SYSSTAT',        '<USERNAME_IN_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('V_$CON_SYSSTAT',    '<USERNAME_IN_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('V_$OSSTAT',         '<USERNAME_IN_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('V_$SGAINFO',        '<USERNAME_IN_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('V_$SQL',            '<USERNAME_IN_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('V_$SQLSTATS',       '<USERNAME_IN_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('V_$SQL_PLAN_STATISTICS_ALL',       '<USERNAME_IN_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('V_$PARAMETER',      '<USERNAME_IN_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('V_$ROWCACHE',       '<USERNAME_IN_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('V_$RESOURCE_LIMIT', '<USERNAME_IN_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('V_$LOCK',           '<USERNAME_IN_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('V_$DATABASE',       '<USERNAME_IN_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('V_$INSTANCE',       '<USERNAME_IN_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('V_$DATAFILE',       '<USERNAME_IN_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('V_$PDBS',           '<USERNAME_IN_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('DBA_DATA_FILES',               '<USERNAME_IN_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('DBA_FREE_SPACE',               '<USERNAME_IN_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('DBA_RECYCLEBIN',               '<USERNAME_IN_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('DBA_TABLESPACES',              '<USERNAME_IN_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('DBA_TABLESPACE_USAGE_METRICS', '<USERNAME_IN_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('DBA_PROCEDURES',               '<USERNAME_IN_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('DBA_OBJECTS',                  '<USERNAME_IN_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('CDB_TABLESPACE_USAGE_METRICS', '<USERNAME_IN_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('CDB_TABLESPACES',              '<USERNAME_IN_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('CDB_SERVICES',                 '<USERNAME_IN_UPPERCASE>', 'SELECT', false);
GRANT CREATE SESSION TO <USERNAME_IN_UPPERCASE>;

Configurer le collecteur NRDOT

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

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 se concentre uniquement sur le monitoring de la base de données sans les métriques d’infrastructure de l’hôte. Pour activer le monitoring de toutes les fonctionnalités, consultez la référence de configuration.
Point de terminaison RDS Oracle
Saisissez votre point de terminaison Oracle RDS
Port RDS 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
Saisissez votre nom d'utilisateur de base de données pour l'authentification
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
Saisissez le nom de votre service 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
1 receivers: 2 nroracledb/rds: 3 endpoint: mydb-instance.xxxxxxxxxxxx.us-east-1.rds.amazonaws.com:1521 4 username: newrelic 5 password: YOUR_PASSWORD 6 service: YOUR_SERVICE_NAME 7 collection_interval: 10s 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 16 top_query_collection: 17 max_query_sample_count: 1000 18 top_query_count: 200 19 collection_interval: 60s 20 allowed_comment_keys: 21 - nr_service_guid 22 23 query_sample_collection: 24 max_rows_per_query: 100 25 allowed_comment_keys: 26 - nr_service_guid 27 28 session_wait_event_collection: 29 max_rows_per_query: 100 30 31 # Metrics configuration - organized by category 32 metrics: 33 # === CPU & Performance Metrics === 34 oracledb.cpu_time: 35 enabled: true 36 attributes: 37 - oracle.db.pdb 38 39 # === Execution & Parse Metrics === 40 oracledb.executions: 41 enabled: true 42 attributes: 43 - oracle.db.pdb 44 oracledb.parse_calls: 45 enabled: true 46 attributes: 47 - oracle.db.pdb 48 oracledb.hard_parses: 49 enabled: true 50 attributes: 51 - oracle.db.pdb 52 53 # === I/O & Physical Read/Write Metrics === 54 oracledb.logical_reads: 55 enabled: true 56 attributes: 57 - oracle.db.pdb 58 oracledb.physical_reads: 59 enabled: true 60 attributes: 61 - oracle.db.pdb 62 oracledb.physical_reads_direct: 63 enabled: true 64 attributes: 65 - oracle.db.pdb 66 oracledb.physical_writes: 67 enabled: true 68 attributes: 69 - oracle.db.pdb 70 oracledb.physical_writes_direct: 71 enabled: true 72 attributes: 73 - oracle.db.pdb 74 oracledb.physical_read_io_requests: 75 enabled: true 76 attributes: 77 - oracle.db.pdb 78 oracledb.physical_write_io_requests: 79 enabled: true 80 attributes: 81 - oracle.db.pdb 82 83 # === New Physical I/O Metrics (detailed) === 84 oracledb.physical_io.cache_writes: 85 enabled: true 86 attributes: 87 - oracle.db.pdb 88 oracledb.physical_io.requests: 89 enabled: true 90 attributes: 91 - disk.io.direction 92 - disk.io.block_size 93 - oracle.db.pdb 94 oracledb.physical_io.transferred: 95 enabled: true 96 attributes: 97 - disk.io.direction 98 - disk.io.type 99 - oracle.db.pdb 100 101 # === Network I/O Metrics === 102 oracledb.sqlnet.io.transferred: 103 enabled: true 104 attributes: 105 - network.io.direction 106 - destination.type 107 - oracle.db.pdb 108 109 # === Buffer & Cache Metrics === 110 oracledb.consistent_gets: 111 enabled: true 112 attributes: 113 - oracle.db.pdb 114 oracledb.db_block_gets: 115 enabled: true 116 attributes: 117 - oracle.db.pdb 118 oracledb.data_dictionary.hit_ratio: 119 enabled: true 120 121 # === Memory Metrics === 122 oracledb.pga_memory: 123 enabled: true 124 attributes: 125 - oracle.db.pdb 126 oracledb.sga.limit: 127 enabled: true 128 oracledb.sga.usage: 129 enabled: true 130 attributes: 131 - oracledb.sga.component.name 132 133 oracledb.enqueue_deadlocks: 134 enabled: true 135 attributes: 136 - oracle.db.pdb 137 oracledb.exchange_deadlocks: 138 enabled: true 139 attributes: 140 - oracle.db.pdb 141 142 # KEEP enabled: sessions.usage is sourced from v$session, not v$resource_limit. 143 oracledb.sessions.usage: 144 enabled: true 145 attributes: 146 - session_type 147 - session_status 148 - oracle.db.pdb 149 oracledb.logons: 150 enabled: true 151 attributes: 152 - oracle.db.pdb 153 154 oracledb.user_commits: 155 enabled: true 156 attributes: 157 - oracle.db.pdb 158 oracledb.user_rollbacks: 159 enabled: true 160 attributes: 161 - oracle.db.pdb 162 163 # === Tablespace Metrics === 164 oracledb.tablespace_size.limit: 165 enabled: true 166 attributes: 167 - tablespace_name 168 - oracle.db.pdb 169 oracledb.tablespace_size.usage: 170 enabled: true 171 attributes: 172 - tablespace_name 173 - oracle.db.pdb 174 175 # === Storage Metrics === 176 oracledb.storage.usage: 177 enabled: true 178 oracledb.storage.utilization: 179 enabled: true 180 oracledb.recycle_bin.limit: 181 enabled: true 182 183 # === Parallel Operations Metrics === 184 oracledb.queries_parallelized: 185 enabled: true 186 attributes: 187 - oracle.db.pdb 188 oracledb.ddl_statements_parallelized: 189 enabled: true 190 attributes: 191 - oracle.db.pdb 192 oracledb.dml_statements_parallelized: 193 enabled: true 194 attributes: 195 - oracle.db.pdb 196 oracledb.parallel_operations_not_downgraded: 197 enabled: true 198 attributes: 199 - oracle.db.pdb 200 oracledb.parallel_operations_downgraded_1_to_25_pct: 201 enabled: true 202 attributes: 203 - oracle.db.pdb 204 oracledb.parallel_operations_downgraded_25_to_50_pct: 205 enabled: true 206 attributes: 207 - oracle.db.pdb 208 oracledb.parallel_operations_downgraded_50_to_75_pct: 209 enabled: true 210 attributes: 211 - oracle.db.pdb 212 oracledb.parallel_operations_downgraded_75_to_99_pct: 213 enabled: true 214 attributes: 215 - oracle.db.pdb 216 oracledb.parallel_operations_downgraded_to_serial: 217 enabled: true 218 attributes: 219 - oracle.db.pdb 220 processors: 221 batch: 222 resource/add_event_name: 223 attributes: 224 - key: host.address 225 value: YOUR_DB_HOST 226 action: upsert 227 exporters: 228 otlp/newrelic: 229 endpoint: https://otlp.nr-data.net:4318 230 headers: 231 api-key: YOUR_LICENSE_KEY 232 compression: gzip 233 retry_on_failure: 234 enabled: true 235 initial_interval: 5s 236 max_interval: 30s 237 max_elapsed_time: 300s 238 service: 239 pipelines: 240 metrics/oracledb: 241 receivers: [nroracledb/rds] 242 processors: [resource/add_event_name, batch] 243 exporters: [otlp/newrelic] 244 logs/oracledb: 245 receivers: [nroracledb/rds] 246 processors: [resource/add_event_name, batch] 247 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` .

É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

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

Mettre à jour la configuration du Collector NRDOT

Mettez à jour la configuration du NRDOT Collector 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.
Configurer le Récepteur de requêtes SQL: pour collecter des métriques personnalisées à partir de votre base de données Oracle.
Lier votre base de données Oracle à l'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 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'interface utilisateur 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 RDS dans New Relic.

Référence des métriques

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

Instrumentation CDB

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

Cette traduction automatique est fournie pour votre commodité.

Installez et configurez le NRDOT Collector pour le monitoring d'AWS RDS

Aperçu

Installation guidée

Prérequis

Inscrivez-vous à la préversion

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 la base de données RDS

Configurer le collecteur NRDOT

configuration complète

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 CDB

Cette traduction automatique est fournie pour votre commodité.

Installez et configurez le NRDOT Collector pour le monitoring d'AWS RDS

Aperçu

Installation guidée

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

Inscrivez-vous à la préversion

Installer le collecteur NRDOT

Pour l'architecture ARM64

Configurer l'utilisateur de la base de données

Accorder des privilèges de monitoring pour la base de données RDS

Configurer le collecteur NRDOT

configuration complète

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 CDB

Prérequis