Instalar y configurar NRDOT para el monitoreo de Oracle con Docker

Obtenga información valiosa y exhaustiva sobre el rendimiento de la base de datos Oracle con el monitoreo de base de datos, el análisis de consultas y las métricas de estado del sistema mediante el Collector de New Relic Distribution of OpenTelemetry (NRDOT), que se ejecuta como un contenedor hermano de una instancia de base de datos Oracle que ya se está ejecutando en Docker.

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 ruta de instalación de Docker.

Sugerencia

¿Busca automatizar esto a escala en su lugar? Consulte la instalación de Ansible, la instalación de Chef o la instalación del chart de Helm para Kubernetes.

Requisitos previos

Antes de comenzar, cerciorar de tener lo siguiente:

Docker instalado en el host.
Un contenedor de base de datos Oracle que ya esté en ejecución (base de datos Oracle 19c o posterior), con sqlplus disponible en su interior.
La contraseña de sys para ese contenedor.
Una clave de licencia de New Relic válida.
Conectividad de red desde el contenedor del recolector al extremo OTLP de New Relic.

Configurar el usuario de la base de datos y otorgar privilegios

Cree un usuario de monitoreo y concédale las vistas necesarias para la recopilación de métricas, consultas y eventos ejecutando SQL en su contenedor de Oracle con docker exec. Elija la pestaña que coincida con su despliegue, ya sea una base de datos de contenedor (CDB) multiinquilino o una única base de datos conectable (PDB):

Esto crea un usuario común (necesario para usar el prefijo C##) y le concede visibilidad en cada PDB bajo la CDB. Reemplace <YOUR_ORACLE_CONTAINER_NAME>, <YOUR_SYS_PASSWORD>, <YOUR_DB_USERNAME> y <YOUR_DB_PASSWORD> con sus propios valores:

bash

$docker exec -i <YOUR_ORACLE_CONTAINER_NAME> sqlplus sys/'<YOUR_SYS_PASSWORD>' as sysdba << 'EOF'
$ALTER SESSION SET CONTAINER = CDB$ROOT;
$
$-- Create the common user and set container-data visibility
$CREATE USER c##<YOUR_DB_USERNAME> IDENTIFIED BY "<YOUR_DB_PASSWORD>" CONTAINER=ALL;
$GRANT CREATE SESSION TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
$ALTER USER c##<YOUR_DB_USERNAME> SET CONTAINER_DATA=ALL CONTAINER=CURRENT;
$
$-- Grant system and dynamic performance views
$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;
$
$EXIT;
$EOF

Sugerencia

Oracle requiere el prefijo C## para los usuarios comunes. Los dos últimos permisos (V_$ASM_DISKGROUP_STAT y V_$ASM_DISK_STAT) solo son necesarios si desea recopilar métricas de disco y grupos de discos de ASM. Omítalos si no utiliza ASM.

Esto crea un usuario local dentro de una única PDB objetivo. Reemplace <YOUR_ORACLE_CONTAINER_NAME>, <YOUR_SYS_PASSWORD>, <YOUR_PDB_SERVICE_NAME>, <YOUR_DB_USERNAME> y <YOUR_DB_PASSWORD> con sus propios valores:

bash

$docker exec -i <YOUR_ORACLE_CONTAINER_NAME> sqlplus sys/'<YOUR_SYS_PASSWORD>'@//localhost:1521/<YOUR_PDB_SERVICE_NAME> as sysdba << 'EOF'
$ALTER SESSION SET CONTAINER = <YOUR_PDB_SERVICE_NAME>;
$
$-- Create the local user in the PDB
$CREATE USER <YOUR_DB_USERNAME> IDENTIFIED BY "<YOUR_DB_PASSWORD>";
$GRANT CREATE SESSION TO <YOUR_DB_USERNAME>;
$
$-- Grant system and dynamic performance views
$GRANT SELECT ON V_$INSTANCE                   TO <YOUR_DB_USERNAME>;
$GRANT SELECT ON V_$DATABASE                   TO <YOUR_DB_USERNAME>;
$GRANT SELECT ON V_$CONTAINERS                 TO <YOUR_DB_USERNAME>;
$GRANT SELECT ON V_$DATAFILE                   TO <YOUR_DB_USERNAME>;
$GRANT SELECT ON V_$SYSSTAT                    TO <YOUR_DB_USERNAME>;
$GRANT SELECT ON V_$SYSMETRIC                  TO <YOUR_DB_USERNAME>;
$GRANT SELECT ON V_$SESSION                    TO <YOUR_DB_USERNAME>;
$GRANT SELECT ON V_$RESOURCE_LIMIT             TO <YOUR_DB_USERNAME>;
$GRANT SELECT ON V_$OSSTAT                     TO <YOUR_DB_USERNAME>;
$GRANT SELECT ON V_$SGAINFO                    TO <YOUR_DB_USERNAME>;
$GRANT SELECT ON V_$ROWCACHE                   TO <YOUR_DB_USERNAME>;
$GRANT SELECT ON V_$PARAMETER                  TO <YOUR_DB_USERNAME>;
$GRANT SELECT ON DBA_TABLESPACE_USAGE_METRICS  TO <YOUR_DB_USERNAME>;
$GRANT SELECT ON DBA_TABLESPACES               TO <YOUR_DB_USERNAME>;
$GRANT SELECT ON DBA_DATA_FILES                TO <YOUR_DB_USERNAME>;
$GRANT SELECT ON DBA_FREE_SPACE                TO <YOUR_DB_USERNAME>;
$GRANT SELECT ON DBA_RECYCLEBIN                TO <YOUR_DB_USERNAME>;
$GRANT SELECT ON V_$SQL                        TO <YOUR_DB_USERNAME>;
$GRANT SELECT ON V_$SQL_PLAN_STATISTICS_ALL    TO <YOUR_DB_USERNAME>;
$GRANT SELECT ON V_$LOCK                       TO <YOUR_DB_USERNAME>;
$GRANT SELECT ON V_$SESSION_EVENT              TO <YOUR_DB_USERNAME>;
$GRANT SELECT ON DBA_PROCEDURES                TO <YOUR_DB_USERNAME>;
$GRANT SELECT ON DBA_OBJECTS                   TO <YOUR_DB_USERNAME>;
$GRANT SELECT ON V_$PDBS                       TO <YOUR_DB_USERNAME>;
$GRANT SELECT ON V_$PROCESS                    TO <YOUR_DB_USERNAME>;
$GRANT SELECT ON V_$TRANSACTION                TO <YOUR_DB_USERNAME>;
$GRANT SELECT ON V_$CON_SYSSTAT                TO <YOUR_DB_USERNAME>;
$GRANT SELECT ON V_$CON_SYSMETRIC               TO <YOUR_DB_USERNAME>;
$GRANT SELECT ON V_$ASM_DISKGROUP_STAT          TO <YOUR_DB_USERNAME>;
$GRANT SELECT ON V_$ASM_DISK_STAT               TO <YOUR_DB_USERNAME>;
$
$EXIT;
$EOF

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.

Sugerencia

Si necesita monitorear toda la base de datos de contenedor en lugar de una base de datos conectable individual, use la pestaña CDB en su lugar.

Asegurar la conectividad de red de Docker

Cree una red compartida definida por el usuario (si aún no tiene una) y conecte el contenedor de Oracle a ella, para que el contenedor del recolector pueda resolverla por nombre:

bash

$docker network create <YOUR_DOCKER_NETWORK> 2>/dev/null || true
$docker network connect <YOUR_DOCKER_NETWORK> <YOUR_ORACLE_CONTAINER_NAME> 2>/dev/null || true

Sugerencia

Es seguro volver a ejecutar ambos comandos: || true ignora los errores "already exists" o "already connected" de una ejecución anterior.

Crear la configuración del Collector NRDOT

Elija la pestaña que coincida con el usuario que creó en Configurar el usuario de la base de datos y otorgar privilegios:

configuración completa

Esta configuración se centra solo en el monitoreo de la base de datos sin métricas de infraestructura del host. Para habilitar el monitoreo de todas las características, consulte la referencia de configuración.

Ejecute lo siguiente en el host de Docker para generar oracle-config.yaml:

bash

$cat << 'EOF' > oracle-config.yaml
$receivers:
$  nroracledb:
$    endpoint: "<YOUR_ORACLE_CONTAINER_NAME>:1521"
$    username: "c##<YOUR_DB_USERNAME>"
$    password: "<YOUR_DB_PASSWORD>"
$    service: "<YOUR_CDB_SERVICE_NAME>"
$    collection_interval: 15s
$    events:
$      db.server.query_sample:
$        enabled: true
$      db.server.top_query:
$        enabled: true
$      db.server.session.wait_sample:
$        enabled: true
$      db.server.top_procedure:
$        enabled: true
$      db.server.query_plan:
$        enabled: true
$
$    top_query_collection:
$      max_query_sample_count: 1000
$      top_query_count: 200
$      collection_interval: 60s
$      allowed_comment_keys:
$        - nr_service_guid
$
$    query_sample_collection:
$      max_rows_per_query: 100
$      allowed_comment_keys:
$        - nr_service_guid
$
$    session_wait_event_collection:
$      max_rows_per_query: 100
$
$    top_procedure_collection:
$      max_procedure_sample_count: 1000
$      top_procedure_count: 250
$      collection_interval: 60s
$
$    # Metrics configuration - This baseline configuration captures essential metrics. To enable advanced monitoring and extended telemetry, refer to the full configuration documentation
$    metrics:
$      oracledb.buffer_cache.utilization:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.consistent_gets:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.cpu_time:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.database.cpu.utilization:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.database.wait.utilization:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.db_block_gets:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.enqueue_deadlocks:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.execution.utilization:
$        enabled: true
$        attributes:
$          - oracledb.parse.type
$          - oracle.db.pdb
$      oracledb.executions:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.hard_parses:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.host.cpu.utilization:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.library_cache.utilization:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.logical_reads:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.logons:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.parse.rate:
$        enabled: true
$        attributes:
$          - oracledb.parse.result
$          - oracle.db.pdb
$      oracledb.parse_calls:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.pga_memory:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.physical_io.requests:
$        enabled: true
$        attributes:
$          - disk.io.direction
$          - disk.io.block_size
$          - oracle.db.pdb
$      oracledb.physical_reads:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.physical_writes:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.processes.usage:
$        enabled: true
$      oracledb.sessions.usage:
$        enabled: true
$        attributes:
$          - session_type
$          - session_status
$          - oracle.db.pdb
$      oracledb.sga.usage:
$        enabled: true
$        attributes:
$          - oracledb.sga.component.name
$      oracledb.shared_pool.utilization:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.sql_service.response.duration:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.sqlnet.io.transferred:
$        enabled: true
$        attributes:
$          - network.io.direction
$          - destination.type
$          - oracle.db.pdb
$      oracledb.tablespace_size.usage:
$        enabled: true
$        attributes:
$          - tablespace_name
$          - oracle.db.pdb
$      oracledb.transactions.usage:
$        enabled: true
$      oracledb.user_commits:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.user_rollbacks:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$
$    # Resource attributes attached to all metrics/logs (all enabled by default)
$    resource_attributes:
$      oracle.db.edition:
$        enabled: true
$
$exporters:
$  otlp/newrelic:
$    endpoint: "<YOUR_NEWRELIC_OTLP_ENDPOINT>"
$    headers:
$      api-key: "<YOUR_NEWRELIC_LICENSE_KEY>"
$    compression: gzip
$    retry_on_failure:
$      enabled: true
$      initial_interval: 5s
$      max_interval: 30s
$      max_elapsed_time: 300s
$    sending_queue:
$      enabled: true
$      sizer: bytes
$      queue_size: 100_000_000
$      num_consumers: 10
$      batch:
$        sizer: bytes
$        max_size: 1_000_000
$        min_size: 0
$        flush_timeout: 5s
$
$service:
$  pipelines:
$    metrics/oracledb:
$      receivers: [nroracledb]
$      exporters: [otlp/newrelic]
$    logs/oracledb:
$      receivers: [nroracledb]
$      exporters: [otlp/newrelic]
$EOF

configuración completa

Ejecute lo siguiente en el host de Docker para generar oracle-config.yaml:

bash

$cat << 'EOF' > oracle-config.yaml
$receivers:
$  nroracledb:
$    endpoint: "<YOUR_ORACLE_CONTAINER_NAME>:1521"
$    username: "<YOUR_DB_USERNAME>"
$    password: "<YOUR_DB_PASSWORD>"
$    service: "<YOUR_PDB_SERVICE_NAME>"
$    collection_interval: 15s
$    events:
$      db.server.query_sample:
$        enabled: true
$      db.server.top_query:
$        enabled: true
$      db.server.session.wait_sample:
$        enabled: true
$      db.server.top_procedure:
$        enabled: true
$      db.server.query_plan:
$        enabled: true
$
$    top_query_collection:
$      max_query_sample_count: 1000
$      top_query_count: 200
$      collection_interval: 60s
$      allowed_comment_keys:
$        - nr_service_guid
$
$    query_sample_collection:
$      max_rows_per_query: 100
$      allowed_comment_keys:
$        - nr_service_guid
$
$    session_wait_event_collection:
$      max_rows_per_query: 100
$
$    top_procedure_collection:
$      max_procedure_sample_count: 1000
$      top_procedure_count: 250
$      collection_interval: 60s
$
$    # Metrics configuration - This baseline configuration captures essential metrics. To enable advanced monitoring and extended telemetry, refer to the full configuration documentation
$    metrics:
$      oracledb.buffer_cache.utilization:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.consistent_gets:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.cpu_time:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.database.cpu.utilization:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.database.wait.utilization:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.db_block_gets:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.enqueue_deadlocks:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.execution.utilization:
$        enabled: true
$        attributes:
$          - oracledb.parse.type
$          - oracle.db.pdb
$      oracledb.executions:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.hard_parses:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.host.cpu.utilization:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.library_cache.utilization:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.logical_reads:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.logons:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.parse.rate:
$        enabled: true
$        attributes:
$          - oracledb.parse.result
$          - oracle.db.pdb
$      oracledb.parse_calls:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.pga_memory:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.physical_io.requests:
$        enabled: true
$        attributes:
$          - disk.io.direction
$          - disk.io.block_size
$          - oracle.db.pdb
$      oracledb.physical_reads:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.physical_writes:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.processes.usage:
$        enabled: true
$      oracledb.sessions.usage:
$        enabled: true
$        attributes:
$          - session_type
$          - session_status
$          - oracle.db.pdb
$      oracledb.sga.usage:
$        enabled: true
$        attributes:
$          - oracledb.sga.component.name
$      oracledb.shared_pool.utilization:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.sql_service.response.duration:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.sqlnet.io.transferred:
$        enabled: true
$        attributes:
$          - network.io.direction
$          - destination.type
$          - oracle.db.pdb
$      oracledb.tablespace_size.usage:
$        enabled: true
$        attributes:
$          - tablespace_name
$          - oracle.db.pdb
$      oracledb.transactions.usage:
$        enabled: true
$      oracledb.user_commits:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.user_rollbacks:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$
$    # Resource attributes attached to all metrics/logs (all enabled by default)
$    resource_attributes:
$      oracle.db.edition:
$        enabled: true
$
$exporters:
$  otlp/newrelic:
$    endpoint: "<YOUR_NEWRELIC_OTLP_ENDPOINT>"
$    headers:
$      api-key: "<YOUR_NEWRELIC_LICENSE_KEY>"
$    compression: gzip
$    retry_on_failure:
$      enabled: true
$      initial_interval: 5s
$      max_interval: 30s
$      max_elapsed_time: 300s
$    sending_queue:
$      enabled: true
$      sizer: bytes
$      queue_size: 100_000_000
$      num_consumers: 10
$      batch:
$        sizer: bytes
$        max_size: 1_000_000
$        min_size: 0
$        flush_timeout: 5s
$
$service:
$  pipelines:
$    metrics/oracledb:
$      receivers: [nroracledb]
$      exporters: [otlp/newrelic]
$    logs/oracledb:
$      receivers: [nroracledb]
$      exporters: [otlp/newrelic]
$EOF

Parámetro de configuración

Parámetro	Descripción
`<YOUR_ORACLE_CONTAINER_NAME>`	El nombre (o nombre de host de Docker que se puede resolver mediante DNS) del contenedor de base de datos Oracle en ejecución.
`<YOUR_DB_USERNAME>`	El usuario de monitoreo que creó en Configurar el usuario de la base de datos y otorgar privilegios (el prefijo `C##` se agrega automáticamente para CDB).
`<YOUR_DB_PASSWORD>`	La contraseña del usuario de monitoreo que creó en Configurar el usuario de la base de datos y otorgar privilegios.
`<YOUR_CDB_SERVICE_NAME>` / `<YOUR_PDB_SERVICE_NAME>`	El nombre del servicio de Oracle para la CDB o PDB.
`<YOUR_NEWRELIC_OTLP_ENDPOINT>`	El extremo OTLP de New Relic. Para obtener más información, consulte Extremos OTLP de New Relic.
`<YOUR_NEWRELIC_LICENSE_KEY>`	Su clave de licencia de New Relic.

Iniciar el contenedor del NRDOT Collector

Ejecute el recolector en la misma red de Docker que el contenedor de Oracle:

bash

$docker run -d \
>  --name nrdot-collector \
>  --network <YOUR_DOCKER_NETWORK> \
>  --platform linux/amd64 \
>  -v "$PWD/oracle-config.yaml:/etc/nrdot-collector/oracle-config.yaml" \
>  newrelic/nrdot-collector:latest \
>  --config /etc/nrdot-collector/oracle-config.yaml

Sugerencia

--platform linux/amd64 evita incompatibilidades de arquitectura en Apple Silicon y otros hosts ARM64 donde la propia imagen de Oracle normalmente solo se distribuye para AMD64. Omítalo si el host y las imágenes ya son nativos de AMD64.

Confirme que el contenedor del recolector se esté ejecutando:

bash

$docker ps --filter name=nrdot-collector

Si no se está ejecutando, revise sus logs en busca de errores. Las causas más comunes son problemas de indentación de YAML en oracle-config.yaml o un contenedor Oracle inalcanzable:

bash

$docker logs nrdot-collector

Sugerencia

Después de cambiar oracle-config.yaml, reinicie el contenedor para aplicar los cambios:

bash

$docker restart nrdot-collector

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.

Monitoreo de CDB en el host

Aprenda a instalar y configurar NRDOT Collector para el monitoreo de la base de datos de contenedores de Oracle en el host.

Monitoreo de PDB en el host

Aprenda a instalar y configurar el NRDOT Collector para el monitoreo de la base de datos conectable de Oracle en el host.

Instalación con Ansible

Aprenda a instalar y configurar el monitoreo de base de datos Oracle a escala con newrelic.newrelic_install rol de Ansible.

Instalación con Chef

Aprenda a instalar y configurar el monitoreo de la base de datos Oracle a escala con el cookbook newrelic-install de Chef.

Instalación del chart de Helm

Aprenda a instalar y configurar el monitoreo de la base de datos de Oracle en Kubernetes con el chart de Helm.

Resolución de problemas

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

Referencia de métricas

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

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

Instalar y configurar NRDOT para el monitoreo de Oracle con Docker

Instalación guiada

Sugerencia

Requisitos previos

Configurar el usuario de la base de datos y otorgar privilegios

Base de datos de contenedor (CDB)

Sugerencia

Base de datos conectable (PDB)

Sugerencia

Sugerencia

Asegurar la conectividad de red de Docker

Sugerencia

Crear la configuración del Collector NRDOT

Configuración de la base de datos de contenedor (CDB)

configuración completa

Configuración de la base de datos conectable (PDB)

configuración completa

Parámetro de configuración

Iniciar el contenedor del NRDOT Collector

Sugerencia

Sugerencia

Encuentra y utiliza tus datos

Monitoreo de CDB en el host

Monitoreo de PDB en el host

Instalación con Ansible

Instalación con Chef

Instalación del chart de Helm

Resolución de problemas

Referencia de métricas

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

Instalar y configurar NRDOT para el monitoreo de Oracle con Docker

Instalación guiada

Sugerencia

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

Configurar el usuario de la base de datos y otorgar privilegios

Base de datos conectable (PDB)

Asegurar la conectividad de red de Docker

Sugerencia

Crear la configuración del Collector NRDOT

Configuración de la base de datos de contenedor (CDB)

Configuración de la base de datos conectable (PDB)

Parámetro de configuración

Iniciar el contenedor del NRDOT Collector

Sugerencia

Sugerencia

Encuentra y utiliza tus datos

Artículos relacionados

Monitoreo de CDB en el host

Monitoreo de PDB en el host

Instalación con Ansible

Instalación con Chef

Instalación del chart de Helm

Resolución de problemas

Referencia de métricas

Requisitos previos