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

    1. Sigue las instrucciones de Instalación de Oracle Instant Client para Linux.

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

    1. Sigue la Guía de instalación de Oracle Windows para configurar tu Oracle Instant Client.

    2. 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:

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

      1. 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ámetroDescripción
      queryEste 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.
      columnsSe 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.asm_diskgroup.free_mb
      (gauge)      		The unused capacity of a disk group in megabytes, tagged by state (DBM only)
      oracle.asm_diskgroup.offline_disks
      (gauge)      		The number of disks in an ASM disk group that are offline, tagged by state (DBM only)
      oracle.asm_diskgroup.total_mb
      (gauge)      		The total usable capacity of the disk group, tagged by state (DBM only)
      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.