Instalar y configurar NRDOT para el monitoreo de Oracle con CDB autohospedada

Obtenga información valiosa y completa sobre el rendimiento de la base de datos de contenedor (CDB) de Oracle con el monitoreo de base de datos, el análisis de consultas y las métricas de estado del sistema mediante el recolector de New Relic Distribution of OpenTelemetry (NRDOT). Se monitorean todas las bases de datos conectables (PDB) bajo la CDB configurada.

Instalación guiada

Para instalar a través de la UI de New Relic en su lugar, vaya a one.newrelic.com > Integrations & Agents > Oracle (Database 360). Esta página solo cubre la instalación manual.

Requisitos previos

Antes de comenzar, cerciorar de tener lo siguiente:

Una clave de licenciade New Relic válida
Arquitectura compatible: Linux con AMD64 y ARM64
Conectividad de red al extremo OTLP de New Relic
Oracle Database 19c o posterior

Instalar NRDOT Collector

Seleccione el método de distribución de instalación adecuado para su entorno Linux:

Para sistemas Debian/Ubuntu, ejecute:
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
```

Para sistemas RHEL/CentOS/OEL, ejecute:

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

Para sistemas Debian/Ubuntu, ejecute:

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

Para sistemas RHEL/CentOS/OEL, ejecute:

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

Configurar el usuario de la base de datos

Cree un usuario de monitoreo con los privilegios necesarios para su base de datos Oracle multitenant. Esto requiere crear un usuario común con el prefijo C##.

Para establecer el contexto de contenedor activo actual en CDB$ROOT, ejecute la siguiente sentencia como usuario SYS:
```
ALTER SESSION SET CONTAINER = CDB$ROOT;
```
Para bases de datos multiinquilino:
1. Inicie sesión en la base de datos raíz como administrador.
2. Para crear un nuevo usuario, ejecute la siguiente sentencia CREATE USER:
  CREATE USER c##<YOUR_DB_USERNAME> IDENTIFIED BY "<YOUR_DB_PASSWORD>" CONTAINER=ALL; GRANT CREATE SESSION TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
  Sugerencia
  El usuario recién creado será un usuario común con el prefijo C##. El prefijo C## es requerido por Oracle para los usuarios comunes.
Para permitir que el usuario de monitoreo vea las filas de cada PDB en las vistas de datos de contenedor, ejecute la siguiente sentencia como SYSDBA en la raíz de CDB. Esto es necesario para las métricas y eventos por PDB.
```
ALTER USER c##<YOUR_DB_USERNAME> SET CONTAINER_DATA=ALL CONTAINER=CURRENT;
```
Sugerencia
Asegúrese de que su USER_PASSWORD cumpla con los requisitos de contraseña de nuevo usuario de Oracle.

Otorgar privilegios de monitoreo para la base de datos multiinquilino

Ejecute las siguientes sentencias de GRANT como SYSDBA en la raíz de CDB. Estas cubren la detección de instancia, la recopilación de métricas, el monitoreo por PDB y la recopilación de eventos. Puede ejecutarlas juntas como un solo script o ejecutar cada sentencia individualmente.

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;

Sugerencia

Los permisos V_$ASM_DISKGROUP_STAT y V_$ASM_DISK_STAT solo son necesarios si desea recopilar métricas de disco y grupo de discos de ASM.

Configurar el Colector NRDOT

Configure el Collector de NRDOT con la configuración específica de CDB.

Cree el archivo de configuración. El nombre del archivo debe ser oracle-config.yaml.
bash
```
$sudo nano /etc/nrdot-collector/oracle-config.yaml
```
Agregue el siguiente contenido de configuración al archivo oracle-config.yaml que creó en el paso anterior.

configuración completa

Esta configuración captura métricas esenciales de línea de base. Para ver el catálogo completo de métricas, consulte la referencia de configuración.

Nombre de host/IP de CDB de Oracle

Puerto de CDB de Oracle

Nombre de usuario de la base de datos (sin el prefijo C##)

Contraseña de la base de datos

Nombre del servicio CDB

Extremo OTLP de New Relic

Clave de licencia de 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]

En la sección de eventos, habilite estos tipos de eventos para recopilar sus métricas:

evento	Descripción
`db.server.query_sample`	Muestras de consultas activas por sesión que capturan el SQL actual, el estado de espera y los detalles de bloqueo.
`db.server.top_query`	Las N principales sentencias SQL por CPU o tiempo transcurrido, incluidas las estadísticas de ejecución y los planes de consulta.
`db.server.session.wait_sample`	Recuentos y duraciones de espera acumulados por sesión de `v$session_event`.
`db.server.top_procedure`	Los N principales procedimientos almacenados clasificados por uso de recursos, incluidas las estadísticas de ejecución.
`db.server.query_plan`	Detalles del plan de ejecución para las consultas principales y muestreadas.

Configure los ajustes de recopilación para cada tipo de evento:

Sección de configuración	Parámetro	Valor
`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

Sugerencia

Para obtener información más detallada sobre la configuración del endpoint OTLP de New Relic y las mejores prácticas de OpenTelemetry, consulte la documentación de OTLP de OpenTelemetry.

Actualizar la configuración de NRDOT Collector

Actualice la configuración del NRDOT Collector para utilizar el archivo 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

Sugerencia

Tú también puedes:

Configurar múltiples receptores: para monitorear múltiples instancias de base de datos Oracle desde un recolector.
Configurar el receptor de consultas SQL: para recopilar métricas personalizadas de la base de datos Oracle.
Vincule su Oracle Database con APM: para correlacionar el rendimiento de la aplicación con las operaciones de la base de datos. Esto le permite ver exactamente qué aplicaciones están generando cargas de trabajo de base de datos específicas.
Configurar la gestión de secretos: para administrar de forma segura información confidencial, como las credenciales de bases de datos. Esto ayuda a mejorar la seguridad de su configuración de monitoreo al evitar la codificación rígida de datos sensibles en los archivos de configuración.

Reiniciar NRDOT Collector

Después de actualizar la configuración, reinicie el NRDOT Collector:

bash

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

Sugerencia

Reinicie siempre el NRDOT Collector después de realizar cambios de configuración para que los nuevos ajustes surtan efecto.

Encuentra y utiliza tus datos

Una vez que se estén recopilando sus datos, puede acceder a un monitoreo integral de Oracle Database a través de la UI de New Relic.

Para encontrar su entidad de base de datos Oracle en New Relic:

Vaya a https://one.newrelic.com > All Capabilities > Databases.
Establezca los criterios de búsqueda como instrumentation.provider = opentelemetry.
Seleccione su base de datos Oracle de la lista de entidades.

Resolución de problemas

Aprenda a solucionar problemas de la configuración de monitoreo de Oracle CDB en New Relic.

Referencia de métricas

Obtenga información sobre las métricas disponibles recopiladas por NRDOT Collector.

Instrumentación de RDS

Aprenda a configurar su Oracle Database para el monitoreo de RDS en New Relic.

Instalación de Docker

Aprenda a ejecutar el NRDOT Collector como un contenedor hermano de una instancia de base de datos de Oracle que ya se ejecuta en Docker.

Te ofrecemos esta traducción automática para facilitar la lectura.

Instalar y configurar NRDOT para el monitoreo de Oracle con CDB autohospedada

Instalación guiada

Requisitos previos

Instalar NRDOT Collector

Para la arquitectura AMD64

Para la arquitectura ARM64

Configurar el usuario de la base de datos

Sugerencia

Sugerencia

Otorgar privilegios de monitoreo para la base de datos multiinquilino

Sugerencia

Configurar el Colector NRDOT

configuración completa

Sugerencia

Actualizar la configuración de NRDOT Collector

Sugerencia

Reiniciar NRDOT Collector

Sugerencia

Encuentra y utiliza tus datos

Resolución de problemas

Referencia de métricas

Instrumentación de RDS

Instalación de Docker

Te ofrecemos esta traducción automática para facilitar la lectura.

Instalar y configurar NRDOT para el monitoreo de Oracle con CDB autohospedada

Instalación guiada

Requisitos previos .css-21sua1{background:none;border:none;width:0;padding:0;}

Instalar NRDOT Collector

Para la arquitectura ARM64

Configurar el usuario de la base de datos

Sugerencia

Sugerencia

Otorgar privilegios de monitoreo para la base de datos multiinquilino

Sugerencia

Configurar el Colector NRDOT

configuración completa

Sugerencia

Actualizar la configuración de NRDOT Collector

Sugerencia

Reiniciar NRDOT Collector

Sugerencia

Encuentra y utiliza tus datos

Artículos relacionados

Resolución de problemas

Referencia de métricas

Instrumentación de RDS

Instalación de Docker

Requisitos previos