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

2. Comprueba lo siguiente:

   • Que los paquetes Instant Client Basic y SDK estén instalados. Encuéntralos en la página de descargas de Oracle.

     Una vez instaladas las bibliotecas de Instant Client, asegúrate de que el enlazador en tiempo de ejecución pueda encontrar las bibliotecas. Por ejemplo, utiliza ldconfig:

     # Put the library location in an ld configuration file.
     
     sudo sh -c "echo /usr/lib/oracle/12.2/client64/lib > \
         /etc/ld.so.conf.d/oracle-instantclient.conf"
     
     # Update the bindings.
     
     sudo ldconfig
     

   • Ambos paquetes se descomprimen en un único directorio que está disponible para todos los usuarios de la máquina en cuestión (por ejemplo, /opt/oracle):

     mkdir -p /opt/oracle/ && cd /opt/oracle/
     unzip /opt/oracle/instantclient-basic-linux.x64-12.1.0.2.0.zip
     unzip /opt/oracle/instantclient-sdk-linux.x64-12.1.0.2.0.zip
     

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

2. Comprueba lo siguiente:

   • Que se haya instalado Microsoft Visual Studio 2017 Redistributable o la versión adecuada para Oracle Instant Client.

   • Que se instalen los paquetes Instant Client Basic y SDK de la [página de descargas][18] de Oracle.

   • Que ambos paquetes se extraigan en un único directorio que está disponible para todos los usuarios de la máquina en cuestión (por ejemplo, C:\oracle).

Crea un usuario de datadog de sólo lectura con acceso adecuado a tu servidor de la base de datos de Oracle. Conéctate a tu base de datos de Oracle con un usuario administrativo, como SYSDBA o SYSOPER, y ejecuta:

-- Enable Oracle Script.
ALTER SESSION SET "_ORACLE_SCRIPT"=true;

-- Create the datadog user. Replace the password placeholder with a secure password.
CREATE USER datadog IDENTIFIED BY <PASSWORD>;

-- Grant access to the datadog user.
GRANT CONNECT TO datadog;
GRANT SELECT ON GV_$PROCESS TO datadog;
GRANT SELECT ON gv_$sysmetric TO datadog;
GRANT SELECT ON sys.dba_data_files TO datadog;
GRANT SELECT ON sys.dba_tablespaces TO datadog;
GRANT SELECT ON sys.dba_tablespace_usage_metrics TO datadog;

Nota: Si estás utilizando Oracle 11g, no es necesario ejecutar la siguiente línea:

ALTER SESSION SET "_ORACLE_SCRIPT"=true;

Oracle 12c o 19c

Loguea en la base de datos raíz como administrador para crear un usuario datadog y conceder permisos:

alter session set container = cdb$root;
CREATE USER c##datadog IDENTIFIED BY password CONTAINER=ALL;
GRANT CREATE SESSION TO c##datadog CONTAINER=ALL;
Grant select any dictionary to c##datadog container=all;
GRANT SELECT ON GV_$PROCESS TO c##datadog CONTAINER=ALL;
GRANT SELECT ON gv_$sysmetric TO c##datadog CONTAINER=ALL;

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 la configuración del Agent. Actualiza server y port para configurar los administradores en el monitor. 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>
   

2. Reinicia el Agent.

Sólo consultas personalizadas

Para omitir checks de métricas predeterminados para una instancia y sólo ejecutar consultas personalizadas con un usuario recopilador de métricas existente, inserta la etiqueta (tag) only_custom_queries con un valor de true. Esto permite que una instancia configurada de la integración de Oracle evite que se ejecuten las métricas del sistema, del proceso y del espacio de tablas y permite que se ejecuten consultas personalizadas sin tener los permisos descritos en la sección Creación de usuario de Datadog. Si se omite esta entrada de configuración, el usuario que se especifique debe tener esos permisos de tabla para ejecutar una consulta personalizada.

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 user account.
    #
    username: <USER>

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

    ## @param only_custom_queries - string - optional
    ## Set this parameter to any value if you want to only run custom
    ## queries for this instance.
    #
    only_custom_queries: true

Conexión a Oracle a través de TCPS

1. Para conectarte a Oracle a través de TCPS (TCP con SSL), quita la marca de comentario de la opción de configuración protocol y selecciona TCPS. Actualiza la opción server para configurar el servidor TCPS en el monitor.

   init_config:
   
   instances:
     ## @param server - string - required
     ## The IP address or hostname of the Oracle Database Server.
     #
     - server: localhost:1522
   
       ## @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 user account.
       #
       username: <USER>
   
       ## @param password - string - required
       ## The password for the user account.
       #
       password: "<PASSWORD>"
   
       ## @param protocol - string - optional - default: TCP
       ## The protocol to connect to the Oracle Database Server. Valid protocols include TCP and TCPS.
       ##
       ## When connecting to Oracle Database via JDBC, `jdbc_truststore` and `jdbc_truststore_type` are required.
       ## More information can be found from Oracle Database's whitepaper:
       ##
       ## https://www.oracle.com/technetwork/topics/wp-oracle-jdbc-thin-ssl-130128.pdf
       #
       protocol: TCPS
   

2. Actualiza sqlnet.ora, listener.ora y tnsnames.ora para permitir conexiones a TCPS en tu base de datos de Oracle.

TCPS a través de Oracle sin JDBC

Si no utilizas JDBC, comprueba que el Datadog Agent pueda conectarse a tu base de datos. Utiliza la herramienta de línea de comandos sqlplus con la información introducida en tus opciones de configuración:

sqlplus <USER>/<PASSWORD>@(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCPS)(HOST=<HOST>)(PORT=<PORT>))(SERVICE_NAME=<SERVICE_NAME>)))

Cuando utilices la conexión a Oracle Instant Client, mueve tres archivos al directorio network/admin de las bibliotecas del cliente utilizadas por tu aplicación:

• tnsnames.ora: Asigna los nombres de servicios de red utilizados para las cadenas de conexión de la aplicación a tus servicios de la base de datos.
• sqlnet.ora: Configura los parámetros de la red de Oracle.
• cwallet.sso: Activa las conexiones SSL o TLS. Mantén este archivo seguro.

TCPS a través de JDBC

Si te conectas a la base de datos de Oracle mediante JDBC, también deberás especificar jdbc_truststore_path, jdbc_truststore_type y jdbc_truststore_password (opcional) si existe una contraseña en el almacén de confianza.

Nota: Los almacenes de confianza de SSO no requieren contraseñas.

    # In the `instances:` section
    ...

    ## @param jdbc_truststore_path - string - optional
    ## The JDBC truststore file path.
    #
    jdbc_truststore_path: /path/to/truststore

    ## @param jdbc_truststore_type - string - optional
    ## The JDBC truststore file type. Supported truststore types include JKS, SSO, and PKCS12.
    #
    jdbc_truststore_type: SSO

    ## @param jdbc_truststore_password - string - optional
    ## The password for the truststore when connecting via JDBC.
    #
    # jdbc_truststore_password: <JDBC_TRUSTSTORE_PASSWORD>

Para obtener más información sobre la conexión a la base de datos de Oracle a través de TCPS en JDBC, consulta el documento de Oracle oficial.

Para entornos con contenedores, consulta las Plantillas de integración de Autodiscovery para obtener orientación sobre la aplicación de los parámetros que se indican a continuación.