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
Vaya a la página de proveedores de capacidades (accesible desde el panel de navegación lateral)
Busque Datadog en la sección Proveedores disponibles, en Telemetría, y seleccione Registrar
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
Elija Siguiente.
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
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)
Seleccione la pestaña Capacidades
Desplázate hacia abajo hasta la sección de telemetría
Presiona Agregar
Seleccione Datadog
Next
Revise y pulse Guardar
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
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. En Webhooks, selecciona Nuevo.
En Nombre, introduce un nombre como
devops-agent. Hace referencia a este nombre como@webhook-devops-agenten los mensajes del monitor.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).
En el caso de Payload, sustituye la carga útil predeterminada por la plantilla del paso 3.2.
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.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.
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 (P1—P5), 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:
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
Authorizationencabezado es incorrecto. Re-check introduzca la clave de API y confirme que el formulario Encode as está borrado.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 unpriorityvalor no literal (consulte la tabla de mapeo anterior) y un duplicado de una prueba anteriorincidentIddel 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
En la página de espacios de agentes, selecciona un espacio de agentes y pulsa ver detalles
Seleccione la pestaña Capacidades
Desplázate hacia abajo hasta la sección de telemetría
Selecciona Datadog
Presiona quitar
Paso 2: Anular el registro de la cuenta
Vaya a la página de proveedores de capacidades (a la que se puede acceder desde la barra de navegación lateral)
Desplázate hasta la sección Registrados actualmente.
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)
Selecciona Datadog y, a continuación, selecciona Cancelar registro en el menú Acciones.