Envío de eventos y logs a Datadog con destinos de API de Amazon EventBridge

El sitio Datadog para el gobierno no es compatible con Amazon EventBridge.

Amazon EventBridge es un bus de eventos serverless que te permite crear aplicaciones basadas en eventos. EventBridge puede integrarse con tus servicios AWS, pero la función de destinos de API te permite enviar y recibir datos fuera de AWS utilizando las API. En esta guía se indican los pasos necesarios para enviar tus eventos y logs desde EventBridge a Datadog. Para obtener más información sobre el envío de tus eventos desde Datadog a EventBridge, consulta la documentación de la integración EventBridge.

Configuración

Antes de empezar, necesitas una cuenta Datadog con una clave de API y también necesitas acceso a destinos de API Amazon Eventbridge.

Configuración

  1. Para añadir Datadog como destino API, sigue los pasos indicados en la [documentación de Amazon Crear un destino de API5.

    • Utiliza la autorización de clave de API, con DD-API-KEY como nombre de tu clave y tu clave de API Datadog como valor.
    • Para tu endpoint de destino, utiliza https:///api/v2/logs para logs y https://api./api/v1/events para eventos, y configura POST como método HTTP. Para obtener más información sobre las diferencias entre logs y eventos, consulta Reducir los riesgos relacionados con los datos.
    • Si utiliza el endpoint de eventos, debes incluir title y text como parámetros body.field en la conexión del destino de la API. Estos son los valores necesarios para POST al endpoint de eventos. Para obtener más información, consulta la documentación Publicar un evento.

  2. Una vez configurado el destino, consulta la documentación de Amazon para crear una regla EventBridge, donde configuras Datadog como tu destino.

  3. Una vez configurada la regla con Datadog como destino, activa un evento publicando un evento para EventBridge. Para obtener más información sobre cómo enviar eventos a EventBridge desde Datadog, consulta la documentación de la integración EventBridge. Por ejemplo, para activar un evento de test cargando los objetos a un bucket de S3 en tu cuenta, utiliza este comando AWS CloudShell:

    echo "test" > testfile.txt
aws s3 cp testfile.txt s3://YOUR_BUCKET_NAME

  4. Una vez que se envían los eventos y los logs, al cabo de unos cinco minutos los datos están disponibles en la consola de logs o el Explorador de eventos de Datadog, dependiendo del endpoint al que los estés enviando.

Resolución de problemas

Para ver más detalles sobre las cargas útiles enviadas a Datadog y ver la respuesta de los endpoints de la API, configura una cola de Amazon SQS:

  1. Crea una cola en Amazon SQS.
  2. Ve a la regla EventBridge que has creado en la sección Configuración.
  3. Selecciona la pestaña Targets (Destinos) y haz clic en Edit (Editar).
  4. Amplía la sección Additional settings (Parámetros adicionales).
  5. En la sección Dead-letter queue (Cola de mensajes fallidos), elige Select an Amazon SQS queue in the current AWS account to use as the dead-letter queue (Seleccionar una cola de Amazon SQS en la cuenta AWS actual para utilizarla como cola de emnsajes fallidos).
  6. Selecciona la cola SQS que acabas de crear.
  7. Actualiza la regla.

Leer más

Additional helpful documentation, links, and articles:

Blog de AWS con ejemplos de uso de destinos de APIBLOG more more