Oracle Database

Supported OS Linux Windows Mac OS

Dashboard de Oracle

Información general

La integración de Oracle proporciona métricas del estado y el rendimiento de tu base de datos de Oracle casi en tiempo real. Visualiza estas métricas con el dashboard proporcionado y crea monitores para alertar a tu equipo sobre los estados de base de datos de Oracle.

Activa la Monitorización de base de datos (DBM) para obtener información mejorada sobre el rendimiento de las consultas y el estado de la base de datos. Además de las funciones estándar de integración, Datadog DBM proporciona métricas a nivel de consulta, snapshots de consultas en tiempo real e históricas, análisis de evento de espera, carga de la base de datos, planes de explicación de consultas e información de consultas de bloqueo.

Configuración

Instalación

Requisito previo

Para utilizar la integración de Oracle, puedes utilizar el cliente nativo (no requiere pasos adicionales de instalación) o Oracle Instant Client.

Oracle Instant Client

Omite este paso si no utilizas Instant Client.

Linux

Sigue las instrucciones de Instalación de Oracle Instant Client para Linux.
Comprueba que el paquete Instant Client Basic está instalado. Encuéntralo en la página de descargas de Oracle.
Una vez instaladas las bibliotecas de Instant Client, asegúrate de que el enlazador de tiempo de ejecución pueda encontrar las bibliotecas, por ejemplo:
```
# Put the library location in the /etc/datadog-agent/environment file.

echo "LD_LIBRARY_PATH=/u01/app/oracle/product/instantclient_19" \
>> /etc/datadog-agent/environment
```

Windows

Sigue la Guía de instalación de Oracle Windows para configurar tu Oracle Instant Client.
Verifica lo siguiente:
- Se ha instalado Microsoft Visual Studio 2017 Redistributable o la versión adecuada para Oracle Instant Client.
- El paquete Instant Client Basic de la página de descargas de Oracle está instalado y disponible para todos los usuarios de la máquina en cuestión (por ejemplo, C:\oracle\instantclient_19).
- La variable de entorno PATH contiene el directorio con el Instant Client (por ejemplo, C:\oracle\instantclient_19).

Creación de usuarios de Datadog

Multiinquilino

Crear usuario

Crea un inicio de sesión de solo lectura para conectarte a tu servidor y concede los permisos necesarios:

CREATE USER c##datadog IDENTIFIED BY &password CONTAINER = ALL ;

ALTER USER c##datadog SET CONTAINER_DATA=ALL CONTAINER=CURRENT;

Conceder permisos

Inicia sesión como sysdba y concede los siguientes permisos:

grant create session to c##datadog ;
grant select on v_$session to c##datadog ;
grant select on v_$database to c##datadog ;
grant select on v_$containers to c##datadog;
grant select on v_$sqlstats to c##datadog ;
grant select on v_$instance to c##datadog ;
grant select on dba_feature_usage_statistics to c##datadog ;
grant select on V_$SQL_PLAN_STATISTICS_ALL to c##datadog ;
grant select on V_$PROCESS to c##datadog ;
grant select on V_$SESSION to c##datadog ;
grant select on V_$CON_SYSMETRIC to c##datadog ;
grant select on CDB_TABLESPACE_USAGE_METRICS to c##datadog ;
grant select on CDB_TABLESPACES to c##datadog ;
grant select on V_$SQLCOMMAND to c##datadog ;
grant select on V_$DATAFILE to c##datadog ;
grant select on V_$SYSMETRIC to c##datadog ;
grant select on V_$SGAINFO to c##datadog ;
grant select on V_$PDBS to c##datadog ;
grant select on CDB_SERVICES to c##datadog ;
grant select on V_$OSSTAT to c##datadog ;
grant select on V_$PARAMETER to c##datadog ;
grant select on V_$SQLSTATS to c##datadog ;
grant select on V_$CONTAINERS to c##datadog ;
grant select on V_$SQL_PLAN_STATISTICS_ALL to c##datadog ;
grant select on V_$SQL to c##datadog ;
grant select on V_$PGASTAT to c##datadog ;
grant select on v_$asm_diskgroup to c##datadog ;
grant select on v_$rsrcmgrmetric to c##datadog ;
grant select on v_$dataguard_config to c##datadog ;
grant select on v_$dataguard_stats to c##datadog ;
grant select on v_$transaction to c##datadog;
grant select on v_$locked_object to c##datadog;
grant select on dba_objects to c##datadog;
grant select on cdb_data_files to c##datadog;
grant select on dba_data_files to c##datadog;

Si has configurado consultas personalizadas que se ejecutan en una base de datos conectable (PDB), debes conceder el privilegio set container al usuario C##DATADOG:

connect / as sysdba
alter session set container = your_pdb ;
grant set container to c##datadog ;

Sin CDB

Crear usuario

Crea un inicio de sesión de solo lectura para conectarte a tu servidor y concede los permisos necesarios:

CREATE USER datadog IDENTIFIED BY &password ;

Conceder permisos

Inicia sesión como sysdba y concede los siguientes permisos:

grant create session to datadog ;
grant select on v_$session to datadog ;
grant select on v_$database to datadog ;
grant select on v_$containers to datadog;
grant select on v_$sqlstats to datadog ;
grant select on v_$instance to datadog ;
grant select on dba_feature_usage_statistics to datadog ;
grant select on V_$SQL_PLAN_STATISTICS_ALL to datadog ;
grant select on V_$PROCESS to datadog ;
grant select on V_$SESSION to datadog ;
grant select on V_$CON_SYSMETRIC to datadog ;
grant select on CDB_TABLESPACE_USAGE_METRICS to datadog ;
grant select on CDB_TABLESPACES to datadog ;
grant select on V_$SQLCOMMAND to datadog ;
grant select on V_$DATAFILE to datadog ;
grant select on V_$SYSMETRIC to datadog ;
grant select on V_$SGAINFO to datadog ;
grant select on V_$PDBS to datadog ;
grant select on CDB_SERVICES to datadog ;
grant select on V_$OSSTAT to datadog ;
grant select on V_$PARAMETER to datadog ;
grant select on V_$SQLSTATS to datadog ;
grant select on V_$CONTAINERS to datadog ;
grant select on V_$SQL_PLAN_STATISTICS_ALL to datadog ;
grant select on V_$SQL to datadog ;
grant select on V_$PGASTAT to datadog ;
grant select on v_$asm_diskgroup to datadog ;
grant select on v_$rsrcmgrmetric to datadog ;
grant select on v_$dataguard_config to datadog ;
grant select on v_$dataguard_stats to datadog ;
grant select on v_$transaction to datadog;
grant select on v_$locked_object to datadog;
grant select on dba_objects to datadog;
grant select on cdb_data_files to datadog;
grant select on dba_data_files to datadog;

RDS

Crear usuario

Crea un inicio de sesión de solo lectura para conectarte a tu servidor y concede los permisos necesarios:

CREATE USER datadog IDENTIFIED BY your_password ;

Conceder permisos

grant create session to datadog ;
exec rdsadmin.rdsadmin_util.grant_sys_object('V_$SESSION','DATADOG','SELECT',p_grant_option => false); 
exec rdsadmin.rdsadmin_util.grant_sys_object('V_$DATABASE','DATADOG','SELECT',p_grant_option => false); 
exec rdsadmin.rdsadmin_util.grant_sys_object('V_$CONTAINERS','DATADOG','SELECT',p_grant_option => false); 
exec rdsadmin.rdsadmin_util.grant_sys_object('V_$SQLSTATS','DATADOG','SELECT',p_grant_option => false); 
exec rdsadmin.rdsadmin_util.grant_sys_object('V_$SQL','DATADOG','SELECT',p_grant_option => false); 
exec rdsadmin.rdsadmin_util.grant_sys_object('V_$INSTANCE','DATADOG','SELECT',p_grant_option => false); 
exec rdsadmin.rdsadmin_util.grant_sys_object('V_$SQL_PLAN_STATISTICS_ALL','DATADOG','SELECT',p_grant_option => false); 
exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_FEATURE_USAGE_STATISTICS','DATADOG','SELECT',p_grant_option => false); 
exec rdsadmin.rdsadmin_util.grant_sys_object('V_$PROCESS','DATADOG','SELECT',p_grant_option => false); 
exec rdsadmin.rdsadmin_util.grant_sys_object('V_$SESSION','DATADOG','SELECT',p_grant_option => false); 
exec rdsadmin.rdsadmin_util.grant_sys_object('V_$CON_SYSMETRIC','DATADOG','SELECT',p_grant_option => false); 
exec rdsadmin.rdsadmin_util.grant_sys_object('CDB_TABLESPACE_USAGE_METRICS','DATADOG','SELECT',p_grant_option => false); 
exec rdsadmin.rdsadmin_util.grant_sys_object('CDB_TABLESPACES','DATADOG','SELECT',p_grant_option => false); 
exec rdsadmin.rdsadmin_util.grant_sys_object('V_$SQLCOMMAND','DATADOG','SELECT',p_grant_option => false);
exec rdsadmin.rdsadmin_util.grant_sys_object('V_$DATAFILE','DATADOG','SELECT',p_grant_option => false);
exec rdsadmin.rdsadmin_util.grant_sys_object('V_$SGAINFO','DATADOG','SELECT',p_grant_option => false);
exec rdsadmin.rdsadmin_util.grant_sys_object('V_$SYSMETRIC','DATADOG','SELECT',p_grant_option => false);
exec rdsadmin.rdsadmin_util.grant_sys_object('V_$PDBS','DATADOG','SELECT',p_grant_option => false);
exec rdsadmin.rdsadmin_util.grant_sys_object('CDB_SERVICES','DATADOG','SELECT',p_grant_option => false);
exec rdsadmin.rdsadmin_util.grant_sys_object('V_$OSSTAT','DATADOG','SELECT',p_grant_option => false);
exec rdsadmin.rdsadmin_util.grant_sys_object('V_$PARAMETER','DATADOG','SELECT',p_grant_option => false);
exec rdsadmin.rdsadmin_util.grant_sys_object('V_$SQLSTATS','DATADOG','SELECT',p_grant_option => false);
exec rdsadmin.rdsadmin_util.grant_sys_object('V_$CONTAINERS','DATADOG','SELECT',p_grant_option => false);
exec rdsadmin.rdsadmin_util.grant_sys_object('V_$SQL_PLAN_STATISTICS_ALL','DATADOG','SELECT',p_grant_option => false);
exec rdsadmin.rdsadmin_util.grant_sys_object('V_$SQL','DATADOG','SELECT',p_grant_option => false);
exec rdsadmin.rdsadmin_util.grant_sys_object('V_$PGASTAT','DATADOG','SELECT',p_grant_option => false);
exec rdsadmin.rdsadmin_util.grant_sys_object('V_$ASM_DISKGROUP','DATADOG','SELECT',p_grant_option => false);
exec rdsadmin.rdsadmin_util.grant_sys_object('V_$RSRCMGRMETRIC','DATADOG','SELECT',p_grant_option => false);
exec rdsadmin.rdsadmin_util.grant_sys_object('V_$DATAGUARD_CONFIG','DATADOG','SELECT',p_grant_option => false);
exec rdsadmin.rdsadmin_util.grant_sys_object('V_$DATAGUARD_STATS','DATADOG','SELECT',p_grant_option => false);
exec rdsadmin.rdsadmin_util.grant_sys_object('V_$TRANSACTION','DATADOG','SELECT',p_grant_option => false);
exec rdsadmin.rdsadmin_util.grant_sys_object('V_$LOCKED_OBJECT','DATADOG','SELECT',p_grant_option => false);
exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_OBJECTS','DATADOG','SELECT',p_grant_option => false);
exec rdsadmin.rdsadmin_util.grant_sys_object('CDB_DATA_FILES','DATADOG','SELECT',p_grant_option => false);
exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_DATA_FILES','DATADOG','SELECT',p_grant_option => false);

Oracle Autonomous Database

Crear usuario

Crea un inicio de sesión de solo lectura para conectarte a tu servidor y concede los permisos necesarios:

CREATE USER datadog IDENTIFIED BY your_password ;

Conceder permisos

grant create session to datadog ;
grant select on v$session to datadog ;
grant select on v$database to datadog ;
grant select on v$containers to datadog;
grant select on v$sqlstats to datadog ;
grant select on v$instance to datadog ;
grant select on dba_feature_usage_statistics to datadog ;
grant select on V$SQL_PLAN_STATISTICS_ALL to datadog ;
grant select on V$PROCESS to datadog ;
grant select on V$SESSION to datadog ;
grant select on V$CON_SYSMETRIC to datadog ;
grant select on CDB_TABLESPACE_USAGE_METRICS to datadog ;
grant select on CDB_TABLESPACES to datadog ;
grant select on V$SQLCOMMAND to datadog ;
grant select on V$DATAFILE to datadog ;
grant select on V$SYSMETRIC to datadog ;
grant select on V$SGAINFO to datadog ;
grant select on V$PDBS to datadog ;
grant select on CDB_SERVICES to datadog ;
grant select on V$OSSTAT to datadog ;
grant select on V$PARAMETER to datadog ;
grant select on V$SQLSTATS to datadog ;
grant select on V$CONTAINERS to datadog ;
grant select on V$SQL_PLAN_STATISTICS_ALL to datadog ;
grant select on V$SQL to datadog ;
grant select on V$PGASTAT to datadog ;
grant select on v$asm_diskgroup to datadog ;
grant select on v$rsrcmgrmetric to datadog ;
grant select on v$dataguard_config to datadog ;
grant select on v$dataguard_stats to datadog ;
grant select on v$transaction to datadog;
grant select on v$locked_object to datadog;
grant select on dba_objects to datadog;
grant select on cdb_data_files to datadog;
grant select on dba_data_files to datadog;

Configuración

Para configurar este check para un Agent que se ejecuta en un host:

Edita el archivo oracle.d/conf.yaml, en la carpeta conf.d/ en la raíz de tu directorio de configuración del Agent. Actualiza server y port para establecer el nodo maestro a monitorizar. Consulta el oracle.d/conf.yaml de ejemplo para conocer todas las opciones disponibles de configuración.

init_config:

instances:
   ## @param server - string - required
   ## The IP address or hostname of the Oracle Database Server.
   #
   - server: localhost:1521

     ## @param service_name - string - required
     ## The Oracle Database service name. To view the services available on your server,
     ## run the following query: `SELECT value FROM v$parameter WHERE name='service_names'`
     #
     service_name: <SERVICE_NAME>

     ## @param username - string - required
     ## The username for the Datadog user account.
     #
     username: <USERNAME>

     ## @param password - string - required
     ## The password for the Datadog user account.
     #
     password: <PASSWORD>

Nota: Para las versiones del Agent comprendidas entre 7.50.1 (incluido) y 7.53.0 (excluido), el subdirectorio de configuración es oracle-dbm.d. Para todas las demás versiones del Agent, el directorio de configuración es oracle.d.

Nota: Los clientes de Oracle Real Application Cluster (RAC) deben configurar el Agent para cada nodo RAC, porque el Agent recopila información de cada nodo por separado consultando las vistas V$. El Agent no consulta ninguna vista GV$ para evitar generar tráfico de interconexión.

Reinicia el Agent.

Conexión a Oracle a través de TCPS

Para conectarte a Oracle a través de TCPS (TCP con SSL), elimina los comentarios de la opción de configuración protocol y selecciona TCPS. Actualiza la opción server para establecer el servidor TCPS a monitorizar.

```yaml
init_config:

instances:
  ## @param server - string - required
  ## L dirección IP o el nombre de host del Oracle Database Server.
  #
  - server: localhost:1522

    ## @param service_name - string - required
    ## El nombre de servicio de Oracle Database. Para ver los servicios disponibles en tu servidor,
    ## ejecuta la siguiente consulta:
    #
    service_name: "<SERVICE_NAME>"

    ## @param username - string - required
    ## El nombre de usuario de la cuenta de usuario.
    #
    username: <USER>

    ## @param password - string - required
    ## La contraseña para la cuenta de usuario.
    #
    password: "<PASSWORD>"

    ## @param protocol - string - optional - default: TCP
    ## El protocolo para conectarte al Oracle Database Server. Los protocolos válids son TCP y TCPS.
    ##
    #
    protocol: TCPS
```

Validación

Ejecuta el subcomando de estado del Agent y busca oracle en la sección Checks.

Consulta personalizada

También es posible realizar consultas personalizadas. Cada consulta debe tener dos parámetros:

Parámetro Descripción

query Este es el SQL a ejecutar. Puede ser una sentencia simple o un script de varias líneas. Se evalúan todas las filas del resultado.

columns Se trata de una lista que representa cada columna, ordenada secuencialmente de izquierda a derecha. Hay dos datos obligatorios:
a. type: es el método de envío (gauge, count, etc.).
b. name (nombre): es el sufijo utilizado para formar el nombre completo de la métrica. Si type es tag, esta columna se considera una etiqueta que se aplica a cada métrica recopilada por esta consulta en particular.

Parámetro	Descripción
`query`	Este es el SQL a ejecutar. Puede ser una sentencia simple o un script de varias líneas. Se evalúan todas las filas del resultado.
`columns`	Se trata de una lista que representa cada columna, ordenada secuencialmente de izquierda a derecha. Hay dos datos obligatorios: a. `type`: es el método de envío (`gauge`, `count`, etc.). b. name (nombre): es el sufijo utilizado para formar el nombre completo de la métrica. Si `type` es `tag`, esta columna se considera una etiqueta que se aplica a cada métrica recopilada por esta consulta en particular.

Opcionalmente, utiliza el parámetro tags para aplicar una lista de etiquetas a cada métrica recopilada.

Lo siguiente:

self.gauge('oracle.custom_query.metric1', value, tags=['tester:oracle', 'tag1:value'])
self.count('oracle.custom_query.metric2', value, tags=['tester:oracle', 'tag1:value'])

es en lo que se convertiría el siguiente ejemplo de configuración:

- query: | # Usa el pipe si necesitas un script de múltiples líneas.
    SELECT columns
    FROM tester.test_table
    WHERE conditions
  columns:
    # Coloca esto en cualquier columna que deseas omitir:
    - {}
    - name: metric1
      type: gauge
    - name: tag1
      type: tag
    - name: metric2
      type: count
  tags:
    - tester:oracle

Consulta el oracle.d/conf.yaml de ejemplo para ver todas las opciones disponibles de configuración.

Datos recopilados

Métricas

oracle.active_sessions (gauge)	number of active sessions
oracle.buffer_cachehit_ratio (gauge)	Ratio of buffer cache hits Shown as percent
oracle.cache_blocks_corrupt (gauge)	corrupt cache blocks Shown as block
oracle.cache_blocks_lost (gauge)	lost cache blocks Shown as block
oracle.cursor_cachehit_ratio (gauge)	Ratio of cursor cache hits Shown as percent
oracle.database_wait_time_ratio (gauge)	memory sorts per second Shown as percent
oracle.disk_sorts (gauge)	disk sorts per second Shown as operation
oracle.enqueue_timeouts (gauge)	enqueue timeouts per sec Shown as timeout
oracle.gc_cr_block_received (gauge)	GC CR block received Shown as block
oracle.library_cachehit_ratio (gauge)	Ratio of library cache hits Shown as percent
oracle.logons (gauge)	number of logon attempts
oracle.long_table_scans (gauge)	number of long table scans per sec Shown as scan
oracle.memory_sorts_ratio (gauge)	memory sorts ratio Shown as percent
oracle.physical_reads (gauge)	physical reads per sec Shown as read
oracle.physical_writes (gauge)	physical writes per sec Shown as write
oracle.process.pga_allocated_memory (gauge)	PGA memory allocated by process Shown as byte
oracle.process.pga_freeable_memory (gauge)	PGA memory freeable by process Shown as byte
oracle.process.pga_maximum_memory (gauge)	PGA maximum memory ever allocated by process Shown as byte
oracle.process.pga_used_memory (gauge)	PGA memory used by process Shown as byte
oracle.rows_per_sort (gauge)	rows per sort Shown as row
oracle.service_response_time (gauge)	service response time Shown as second
oracle.session_count (gauge)	session count
oracle.session_limit_usage (gauge)	session limit usage Shown as percent
oracle.shared_pool_free (gauge)	shared pool free memory % Shown as percent
oracle.sorts_per_user_call (gauge)	sorts per user call
oracle.tablespace.in_use (gauge)	tablespace in-use Shown as percent
oracle.tablespace.offline (gauge)	tablespace offline
oracle.tablespace.size (gauge)	tablespace size Shown as byte
oracle.tablespace.used (gauge)	tablespace used Shown as byte
oracle.temp_space_used (gauge)	temp space used Shown as byte
oracle.user_rollbacks (gauge)	number of user rollbacks Shown as operation

Eventos

El check de Oracle Database no incluye ningún evento.

Checks de servicio

oracle.can_connect
Returns OK if the integration can connect to the oracle database, CRITICAL otherwise
Statuses: ok, critical

oracle.can_query
Returns OK if the integration can run all the queries, CRITICAL otherwise
Statuses: ok, critical

Solucionar problemas

¿Necesitas ayuda? Ponte en contacto con el soporte de Datadog.