Installer et configurer le NRDOT Collector pour le monitoring ADB

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 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 (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_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 <USER_NAME> IDENTIFIED BY "<YOUR_PASSWORD>";
GRANT CREATE SESSION TO <USER_NAME>;

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 <USER_NAME>;
GRANT SELECT ON SYS.V_$DATABASE   TO <USER_NAME>;
GRANT SELECT ON SYS.V_$CONTAINERS TO <USER_NAME>;
GRANT SELECT ON SYS.V_$DATAFILE   TO <USER_NAME>;
GRANT SELECT ON SYS.V_$PDBS       TO <USER_NAME>; 
GRANT SELECT ON SYS.V_$SYSSTAT                    TO <USER_NAME>;
GRANT SELECT ON SYS.V_$SYSMETRIC                  TO <USER_NAME>;
GRANT SELECT ON SYS.V_$SESSION                    TO <USER_NAME>;
GRANT SELECT ON SYS.V_$RESOURCE_LIMIT             TO <USER_NAME>;
GRANT SELECT ON SYS.V_$OSSTAT                     TO <USER_NAME>;
GRANT SELECT ON SYS.V_$SGAINFO                    TO <USER_NAME>;
GRANT SELECT ON SYS.V_$ROWCACHE                   TO <USER_NAME>;
GRANT SELECT ON SYS.V_$PARAMETER                  TO <USER_NAME>;
GRANT SELECT ON SYS.DBA_TABLESPACE_USAGE_METRICS  TO <USER_NAME>;
GRANT SELECT ON SYS.DBA_TABLESPACES               TO <USER_NAME>;
GRANT SELECT ON SYS.DBA_DATA_FILES                TO <USER_NAME>;
GRANT SELECT ON SYS.DBA_FREE_SPACE                TO <USER_NAME>;
GRANT SELECT ON SYS.DBA_RECYCLEBIN                TO <USER_NAME>;
GRANT SELECT ON SYS.V_$SQL            TO <USER_NAME>;
GRANT SELECT ON SYS.V_$SQL_PLAN_STATISTICS_ALL       TO <USER_NAME>;
GRANT SELECT ON SYS.V_$LOCK           TO <USER_NAME>;
GRANT SELECT ON SYS.V_$SESSION_EVENT  TO <USER_NAME>;
GRANT SELECT ON SYS.DBA_PROCEDURES    TO <USER_NAME>;
GRANT SELECT ON SYS.DBA_OBJECTS       TO <USER_NAME>;

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 :

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: 10s
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

13
top_query_collection:
14
   max_query_sample_count: 1000
15
   top_query_count: 200
16
   collection_interval: 60s
17
   allowed_comment_keys:
18
     - nr_service_guid
19

20
query_sample_collection:
21
   max_rows_per_query: 100
22
   allowed_comment_keys:
23
     - nr_service_guid
24

25
session_wait_event_collection:
26
   max_rows_per_query: 100
27

28
metrics:
29
   oracledb.cpu_time:
30
     enabled: true
31
   oracledb.executions:
32
     enabled: true
33
   oracledb.parse_calls:
34
     enabled: true
35
   oracledb.hard_parses:
36
     enabled: true
37
   oracledb.logical_reads:
38
     enabled: true
39
   oracledb.physical_reads:
40
     enabled: true
41
   oracledb.physical_reads_direct:
42
     enabled: true
43
   oracledb.physical_writes:
44
     enabled: true
45
   oracledb.physical_writes_direct:
46
     enabled: true
47
   oracledb.physical_read_io_requests:
48
     enabled: true
49
   oracledb.physical_write_io_requests:
50
     enabled: true
51
   oracledb.physical_io.cache_writes:
52
     enabled: true
53
   oracledb.physical_io.requests:
54
     enabled: true
55
     attributes:
56
       - disk.io.direction
57
       - disk.io.block_size
58
   oracledb.physical_io.transferred:
59
     enabled: true
60
     attributes:
61
       - disk.io.direction
62
       - disk.io.type
63
   oracledb.sqlnet.io.transferred:
64
     enabled: true
65
     attributes:
66
       - network.io.direction
67
       - destination.type
68
   oracledb.consistent_gets:
69
     enabled: true
70
   oracledb.db_block_gets:
71
     enabled: true
72
   oracledb.data_dictionary.hit_ratio:
73
     enabled: true
74
   oracledb.pga_memory:
75
     enabled: true
76
   oracledb.enqueue_deadlocks:
77
     enabled: true
78
   oracledb.exchange_deadlocks:
79
     enabled: true
80
   oracledb.sessions.usage:
81
     enabled: true
82
     attributes:
83
       - session_type
84
       - session_status
85
   oracledb.logons:
86
     enabled: true
87
   oracledb.user_commits:
88
     enabled: true
89
   oracledb.user_rollbacks:
90
     enabled: true
91
   oracledb.tablespace_size.limit:
92
     enabled: true
93
     attributes:
94
       - tablespace_name
95
   oracledb.tablespace_size.usage:
96
     enabled: true
97
     attributes:
98
       - tablespace_name
99
   oracledb.storage.usage:
100
     enabled: true
101
   oracledb.storage.utilization:
102
     enabled: true
103
   oracledb.recycle_bin.limit:
104
     enabled: true
105
   oracledb.queries_parallelized:
106
     enabled: true
107
   oracledb.ddl_statements_parallelized:
108
     enabled: true
109
   oracledb.dml_statements_parallelized:
110
     enabled: true
111
   oracledb.parallel_operations_not_downgraded:
112
     enabled: true
113
   oracledb.parallel_operations_downgraded_1_to_25_pct:
114
     enabled: true
115
   oracledb.parallel_operations_downgraded_25_to_50_pct:
116
     enabled: true
117
   oracledb.parallel_operations_downgraded_50_to_75_pct:
118
     enabled: true
119
   oracledb.parallel_operations_downgraded_75_to_99_pct:
120
     enabled: true
121
   oracledb.parallel_operations_downgraded_to_serial:
122
     enabled: true
123

124
processors:
125
batch:
126
  resource/add_event_name:
127
attributes:
128
   - key: host.address
129
     value: YOUR_DB_HOST
130
     action: upsert
131

132
exporters:
133
  otlphttp/newrelic:
134
  endpoint: https://otlp.nr-data.net:4318
135
headers:
136
   api-key: YOUR_LICENSE_KEY
137
  compression: gzip
138
retry_on_failure:
139
   enabled: true
140
   initial_interval: 5s
141
   max_interval: 30s
142
   max_elapsed_time: 300s
143

144
service:
145
telemetry:
146
metrics:
147
   level: none
148
pipelines:
149
  metrics/oracledb:
150
   receivers: [nroracledb/adb]
151
   processors: [resource/add_event_name, batch]
152
   exporters: [otlphttp/newrelic]
153
  logs/oracledb:
154
   receivers: [nroracledb/adb]
155
   processors: [resource/add_event_name, batch]
156
   exporters: [otlphttp/newrelic]

Les métriques suivantes ne sont pas prises en charge dans ADB:

oracledb.database.cpu.utilization
oracledb.database.wait.utilization
oracledb.host.cpu.utilization
oracledb.execution.utilization
oracledb.parse.rate
oracledb.parse.utilization
oracledb.sort.ratio
oracledb.sql_service.response.duration
oracledb.buffer_cache.utilization
oracledb.library_cache.utilization
oracledb.shared_pool.utilization
oracledb.redo_allocation.utilization
oracledb.processes.limit
oracledb.processes.usage
oracledb.sessions.limit
oracledb.transactions.limit
oracledb.transactions.usage
oracledb.dml_locks.limit
oracledb.dml_locks.usage
oracledb.enqueue_locks.limit
oracledb.enqueue_locks.usage
oracledb.enqueue_resources.limit
oracledb.enqueue_resources.usage

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

Après avoir configuré l’intégration Oracle ADB, vous pouvez commencer à monitorer et à analyser les performances de votre base de données dans New Relic :

Accédez à one.newrelic.com > All Entities.
Filtrez par Oracle pour trouver les entités de votre base de données.
Sélectionnez votre entité Oracle ADB pour afficher les dashboards, les métriques et les logs.
Pour plus d’informations sur le monitoring des bases de données Oracle, consultez notre documentation sur le monitoring de base de données.

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

Installer et configurer le NRDOT Collector pour le monitoring ADB

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

Configurer le collecteur NRDOT

Métriques ADB non prises en charge

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

Installer et configurer le NRDOT Collector pour le monitoring ADB

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

Configurer le collecteur NRDOT

Métriques ADB non prises en charge

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