OCI QuickStart de Datadog es una experiencia de configuración totalmente gestionada y de flujo único que te ayuda a monitorizar tu infraestructura y aplicaciones de OCI en tan solo unos clics. OCI QuickStart crea la infraestructura necesaria para reenviar métricas, logs y datos de recursos a Datadog, y detecta automáticamente nuevos recursos o compartimentos de OCI para la recopilación de datos.

Notas:

• Por defecto solo se envían métricas. Habilita la recopilación de logs y la recopilación de datos de recursos desde el cuadro de integración de Datadog OCI después de completar esta configuración.
• Se admiten todas las regiones comerciales de OCI que existían el 15 de julio de 2025. Las regiones de OCI añadidas después de esta fecha no son compatibles actualmente.

Para configurar la infraestructura de reenvío de métricas y logs a Datadog:

• Configura el ícono de integración OCI de Datadog
• Despliega el stack tecnológico QuickStart
• Completa la configuración en Datadog
• Valida las métricas que fluyen
• Configura la recopilación de métricas (opcional)
• Configura la recopilación de logs (opcional)

La integración requiere el uso de Oracle Service Connector Hubs para reenviar datos a Datadog. Se recomienda solicitar un aumento del límite de servicio antes de completar la configuración. El número aproximado de Service Connector Hubs que necesitas es:

$$\text"Service Connector Hubs" = \text"Número de compartimentos en tenencia" / \text"5"$$

Ícono de integración de OCI de Datadog

1. Ve al cuadro de integración de Datadog OCI y haz clic en Add New Tenancy (Añadir nueva tenencia).
2. Selecciona o crea una clave de la API Datadog para utilizarla para la integración.
3. Crea una clave de la aplicación Datadog.
4. Haz clic en Crear stack tecnológico de OCI. Esto te llevará a un stack tecnológico de Oracle Resource Manager (ORM) para finalizar el despliegue.
   Nota: Despliega este stack tecnológico sólo una vez por tenencia.

Stack tecnológico de ORM

1. Acepta las Condiciones de uso de Oracle.
2. Deja sin marcar la opción de utilizar proveedores personalizados de Terraform.
3. Utiliza el directorio de trabajo predeterminado para desplegar el stack tecnológico u, opcionalmente, elige uno diferente.
4. Haz clic en Siguiente y Siguiente de nuevo.
   
5. Haz clic en Create (Crear) y espera hasta 15 minutos a que se complete el despliegue.

Completar la configuración en Datadog

Vuelve al cuadro de integración de Datadog OCI y haz clic en Ready! (¡Listo!).

Validación

Consulta las métricas de oci.* en el dashboard de información general de integración de OCI o la página del Metrics Explorer en Datadog.

Configuración

Una vez completada la configuración, aparecerá una pestaña de configuración para la tenencia en la parte izquierda del cuadro de integración de Datadog OCI. Aplica las configuraciones de recopilación de datos para toda la tenencia, tal y como se indica en las secciones siguientes.

Añadir regiones

En la pestaña General, selecciona las regiones para la recopilación de datos en la lista de casillas de verificación Regiones. Las selecciones de regiones se aplican a toda la tenencia, tanto para las métricas como para logs.

Nota: Si has utilizado el método de configuración QuickStart y después te has suscrito a una nueva región OCI, vuelve a aplicar el stack tecnológico de configuración inicial en ORM. La nueva región estará entonces disponible en el ícono de OCI de Datadog.

Recopilación de métricas y logs

Utiliza las pestañas Recopilación de métricas y Recopilación de logs para configurar qué métricas y logs se envían a Datadog:

• Activar o desactivar la recopilación de métricas o logs para toda la tenencia.
• Incluir o excluir compartimentos específicos basándose en las etiquetas (tags) de compartimentos del formato key:value. Por ejemplo:
  • datadog:monitored,env:prod* incluye compartimentos si alguna de estas etiquetas (tags) está presente
  • !env:staging,!testing excluye los compartimentos solo si ambas etiquetas están presentes
  • datadog:monitored,!region:us-phoenix-1 incluye los compartimentos que tienen la etiqueta (tag) datadog:monitored y los que no tienen la etiqueta (tag) region:us-phoenix-1
• Activar o desactivar la recopilación para servicios OCI específicos.

Notas:

• Tras modificar las etiquetas (tags) en OCI, los cambios pueden tardar hasta 15 minutos en aparecer en Datadog
• En OCI, las etiquetas (tags) no son heredadas por los compartimentos secundarios; cada compartimento se debe etiquetar individualmente.

Recopilación de recursos

En la pestaña Resource Collection (Recopilación de recursos) del cuadro de integración de Datadog OCI, haz clic en el conmutador Enable Resource Collection (Habilitar la recopilación de recursos). Los recursos son visibles en el Datadog Resource Catalog.

Para reenviar tus métricas de OCI a Datadog:

• Ingresa la información de la tenencia.
• [Despliega el stack tecnológico de políticas OCI (#create-oci-policy-stack) en la región de origen de tu tenencia para crear un usuario, grupo y políticas de sólo lectura en Datadog.
• Introduce DatadogROAuthUser info en Datadog
• [Despliega un stack tecnológico de reenvío de métricas OCI (#create-oci-metric-forwarding-stack) para cada región de tenencia desde la que desees reenviar métricas.
• Completa la configuración en Datadog
• Valida las métricas que fluyen
• Configura la recopilación de métricas (opcional)
• Configura la recopilación de logs (opcional)

Para ver una representación visual de esta arquitectura, consulta la sección Arquitectura.

Ingresar la información de la tenencia

Introduce el OCID y la región de origen de la tenencia que deseas monitorizar en el cuadro de integración de Datadog OCI.

• Encontrarás esta información en la página de Detalles de tenencia.
• Introduce la región de origen utilizando el valor Region Identifier (Identificador de región) de la página Regiones y dominios de disponibilidad de OCI.

Crear un stack tecnológico de políticas de OCI

Este stack tecnológico de políticas de Oracle Resource Manager (ORM) sólo debe desplegarse una vez por tenencia.

1. Haz clic en el botón Create Policy Stack (Crear un stack tecnológico de políticas) en el cuadro de integración de Datadog y OCI.
2. Acepta las Condiciones de uso de Oracle.
3. Deja la opción de utilizar proveedores de Terraform personalizados sin marcar.
4. Utiliza el nombre y el compartimento predeterminados para el stack tecnológico. De manera opcional, indica tu propio nombre descriptivo o compartimento.
5. Haz clic en Siguiente.
6. Deja el campo de tenencia y el campo de usuario actual como están.
7. Haz clic en Siguiente.
8. Haz clic en Create (Crear).

Introduce DatadogROAuthUser info

1. En la barra de búsqueda de la consola OCI, busca DatadogROAuthUser y haz clic en el recurso de Usuario que aparece.
2. Copia el valor del OCID del usuario.
3. Pega el valor en el campo User OCID (OCID de usuario) del cuadro de integración de Datadog OCI.
4. Al volver a la consola OCI, genera una clave de API con estos pasos:
   a. En la esquina inferior izquierda de la pantalla, en Recursos, haz clic en Claves de API.
   b. Haz clic en Añadir clave de API.
   c. Haz clic en Descargar clave privada.
   d. Haz clic en Añadir.
   e. Aparece una ventana emergente Configuration file preview (Vista previa del archivo de configuración), pero no es necesario realizar ninguna acción; cierra la ventana emergente.

5. Copia el valor de la huella dactilar y pégalo en el campo Fingerprint (Huella dactilar) del cuadro de integración de Datadog OCI.
6. Copia el valor de la clave privada con estos pasos: a. Abre el archivo de clave privada .pem descargado en un editor de texto, o utiliza un comando de terminal como cat para mostrar el contenido del archivo. b. Copia todo el contenido, incluidos -----BEGIN PRIVATE KEY----- y -----END PRIVATE KEY-----.
7. Pega el valor de la clave privada en el campo Private Key (Clave privada) del cuadro de integración de Datadog y OCI.

Crea un stack tecnológico de reenvío de métricas de OCI

El stack tecnológico de reenvío de métricas debe desplegarse para cada combinación de tenencia y región que se debe monitorizar. Para la configuración más sencilla, Datadog recomienda crear todos los recursos OCI necesarios con el stack tecnológico de Oracle Resource Manager (ORM) que se proporciona a continuación. Como alternativa, puedes utilizar tu infraestructura de red OCI existente.

Todos los recursos creados a partir del stack tecnológico de ORM de Datadog se despliegan en el compartimento especificado y para la región seleccionada actualmente en la parte superior derecha de la pantalla.

1. Haz clic en el botón Create Metric Stack (Crear un stack tecnológico de métricas) en el cuadro de integración de Datadog y OCI.
2. Acepta las Condiciones de uso de Oracle.
3. Deja sin marcar la opción Custom providers (Proveedores personalizados).
4. Asigna un nombre al stack tecnológico y selecciona el compartimento en el que se desplegará.
5. Haz clic en Siguiente.
6. En el campo Datadog API Key (Clave de API de Datadog), introduce el valor de tu clave de API de Datadog.
7. En la sección Network options (Opciones de red), deja marcada la opción Create VCN.

8. De manera opcional, en la sección Metrics settings (Parámetros de las métricas), elimina cualquier espacio de nombres de métrica de la recopilación.
9. En la sección Metrics compartments (Compartimentos de las métricas), ingresa una lista separada por comas de los OCID de compartimentos que se van a monitorizar. Los filtros de espacio de nombres de métrica seleccionados en el paso anterior se aplican a cada compartimento.
10. En la sección Configuración de funciones, selecciona GENERIC_ARM. Selecciona GENERIC_X86 si realizas el despliegue en una región de Japón.
11. Haz clic en Siguiente.
12. Haz clic en Create (Crear).
13. Vuelve al cuadro de integración de Datadog OCI y haz clic en Create Configuration (Crear configuración).

Notas:

• En forma predeterminada, sólo se selecciona el compartimento raíz y se activan todos los espacios de nombres de métricas del Paso 8 presentes en el compartimento (se admiten hasta 50 espacios de nombres por concentrador de conectores). Si eliges monitorizar compartimentos adicionales, los espacios de nombres añadidos a ellos son una intersección de los espacios de nombres seleccionados y los espacios de nombres presentes en el compartimento.
• Debes gestionar quién tiene acceso a los archivos de estado de Terraform de los stacks tecnológicos del gestor de recursos. Consulta la sección Archivos de estado de Terraform de la página del Securing Resource Manager para obtener más información.

1. Sigue los pasos de la sección de configuración para crear la infraestructura necesaria para reenviar las métricas y los logs a Datadog.
2. Haz clic en el conmutador Enable Log Collection (Habilitar recopilación de logs) de la pestaña Log Collection (Recopilación de logs) del cuadro de integración de Datadog OCI.

1. Configura un log de OCI.
2. Crea una función de OCI.
3. Configura un conector de servicio de OCI.

Las siguientes instrucciones utilizan el portal de OCI para configurar la integración.

Registro de OCI

1. En el portal de OCI, ve a Logging -> Log Groups (Registro > Grupos de logs).
2. Selecciona tu compartimento y haz clic en Crear un grupo de logs. Se abre un panel lateral.
3. Introduce data_log_group para el nombre y, opcionalmente, proporciona una descripción y etiquetas (tags).
4. Haz clic en Create (Crear) para configurar tu nuevo grupo de logs.
5. En Resources (Recursos), haz clic en Logs.
6. Haz clic en Create custom log (Crear log personalizado) o Enable service log (Habilitar log de servicio) según lo desees.
7. Haz clic en Enable Log (Habilitar log), para crear tu nuevo log de OCI.

Para obtener más información sobre los logs de OCI, consulta Activación del registro de un recurso.

Función de OCI

1. En el portal de OCI, ve a Functions* (Funciones).
2. Selecciona una aplicación existente o haz clic en Create Application (Crear aplicación).
3. Crea una nueva función de OCI dentro de tu aplicación. Consulta Información general de las funciones de Oracle para obtener más detalles.
4. Se recomienda crear primero una función boilerplate en Python y sustituir los archivos generados automáticamente por el código fuente de Datadog:
   • Sustituye func.py por código del repositorio de Datadog OCI
   • Sustituye func.yaml por el código del repositorio de Datadog OCI. DATADOG_TOKEN y DATADOG_HOST deben sustituirse por tu clave de API de Datadog y el enlace de admisión de logs de región.
   • Sustituye requirements.txt por el código del repositorio de Datadog OCI

Hub de conectores de servicio de OCI

1. En el portal de OCI, ve a Logging -> Service Connectors (Registro > Conectores de servicio).
2. Haz clic en Create Service Connector (Crear conector de servicio) para ser redireccionado a la página Create Service Connector (Crear conector de servicio).
3. Selecciona Source (Origen) como Logging (Registro) y Target (Destino) como Functions (Funciones).
4. En Configure Source Connection (Configurar conexión de origen) selecciona Compartment name (Nombre de compartimento), Log Group (Grupo de logs) y Log. (El Log Group (Grupo de logs) y Log creados en el primer paso).
5. Si también deseas enviar Audit Logs (Logs de auditoría), haz clic en +Another Log (+ otro log) y selecciona el mismo Compartment (Compartimento) y sustituye “_Audit” (_Auditoría") como tu Log Group (Grupo de logs).
6. En Configure target (Configurar destino) selecciona Compartment (Compartimento), Function application (Aplicación de función) y Function (Función). (La Function Application (Aplicación de función) y la Function (Función) creadas en el paso anterior.)
7. Si se te pide que crees una política, haz clic en Create (Crear) en la pantalla.
8. Haz clic en Create (Crear) en la parte inferior para terminar de crear tu conector de servicio.

Para obtener más información sobre OCI Object Storage, consulta la publicación del blog de Service Connector de Oracle.

1. Configura un log de OCI.
2. Crea un almacén de objetos de OCI y habilita el acceso de lectura/escritura para logs de OCI.
3. Crea una función de OCI.
4. Configura un evento de OCI.

Las siguientes instrucciones utilizan el portal de OCI para configurar la integración.

Registro de OCI

1. En el portal de OCI, ve a Solutions and Platform -> Logging -> Logs (Soluciones y plataforma -> Registro -> Logs).
2. Haz clic en Create Custom Log (Crear log personalizado) para pasar a la página Create Custom Log (Crear log personalizado).
3. Dale un nombre a tu nuevo log de OCI.
4. Selecciona un Compartment (Compartimento) y un Log Group (Grupo de logs). Estas selecciones se mantienen en toda la instalación.
5. Haz clic en Create Custom Log (Crear log personalizado) para acceder a la página Create Agent Config (Crear configuración del Agent).
6. Haz clic en Create new configuration (Crear nueva configuración).
7. Dale un nombre a tu nueva configuración. Tu compartimento está preseleccionado para ti.
8. Establece el tipo de grupo en Dynamic Group (Grupo dinámico) y agrupa a uno de tus grupos existentes.
9. Establece el tipo de entrada en Log Path (Ruta de log), introduce el nombre de entrada que prefieras y utiliza “/” para las rutas de los archivos.
10. Haz clic en Create Custom Log (Crear log personalizado), entonces tu log de OCI se creará y estará disponible en la página de logs.

Para obtener más información sobre los logs de OCI, consulta Activación del registro de un recurso.

Almacén de objetos de OCI

1. En el portal de OCI, ve a Core Infrastructure -> Object Storage -> Object Storage (Infraestructura central > Almacén de objetos > Almacén de objetos).
2. Haz clic en Create Bucket (Crear bucket) para acceder al formulario Create bucket (Crear bucket).
3. Selecciona Standard (Estándar) para tu nivel de almacenamiento y marca Emit Object Events (Emitir eventos de objeto).
4. Completa el resto del formulario según tus preferencias.
5. Haz clic en Create Bucket (Crear bucket), tu bucket se creará y estará disponible en la lista de buckets.
6. Selecciona tu nuevo bucket en la lista de buckets activos y haz clic en Logs en recursos.
7. Activa leer, lo que te dirige a un menú lateral Habilitar log.
8. Selecciona un Compartment (Compartimento) y un Log Group (Grupo de logs) (utiliza las mismas selecciones que en tu log de OCI).
9. Introduce un nombre para el Log Name (Nombre de log) y selecciona tu retención de log preferida.

Para obtener más información sobre OCI Object Storage, consulta Poner datos en Object Storage.

Función de OCI

1. En el portal de OCI, ve a Solutions and Platform -> Developer Services -> Functions (Soluciones y plataforma > Servicios de desarrollador > Funciones).
2. Selecciona una aplicación existente o haz clic en Create Application (Crear aplicación).
3. Crea una nueva función de OCI dentro de tu aplicación. Consulta Información general de las funciones de Oracle para obtener detalles.
4. Se recomienda crear primero una función boilerplate en Python y sustituir los archivos generados automáticamente por el código fuente de Datadog:
   • Sustituye func.py por el código del repositorio de Datadog OCI
   • Sustituye func.yaml por el código del repositorio de Datadog OCI. DATADOG_TOKEN y DATADOG_HOST deben sustituirse por tu clave de API de Datadog y el enlace de admisión de los logs de región.
   • Sustituye requirements.txt por el código del repositorio de Datadog OCI

Evento de OCI

1. En el portal de OCI, ve a Solutions and Platform -> Application Integration -> Event Service (Soluciones y plataforma > Integración de aplicaciones > Servicio de eventos).
2. Haz clic en Create Rule (Crear regla) para acceder a la página Create Rule (Crear regla).
3. Asigna un nombre y una descripción a tu regla de evento.
4. Establece tu condición como Tipo de evento, el nombre de servicio como Almacén de objetos y el tipo de evento como Objeto - Crear.
5. Establece tu tipo de acción como Functions (Funciones).
6. Asegúrate de que tu compartimento de función sea la misma selección que hiciste para Log de OCI, Bucket de OCI y Función de OCI.
7. Selecciona tu aplicación y función (según el paso de instalación anterior).
8. Haz clic en Create Rule (Crear regla), tu regla se creará y estará disponible en la lista de reglas.

Para obtener más información sobre OCI Object Storage, consulta Introducción a los eventos.

Recursos de reenvío de métricas y logs

Para cada región monitorizada, esta opción de configuración crea la siguiente infraestructura dentro de esa región para reenviar métricas y logs a Datadog:

• Aplicación de funciones (dd-function-app)
• Dos funciones:
  • Reenvío de métricas (dd-metrics-forwarder)
  • Reenvío de logs (dd-logs-forwarder)
• VCN (dd-vcn) con infraestructura de red segura:
  • Subred privada (dd-vcn-private-subnet)
  • Puerta NAT (dd-vcn-natgateway) para acceso externo a Internet
  • Puerta de servicios (dd-vcn-servicegateway) para el acceso interno a los servicios OCI
• Vault del Servicio de Gestión de Claves (KMS) (datadog-vault) para almacenar la clave de la API Datadog
• Compartimento dedicado Datadog (Datadog)

Todos los recursos están etiquetados con ownedby = "datadog".

Recursos de IAM

Esta opción de configuración crea los siguientes recursos IAM para habilitar el reenvío de datos a Datadog:

• Usuario del servicio (dd-svc)
• Grupo (dd-svc-admin) al que pertenece el usuario del servicio
• Par de claves RSA para la autenticación de la API
• Clave de la API OCI para el usuario del servicio
• Grupo dinámico (dd-dynamic-group-connectorhubs) que incluye todos los conectores de servicio del compartimento Datadog
• Grupo dinámico (dd-dynamic-group-function) que incluye todas las funciones del compartimento de Datadog
• Política (dd-svc-policy) para dar al usuario del servicio acceso de lectura a los recursos de la tenencia y acceso para gestionar OCI Service Connector Hubs y OCI Functions en el compartimento creado y gestionado por Datadog

- Allow dd-svc-admin to read all-resources in tenancy
- Allow dd-svc-admin to manage serviceconnectors in Datadog compartment
- Allow dd-svc-admin to manage functions-family in Datadog compartment with specific permissions:
     * FN_FUNCTION_UPDATE
     * FN_FUNCTION_LIST
     * FN_APP_LIST
- Endorse dd-svc-admin to read objects in tenancy usage-report

• Política dd-dynamic-group-policy para permitir que los conectores de servicio lean datos (logs y métricas) e interactúen con las funciones. Esta política también permite que las funciones lean secretos en el compartimento Datadog (la API Datadog y las claves de aplicaciones almacenadas en el vault de KMS).

   - Allow dd-dynamic-group-connectorhubs to read log-content in tenancy
   - Allow dd-dynamic-group-connectorhubs to read metrics in tenancy
   - Allow dd-dynamic-group-connectorhubs to use fn-function in Datadog compartment
   - Allow dd-dynamic-group-connectorhubs to use fn-invocation in Datadog compartment
   - Allow dd-dynamic-group-functions to read secret-bundles in Datadog compartment

Recursos de reenvío de métricas

Esta opción de configuración crea un [centro de conectores] de OCI (https://docs.oracle.com/iaas/Content/connector-hub/home.htm), una [aplicación de función] (https://docs.oracle.com/iaas/Content/Functions/Concepts/functionsconcepts.htm#applications) y una infraestructura de red segura para enviar métricas de OCI a Datadog. El stack tecnológico de ORM para estos recursos crea un repositorio de contenedor de función para la región en la tenencia, y la imagen de Docker se transfiere a él para ser utilizada por la función.

Recursos de IAM

Esta opción de configuración crea:

• Grupo dinámico con resource.type = 'serviceconnectors', para permitir el acceso al hub de conectores
• Usuario denominado DatadogROAuthUser, que Datadog utiliza para leer los recursos de la tenencia.
• Grupo al que se añade el usuario creado para el acceso a la política
• Usuario llamado DatadogAuthWriteUser, que se utiliza para insertar imágenes Docker para la función
• Grupo de acceso de escritura al que se añade DatadogAuthWriteUser, para insertar imágenes a través de la política de acceso
• Política en el compartimento raíz para permitir que los hubs de conectores lean métricas e invoquen funciones. Esta política también otorga al grupo de usuarios creado acceso de lectura tanto a los recursos de tenencia como al grupo de acceso de escritura, para insertar imágenes

Allow dynamic-group Default/<GROUP_NAME> to read metrics in tenancy
Allow dynamic-group Default/<GROUP_NAME> to use fn-function in tenancy
Allow dynamic-group Default/<GROUP_NAME> to use fn-invocation in tenancy
Allow group Default/<USER_GROUP_NAME> to read all-resources in tenancy
Allow group Default/<WRITE_USER_GROUP_NAME> to manage repos in tenancy where ANY {request.permission = 'REPOSITORY_READ', request.permission = 'REPOSITORY_UPDATE', request.permission = 'REPOSITORY_CREATE'}