Instalar y configurar NRDOT para el monitoreo de Oracle con la base de datos autónoma

Obtenga información valiosa completa sobre el rendimiento de su Oracle Autonomous Database (ADB) con el monitoreo de base de datos, el análisis de consultas y las métricas de estado del sistema utilizando el recolector de New Relic Distribution of OpenTelemetry (NRDOT).

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_aarch64.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 la instancia de base de datos Oracle ADB. Ejecute las siguientes sentencias como SYS dentro del ADB objetivo para crear un usuario de monitoreo local:

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

Otorgar privilegios de monitoreo para Autonomous Database

Ejecute estos comandos como administrador dentro de su ADB. Esto le da a la herramienta de monitoreo el acceso básico que necesita para recopilar métricas, rastrear eventos y encontrar sus instancias de base de datos.

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

Configurar el Colector NRDOT

Configure el Collector NRDOT con la configuración específica de ADB. Cree un archivo de configuración (por ejemplo, adb-config.yaml) con el siguiente contenido:

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 usuario de la base de datos

Contraseña de la base de datos

Nombre de host de Oracle ADB

Puerto de Oracle ADB

Nombre del servicio

Extremo OTLP de New Relic

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

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 configurar el recolector, reinicie el servicio NRDOT Collector para aplicar los cambios:

bash

$sudo systemctl restart nrdot-collector

Para verificar que el recolector se esté ejecutando correctamente, verifique el estado del servicio:

bash

$sudo systemctl status nrdot-collector

Sugerencia

Reinicie siempre el NRDOT Collector después de realizar cambios de configuración para garantizar 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 ADB de la lista de entidades.

Resolución de problemas

Aprenda a solucionar problemas de su configuración de monitoreo de Oracle ADB 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.

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

Instalar y configurar NRDOT para el monitoreo de Oracle con la base de datos autónoma

Instalación guiada

Requisitos previos

Instalar NRDOT Collector

Para la arquitectura AMD64

Para la arquitectura ARM64

Configurar el usuario de la base de datos

Otorgar privilegios de monitoreo para Autonomous Database

Configurar el Colector NRDOT

configuración completa

Sugerencia

Reiniciar NRDOT Collector

Sugerencia

Encuentra y utiliza tus datos

Resolución de problemas

Referencia de métricas

Instrumentación de RDS

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

Instalar y configurar NRDOT para el monitoreo de Oracle con la base de datos autónoma

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

Otorgar privilegios de monitoreo para Autonomous Database

Configurar el Colector NRDOT

configuración completa

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

Requisitos previos