OCI QuickStart de Datadog es una experiencia de configuración de flujo único totalmente administrada que le ayuda a realizar el seguimiento de su infraestructura y aplicaciones de OCI en solo unos pocos clics. OCI QuickStart crea la infraestructura necesaria para reenviar métricas, registros y datos de recursos a Datadog, y descubre automáticamente nuevos recursos o compartimentos de OCI para la recopilación de datos.

Elija la configuración de QuickStart si…

• Está configurando la integración de OCI por primera vez.
• Prefiere un flujo de trabajo basado en la interfaz de usuario y desea minimizar el tiempo necesario para crear y configurar los recursos necesarios.
• Desea automatizar los pasos de configuración en scripts o pipelines de CI/CD.

Requisitos previos de la configuración de QuickStart

• Su cuenta de usuario de OCI necesita el rol de Administrador de dominio de identidad para completar estos pasos.
• Debe haber iniciado sesión en OCI en la tenencia con la que desea realizar la integración.
• Debe haber iniciado sesión en OCI con la Región de origen seleccionada en la parte superior derecha de la pantalla.
• Su cuenta de usuario de OCI debe poder crear un usuario, un grupo de usuarios y un grupo dinámico en el Dominio de identidad en el que ha iniciado sesión, o en el dominio de destino si se especifica. Si proporciona un OCID de dominio de destino, su cuenta de usuario de OCI debe tener privilegios de administrador en ese dominio.
• Su cuenta de usuario de OCI debe poder crear políticas en el compartimento raíz.

Instrucciones de configuración de QuickStart

Para configurar la infraestructura para el reenvío de registros y a métricas Datadog:

• Configure el Datadog OCI integration tile
• Implemente la pila ORM de QuickStart
• Complete la configuración en Datadog
• Valide que las métricas estén fluyendo
• Configure la recopilación de métricas o registros (opcional)
• Configure la recopilación de recursos (opcional)

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

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

Configure el mosaico de integración de Datadog OCI

1. Vaya al Datadog OCI integration tile y haga clic en Add New Tenancy.

2. Seleccione o cree una clave de API de Datadog para usar en la integración.

3. Cree una clave de aplicación de Datadog.

4. Habilite o deshabilite los registros utilizando el toggle.

5. Habilite o deshabilite la recopilación de eventos utilizando el toggle.

6. Haga clic en Create OCI Stack. Esto lo lleva a una pila de Oracle Resource Manager (ORM) para finalizar la implementación.
   Nota: Implemente esta pila solo una vez por tenencia.

Implemente la pila ORM de QuickStart

1. Acepte los Términos de uso de Oracle.

2. Deje la opción de usar proveedores de Terraform personalizados sin marcar.

3. Use el directorio de trabajo predeterminado para desplegar la pila, o elija opcionalmente uno diferente.

4. Haga clic en Next.

5. Datadog recomienda dejar la sección (Optional) Choose specific subnet(s) en blanco para crear una nueva Virtual Cloud Network (VCN) y una subnet en cada región de este arrendamiento.

   Opcionalmente, puede elegir existing subnets (un máximo de una por región de OCI) para la pila QuickStart de Datadog, en cuyo caso debe proporcionar a la pila los OCID de las subnet. Ingrese un OCID por línea, sin comas. La pila de Datadog QuickStart se despliega entonces en la región correspondiente a cada subnet. Cada OCID de subnet debe tener el formato: ocid1.subnet.oc[0-9].*. Por ejemplo, ocid1.subnet.oc1.iad.abcedfgh.
   Nota: Si utiliza una VCN y existing subnets, asegúrese de que la VCN en cada región:

   • Tenga permitido realizar llamadas de salida HTTP a través de NAT Gateway.
   • Tenga un Service Gateway que admita “All Services In Oracle Services Network”.
   • Tenga las reglas de tabla de rutas para permitir NAT Gateway y Service Gateway.
   • Tenga las reglas de seguridad para enviar solicitudes HTTP.

6. Datadog recomienda dejar la sección (Optional) Choose a User en blanco para crear un nuevo usuario y grupo. El grupo y el usuario se crean en el dominio de identidad de OCI en el que ha iniciado sesión actualmente (que no necesita ser el dominio predeterminado).
   Opcionalmente, puede elegir un usuario y grupo existentes para la pila QuickStart de Datadog. En este caso, Datadog infiere automáticamente el dominio del usuario y del grupo, y lo utiliza para crear grupos dinámicos.
   a. Group ID: Proporcione el OCID de un OCI Group existente para la autenticación de Datadog. Si se proporciona, User ID no puede dejarse en blanco.
   b. User ID: Proporcione el OCID de un OCI User existente para la autenticación de Datadog. El usuario debe ser miembro del grupo especificado. Si se proporciona, Group ID no puede dejarse en blanco.

7. Datadog recomienda dejar la sección (Optional) Advanced configuration en blanco, ya que estos casos de uso son poco comunes.
   Opcionalmente, puede elegir un compartimento y un dominio existentes para la pila QuickStart de Datadog.
   a. Compartment: Elija un compartimento existente para colocar todos los recursos creados por Datadog.
   b. Domain: Proporcione el OCID de un Identity Domain existente para anular dónde se crean el usuario y el grupo. Este campo solo se muestra si no se especifican un usuario y un grupo existentes en el paso 6. Si se proporciona, User Email no puede dejarse en blanco. Nota: Su cuenta de usuario de OCI debe tener el rol de Administrador de dominio de identidad en el dominio de destino.
   c. Etiquetas de recurso: Proporcione una lista de etiquetas definidas que se agregarán a todos los recursos de OCI implementados por la pila de inicio rápido de Datadog. Ingrese una etiqueta por línea. No agregue comas. Cada etiqueta definida debe tener el formato: namespace.key:value. Por ejemplo, CostCenter.Environment:prod. Si se deja en blanco, no se agregan etiquetas definidas a los recursos de OCI implementados por la pila de inicio rápido de Datadog.
   

8. Haga clic en Siguiente.

9. Haga clic en Crear y espere hasta 30 minutos para que se complete la implementación.

Complete la configuración en Datadog

Regrese al mosaico de integración de Datadog OCI y haga clic en ¡Listo!

Elija la configuración de Terraform si…

• Usted administra la infraestructura como código y desea mantener la integración de Datadog OCI bajo control de versiones.
• Usted necesita configurar varias carpetas o proyectos de manera consistente con bloques de proveedor reutilizables.
• Usted desea un proceso de implementación repetible y auditable que se ajuste a su entorno administrado por Terraform.

Puede usar Terraform para aprovisionar la integración de Datadog OCI. Esta guía enumera los requisitos previos, las variables necesarias y los pasos exactos para inicializar, planificar y aplicar.

Requisitos previos de la configuración de Terraform

Tenga lo siguiente antes de comenzar:

• Terraform 1.x instalado.
• Una clave de API de Datadog válida.
• Acceso a OCI con el rol de Administrador de dominio de identidad en el dominio de destino.

Instrucciones de configuración de Terraform

Para configurar la infraestructura para el reenvío de métricas y registros a Datadog:

• Cree un archivo de configuración de OCI
• Configure el módulo de Terraform
• Implemente con Terraform
• Valide que las métricas estén fluyendo
• Configure la recopilación de métricas o registros (opcional)
• Configure la recopilación de recursos (opcional)

Cree un archivo de configuración de OCI

El archivo ~/.oci/config otorga a Terraform permisos para crear recursos en OCI. Cree una clave de API y agréguela a su configuración, o siga la documentación de Oracle. Su archivo debería verse así:

[DEFAULT]
user=<USER_OCID>
fingerprint=<USER_FINGERPRINT>
tenancy=<TENANCY_OCID>
region=<HOME_REGION>
key_file=<PATH_TO_PRIVATE_KEY_FILE>

Configure el módulo de Terraform

Las siguientes entradas configuran el módulo de integración de Datadog OCI. Los campos obligatorios están marcados. Para obtener la lista completa de opciones de configuración disponibles, consulte la página de agregar tenencia.

1. Agregue una clave de API de Datadog.

Haga clic en Seleccionar clave de API y seleccione una clave de API para usar.

2. Cree una clave de aplicación de Datadog.

Haga clic en Crear, y se generará una clave de aplicación que se agregará al campo. Asegúrese de copiar este valor y guardarlo en una ubicación segura, ya que no se podrá acceder a él nuevamente después de salir de esta pantalla.

3. Agregue su OCID de tenencia de OCI.

1. Ingrese el OCID de la tenencia que será objeto de seguimiento por Datadog. Encuéntrelo en cloud.oracle.com/tenancy.
2. Opcionalmente, elija un compartimento y subredes de OCI específicos. Datadog recomienda dejar esta sección en blanco para crear un nuevo compartimento de OCI y una Virtual Cloud Network (VCN) de OCI en cada región de la tenencia.

4. Agregue su OCID de usuario de OCI.

Ingrese su OCID de usuario. Este usuario debe tener el rol de Administrador de dominio de identidad. Encuéntrelo en cloud.oracle.com/identity/domains/my-profile.

5. Configure la recopilación de registros (opcional).

Para deshabilitar toda la recopilación de registros de la tenencia, haga clic en el interruptor. Si desea deshabilitar la recopilación de registros para servicios específicos de OCI, edite la configuración después de la instalación en el mosaico de integración de Datadog OCI.

6. Configure la recopilación de eventos (opcional).

Para deshabilitar toda la recopilación de eventos de la tenencia, haga clic en el interruptor. Para deshabilitar la recopilación de eventos después de la instalación, edite la configuración en el mosaico de integración de Datadog OCI.

7. Confirme los detalles de configuración del módulo de Terraform generado.

El módulo de Terraform generado debe seguir el formato que se muestra a continuación:

module "datadog_oci" {
  source = "github.com/DataDog/oracle-cloud-integration//datadog-terraform-onboarding"

  datadog_api_key = <API_KEY>
  datadog_app_key = <APP_KEY>
  datadog_site    = <DATADOG_SITE>

  tenancy_ocid      = "<TENANCY_OCID>"
  current_user_ocid = "<CURRENT_USER_OCID>"

  logs_enabled              = true
  events_collection_enabled = true
}

Implementar con Terraform

1. Copie el módulo de Terraform generado y péguelo en un archivo .tf.
2. Ejecute terraform init && terraform apply para inicializar Terraform y crear la integración. Si desea obtener una vista previa de los cambios, sustituya plan por apply.

Solución de problemas

Tiempos de espera

Vuelva a ejecutar el comando de Terraform sin cambiar la configuración.

Conflictos de proveedor

Si encuentra conflictos de proveedor desde el comando terraform init, actualice su configuración de proveedor local para que coincida con las versiones requeridas del módulo.

Advertencias en Datadog inmediatamente después de la configuración

Espere hasta 15 minutos para que las advertencias desaparezcan.

Tanto la sección Etiquetas de compartimento como la sección Limitar la recopilación a recursos específicos aceptan key:value etiquetas de OCI separadas por comas. Anteponga ! a una etiqueta para negarla. El separador de comas se comporta de manera diferente según los tipos de etiquetas utilizados:

• Solo etiquetas positivas: lógica OR—se incluye si el objeto OCI (compartimento o recurso específico) tiene alguna de las etiquetas enumeradas.
• Solo etiquetas negativas (con el prefijo !): lógica OR—se excluye si alguna de las etiquetas negadas está presente.
• Etiquetas positivas y negativas mixtas: lógica AND—debe satisfacer todas las condiciones enumeradas para ser incluido.

Por ejemplo:

• datadog:monitored,env:prod*: incluir si alguna de las etiquetas está presente.
• !env:staging,!testing:true: excluir si alguna de las etiquetas está presente.
• datadog:monitored,!region:us-phoenix-1: incluir solo si la etiqueta datadog:monitored está presente y la etiqueta region:us-phoenix-1 está ausente.

Formato de clave de etiqueta: Datadog normaliza las claves de etiqueta de OCI a minúsculas snake_case antes de realizar la coincidencia. Las claves establecidas en OCI usando camelCase o PascalCase (por ejemplo, deploymentType o DeploymentType) se almacenan y comparan como su equivalente en minúsculas snake_case (deployment_type). Utilice minúsculas snake_case al especificar filtros de etiquetas en el mosaico de integración.

Requisito previo: Antes de aplicar la actualización, verifique que la clave de aplicación de Datadog configurada en su pila de OCI siga siendo válida. Si la clave ha caducado o ha sido revocada, el trabajo de destrucción fallará. Para actualizar la clave, edite las variables de pila datadog_app_key en la consola de OCI y proporcione una clave de aplicación válida antes de continuar.

Ejecute los siguientes comandos desde OCI Cloud Shell para actualizar su pila a la versión más reciente y aplicar los cambios:

curl -fL -o datadog-integration.zip \
  "https://github.com/DataDog/oracle-cloud-integration/releases/latest/download/datadog-integration.zip"

export STACK_ID="<YOUR_STACK_OCID>"
export OCI_CLI_REGION="<YOUR_HOME_OR_STACK_REGION>"

oci resource-manager stack update \
  --stack-id "$STACK_ID" \
  --config-source datadog-integration.zip \
  --region "$OCI_CLI_REGION" \
  --force

oci resource-manager job create-apply-job \
  --stack-id "$STACK_ID" \
  --execution-plan-strategy AUTO_APPROVED \
  --region "$OCI_CLI_REGION" \
  --wait-for-state SUCCEEDED

Reemplace los valores de marcador de posición:

• <YOUR_STACK_OCID>: El OCID de su pila ORM de Datadog. Encuéntrelo en cloud.oracle.com/resourcemanager/stacks.

• <YOUR_HOME_OR_STACK_REGION>: La región de origen de su arrendamiento (por ejemplo, us-ashburn-1).

Requisito previo: Antes de volver a aplicar Terraform, verifique que la variable datadog_app_key en su configuración de Terraform contenga una clave de aplicación de Datadog válida. Si la clave ha caducado o ha sido revocada, el comando de destrucción fallará. Actualice el valor en su archivo .tf o a través de un archivo terraform.tfvars antes de continuar.

Vuelva a ejecutar Terraform para inicializar el módulo actualizado y aplicar los cambios más recientes:

terraform init -upgrade && terraform apply

Opcionalmente, ejecute terraform plan antes de apply para obtener una vista previa de los cambios.

Requisito previo: Antes de ejecutar el trabajo de destrucción, verifique que la clave de aplicación de Datadog configurada en su pila de OCI siga siendo válida. Si la clave ha caducado o ha sido revocada, el trabajo fallará. Para actualizar la clave, edite las variables de la pila en la consola de OCI y proporcione una clave de aplicación válida antes de continuar.

1. Navegue a Oracle Resource Manager (ORM) en la consola de OCI.

2. Localice la pila QuickStart de Datadog que se creó durante la instalación. De forma predeterminada, la pila está etiquetada como datadog-integration.zip-<NUMBER>, pero podría haberse configurado con un nombre personalizado durante la implementación.

3. Ejecute un Destroy trabajo en la pila para eliminar todos los recursos creados por la integración en todas las regiones.

   

4. Opcionalmente, elimine la pila de OCI de Datadog una vez que se complete la destrucción.

Nota: Ejecutar el trabajo una vez en la pila de QuickStart limpia automáticamente todos los recursos en todas las regiones donde se implementó la integración.

Requisito previo: Antes de ejecutar el comando de destrucción, verifique que la variable datadog_app_key en su configuración de Terraform contenga una clave de aplicación de Datadog válida. Si la clave ha caducado o ha sido revocada, el comando de destrucción fallará. Actualice el valor en su archivo .tf o mediante un archivo terraform.tfvars antes de continuar.

Asegúrese de que el perfil DEFAULT en ~/.oci/config tenga credenciales de usuario para administrar recursos en el arrendamiento correspondiente, luego ejecute:

terraform destroy

- Allow dd-svc-admin to read all-resources in tenancy
- Allow dd-svc-admin to use tag-namespaces in tenancy
- Allow dd-svc-admin to manage serviceconnectors in Datadog compartment
- Allow dd-svc-admin to manage functions-family in Datadog compartment
- Allow dd-svc-admin to use fn-invocation in Datadog compartment
- Allow dd-svc-admin to manage buckets in Datadog compartment where target.bucket.name=/dd-*/
- Allow dd-svc-admin to manage object-family in Datadog compartment where target.bucket.name=/dd-*/
- Endorse dd-svc-admin to read objects in tenancy usage-report
- Allow dd-svc-admin to manage cloudevents-rules in tenancy where any {request.permission = 'EVENTRULE_CREATE', target.resource.tag.DatadogManaged.marker = 'true'}
- Allow dd-svc-admin to manage streams in Datadog compartment where any {request.permission = 'STREAM_CREATE', target.resource.tag.DatadogManaged.marker = 'true'}
- Allow service objectstorage-<REGION> to manage object-family in Datadog compartment where target.bucket.name=/dd-*/

Nota: La sentencia Allow service objectstorage-<REGION> debe agregarse una vez por región suscrita (por ejemplo, objectstorage-us-ashburn-1, objectstorage-ap-batam-1). Esto permite a Datadog limpiar automáticamente los datos antiguos en los buckets gestionados por Datadog a través de políticas de ciclo de vida de objetos.