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 OCI en tan sólo unos clics. OCI QuickStart crea la infraestructura necesaria para reenviar métricas, logs y datos de recursos a Datadog y descubre automáticamente nuevos recursos o compartimentos OCI para la recopilación de datos.

Nota: En forma predeterminada sólo se envían métricas. Habilita la recopilación de logs y de datos de recursos desde el ícono de integración de OCI de Datadog después de completar esta configuración.

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 del 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 ícono de integración de OCI de Datadog y haz clic en 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 Crear y espera hasta 15 minutos a que se complete el despliegue.

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

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

• Puedes encontrar 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 del usuario) del cuadro de integración de Datadog y 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 digital y pégalo en el campo Huella digital del cuadro de integración de Datadog y 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), ingresa 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 a la página del cuadro de integración de Datadog y 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 Obtener el gestor de recursos 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 Habilitar Recopilación de logs en la pestaña Recopilación de logs del ícono de integración de OCI de Datadog.

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 logs de OCI, consulta Activación del registro para 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 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 el código del repositorio de OCI de Datadog
   • Sustituye func.yaml por el código del repositorio de OCI de Datadog. DATADOG_TOKEN y DATADOG_HOST deben sustituirse por tu clave API Datadog y el enlace de admisión de logs de la región
   • Sustituye requirements.txt por el código del repositorio de OCI de Datadog

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 “_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 entrada del blog sobre el conector de servicio 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 logs de OCI, consulta Activación del registro para 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. Para más detalles, consulta Información general de funciones de Oracle.
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 OCI de Datadog
   • Sustituye func.yaml por el código del repositorio de OCI de Datadog. DATADOG_TOKEN y DATADOG_HOST deben sustituirse por tu clave de API Datadog y el enlace de admisión de logs de la región
   • Sustituye requirements.txt por el código del repositorio de OCI de Datadog

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 más información sobre OCI Object Storage, consulta Empezando con 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

- Permitir que dd-svc-admin lea todos los recursos en tenencia
- Permitir que dd-svc-admin gestione conectores de servicios en el compartimento Datadog 
- Permitir que dd-svc-admin gestione una familia de funciones en el compartimento Datadog con permisos específicos:
     * FN_FUNCIÓN_ACTUALIZACIÓN
     * FN_FUNCIÓN_LISTA
     * FN_APLICACIONES_LISTA
- Autorizar a dd-svc-admin a leer objetos en el informe de uso de la tenencia

• 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 hub de conectores OCI, una aplicación de función y una infraestructura de red segura para reenviar métricas 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 Docker se envía a este 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'}