View a markdown version of this page

Conectando DataDog - AWS DevOps Agente

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Conectando DataDog

Built-in, integración unidireccional

Actualmente, AWS DevOps Agent admite a los usuarios de Datadog con una integración unidireccional integrada, lo que permite lo siguiente:

  • Activación automática de la investigación: los eventos de Datadog se pueden configurar para activar las investigaciones de resolución de incidentes del AWS DevOps agente mediante los webhooks de los agentes. AWS DevOps

  • Introspección telemétrica: el AWS DevOps agente puede realizar una introspección de la telemetría de Datadog mientras investiga un problema a través del servidor MCP remoto de cada proveedor.

Incorporación

Paso 1: Conectar

Establezca la conexión con su terminal MCP remoto de Datadog con las credenciales de acceso a la cuenta

Configuración

  1. Vaya a la página de proveedores de capacidades (accesible desde el panel de navegación lateral)

  2. Busque Datadog en la sección Proveedores disponibles, en Telemetría, y seleccione Registrar

  3. Introduzca los detalles de su servidor MCP de Datadog:

    • Nombre del servidor: identificador único (por ejemplo, my-datadog-server)

    • URL del punto final: el punto final de su servidor MCP de Datadog. La URL del punto final varía en función del sitio de Datadog. Consulte la tabla de puntos finales del sitio de Datadog que aparece a continuación.

    • Descripción: descripción del servidor opcional

  4. Elija Siguiente.

  5. Revisión y envío

Puntos finales del sitio Datadog

La URL del punto final del MCP varía según el sitio de Datadog. Para identificar su sitio, compruebe la URL en su navegador cuando haya iniciado sesión en Datadog o consulte Acceder al sitio de Datadog.

Sitio de Datadog Dominio del sitio URL del punto final de MCP
US1 (predeterminado) datadoghq.com https://mcp.datadoghq.com/api/unstable/mcp-server/mcp
US3 us3.datadoghq.com https://mcp.us3.datadoghq.com/api/unstable/mcp-server/mcp
NOSOTROS 5 us5.datadoghq.com https://mcp.us5.datadoghq.com/api/unstable/mcp-server/mcp
EU1 datadoghq.eu https://mcp.datadoghq.eu/api/unstable/mcp-server/mcp
AP1 ap1.datadoghq.com https://mcp.ap1.datadoghq.com/api/unstable/mcp-server/mcp
AP2 ap2.datadoghq.com https://mcp.ap2.datadoghq.com/api/unstable/mcp-server/mcp

Autorización

Complete la autorización de OAuth de la siguiente manera:

  • Autorizándolo como usuario en la página OAuth de Datadog

  • Si no ha iniciado sesión, elija Permitir, iniciar sesión y, a continuación, autorizar

Una vez configurado, Datadog estará disponible en todos los espacios de agentes.

Paso 2: Habilitar

Actívelo DataDog en un espacio de agente específico y configure el alcance adecuado

Configuración

  1. En la página de espacios de agentes, seleccione un espacio de agentes y pulse ver detalles (si aún no ha creado un espacio de agentes, consulteCreación de un espacio de agentes)

  2. Seleccione la pestaña Capacidades

  3. Desplázate hacia abajo hasta la sección de telemetría

  4. Presiona Agregar

  5. Seleccione Datadog

  6. Next

  7. Revise y pulse Guardar

  8. Copia la URL y la clave de API del webhook (se muestran una vez al guardar; la clave de API no se puede ver más tarde; si la pierdes, vuelve a generarla a partir de los detalles del webhook de la pestaña Capacidades, lo que invalida la clave anterior)

Paso 3: Configurar los webhooks

Con la URL de Webhook y la clave de API del paso 2, puede configurar Datadog para que envíe eventos que desencadenen una investigación, por ejemplo, cuando un monitor alerta.

Los webhooks de Datadog utilizan la autenticación mediante token de portador. Para conocer el formato general de solicitud de webhook y el esquema de carga útil, consulte. Invocar al DevOps agente a través de Webhook Las siguientes secciones proporcionan una configuración de Datadog lista para usar; no es necesario que construyas la carga útil tú mismo.

Paso 3.1: Crea el webhook en Datadog

  1. En Datadog, abre Integraciones, busca Webhooks y abre el icono de integración. Para obtener más información, consulte Webhooks en la documentación de Datadog.

  2. En Webhooks, selecciona Nuevo.

  3. En Nombre, introduce un nombre comodevops-agent. Hace referencia a este nombre como @webhook-devops-agent en los mensajes del monitor.

  4. Para la URL, pega la URL del Webhook del paso 2 (que se puede volver a ver en la entrada de Datadog de la pestaña Capacidades de tu espacio de agente).

  5. En el caso de Payload, sustituye la carga útil predeterminada por la plantilla del paso 3.2.

  6. Deje el método de autenticación sin configurar y, en su lugar, seleccione encabezados personalizados e introduzca el encabezado que se muestra en el siguiente ejemplo y <API_KEY_FROM_STEP_2> sustitúyalo por la clave de API del paso 2.

  7. Deje el formulario Encode as desactivado. El punto final del webhook requiere un cuerpo JSON sin procesar; la codificación del formulario hace que la carga no se procese.

  8. Guarda el webhook.

Valor de encabezado personalizado para el paso 6:

{"Authorization": "Bearer <API_KEY_FROM_STEP_2>"}

Para evitar almacenar la clave a simple vista, defina una variable personalizada (por ejemplo$DEVOPS_AGENT_API_KEY) en el mosaico del webhook con la opción Ocultar de la vista seleccionada y, en su lugar, haga referencia a la variable en el valor del encabezado.

Paso 3.2: plantilla de carga útil para las alertas activadas por el monitor

La siguiente plantilla funciona para alertas de monitor estándar, incluidos los monitores métricos, de registro, APM y Synthetics. Datadog sustituye los $VARIABLE marcadores de posición cuando envía el webhook; déjelos tal como están escritos.

{ "eventType": "incident", "incidentId": "datadog-$ALERT_CYCLE_KEY", "action": "created", "priority": "HIGH", "title": "$ALERT_TITLE", "description": "$TEXT_ONLY_MSG", "service": "datadog", "data": { "monitorId": "$ALERT_ID", "eventType": "$EVENT_TYPE", "alertQuery": "$ALERT_QUERY", "alertScope": "$ALERT_SCOPE", "alertMetric": "$ALERT_METRIC", "alertTransition": "$ALERT_TRANSITION", "alertPriority": "$ALERT_PRIORITY", "tags": "$TAGS", "eventUrl": "$LINK", "hostname": "$HOSTNAME" } }

Cómo se asignan las variables de Datadog al esquema del webhook

Campo Webhook Valor para usar Notas
eventType La cadena literal incident Constante requerida.
incidentId datadog-$ALERT_CYCLE_KEY $ALERT_CYCLE_KEYpermanece igual desde que se activa un monitor hasta que se resuelve, por lo que las renotificaciones se deduplican y se convierten en una sola investigación. En su lugar, usa $ID (el ID por evento) solo si quieres que cada notificación inicie una investigación independiente.
action La cadena literal created No asigne $ALERT_TRANSITION a este campo. Sus valores (como Triggered yRecovered) no son action valores válidos. En su lugar, controle cuándo se activa el webhook desde el mensaje del monitor (consulte el paso 3.3).
priority Una de las cadenas literalesCRITICAL,HIGH, MEDIUMLOW, o MINIMAL No lo use $ALERT_PRIORITY aquí. Se expande a las prioridades del monitor de Datadog (P1P5), que no son valores válidos para este campo. El webhook devuelve una respuesta de 200, pero no se inicia ninguna investigación. Para enviar diferentes prioridades, cree un webhook por nivel de prioridad (por ejemplo, devops-agent-critical ydevops-agent-high) y consulte el webhook correspondiente de cada monitor.
title $ALERT_TITLE El título de la alerta del monitor.
description $TEXT_ONLY_MSG El texto del evento sin Markdown. Prefiero esto antes que$EVENT_MSG, cuyo formato Markdown añade ruido.
service Un nombre de servicio literal Opcional. Una cadena estática que identifica la fuente, como datadog el nombre del servicio.
timestamp Omita Opcional. Las variables de fecha de Datadog ($DATE,$DATE_POSIX) son valores de época, no el formato ISO 8601 que espera este campo, así que omita el campo.
data Variables de contexto de Datadog Opcional, aunque recomendado. Todo lo que data ingresa se transfiere al agente como el evento original, lo que proporciona a la investigación la consulta del monitor, el alcance, las etiquetas y un enlace al evento de Datadog.

Paso 3.3: Consulte el webhook de sus monitores

En cada monitor cuyas alertas deban desencadenar una investigación, añada la mención del webhook al mensaje del monitor, con un alcance tal que solo lo active la transición de alertas:

{{#is_alert}} @webhook-devops-agent {{/is_alert}}

Sin la {{#is_alert}} condición, las notificaciones de advertencia y recuperación también envían el webhook. Los eventos de recuperación se deduplican con respecto a la investigación abierta$ALERT_CYCLE_KEY, pero las advertencias inician investigaciones para alcanzar los umbrales que quizás no desee que se investiguen.

Verificación de la configuración

Envíe una notificación de prueba desde un monitor (Notificaciones de prueba en el editor de monitores) y confirme lo siguiente:

  1. El webhook devuelve una respuesta de 200. Puedes ver el estado de la entrega en la secuencia de eventos de la integración del webhook de Datadog. Una respuesta 4xx significa que el Authorization encabezado es incorrecto. Re-check introduzca la clave de API y confirme que el formulario Encode as está borrado.

  2. Se inicia una investigación en tu espacio de agente. (La investigación de una notificación de prueba se cierra sin conocer las causas fundamentales, como era de esperar). Una respuesta de 200 puntos sin una investigación significa que la carga útil no pasó la validación después de haber sido aceptada. Comprueba el cuerpo de la respuesta del webhook en la secuencia de eventos de Datadog: una carga útil no válida devuelve una respuesta 200 en cuyo cuerpo se muestran los errores de validación (por ejemplo,'P2' is not one of ['CRITICAL', 'HIGH', ...]), mientras que una carga útil válida devuelve un valor. {"message": "Webhook received"} Las causas más comunes son un priority valor no literal (consulte la tabla de mapeo anterior) y un duplicado de una prueba anterior incidentId del mismo ciclo de alerta.

Para obtener información general sobre la solución de problemas relacionados con los webhooks, consulte. Invocar al DevOps agente a través de Webhook

Más información: Servidor MCP remoto Datadog

Eliminación

La fuente de telemetría está conectada en dos niveles: a nivel de espacio de agente y a nivel de cuenta. Para eliminarla por completo, primero debe eliminarla de todos los espacios de agentes en los que se utilice y, a continuación, podrá anular su registro.

Paso 1: Eliminar del espacio de agentes

  1. En la página de espacios de agentes, selecciona un espacio de agentes y pulsa ver detalles

  2. Seleccione la pestaña Capacidades

  3. Desplázate hacia abajo hasta la sección de telemetría

  4. Selecciona Datadog

  5. Presiona quitar

Paso 2: Anular el registro de la cuenta

  1. Vaya a la página de proveedores de capacidades (a la que se puede acceder desde la barra de navegación lateral)

  2. Desplázate hasta la sección Registrados actualmente.

  3. Comprueba que el número de espacios para agentes sea cero (si no, repite el paso 1 anterior en los demás espacios para agentes)

  4. Selecciona Datadog y, a continuación, selecciona Cancelar registro en el menú Acciones.