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, 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 webhooks del agente. AWS DevOps
Introspección telemétrica: el AWS DevOps agente puede inspeccionar la telemetría de Datadog mientras investiga un problema a través del servidor MCP remoto de cada proveedor.
Incorporación
Paso 1: conectarse
Establezca la conexión a su punto final MCP remoto de Datadog con las credenciales de acceso a la cuenta
Configuración
Vaya a la página de proveedores de capacidades (a la que se puede acceder desde la barra de navegación lateral)
Busque Datadog en la sección Proveedores disponibles, en Telemetría, y seleccione Registrarse
Introduzca los detalles de su servidor MCP de Datadog:
Nombre del servidor: identificador único (p. ej., my-datadog-server)
URL de 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. Consulta la tabla de puntos finales del sitio de Datadog que aparece a continuación.
Descripción: descripción opcional del servidor
Elija Siguiente.
Revisión y envío
Terminales del sitio de Datadog
La URL del punto final de MCP varía en función del sitio de Datadog. Para identificar tu sitio, comprueba la URL de tu navegador cuando hayas iniciado sesión en Datadog o consulta Acceder al sitio de Datadog.
| Sitio de Datadog | Dominio del sitio | URL de 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 |
| MAPA 1 | 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:
Autorizando como usuario en la página OAuth de Datadog
Si no has iniciado sesión, elige Permitir, iniciar sesión y, a continuación, autorizar
Una vez configurado, Datadog estará disponible en todos los espacios del agente.
Cada registro se conecta a una organización de Datadog. Para conectar otras organizaciones de Datadog, repite este proceso para cada una y asigna a cada registro su propio nombre de servidor.
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
Elige el registro de Datadog que deseas habilitar.
Next
Revisa y presiona Guardar
Copia la URL y la clave de API del webhook (se muestran una vez al guardarla; la clave de API no se podrá ver más adelante; si la pierdes, vuelve a generarla a partir de los detalles del webhook en la pestaña Capacidades, lo que invalida la clave anterior)
Un único espacio de agente puede usar más de un registro de Datadog. Para agregar otro registro, repita estos pasos.
Paso 3: Configurar los webhooks
Con la URL del webhook y la clave de API del paso 2, puedes configurar Datadog para que envíe eventos que activen una investigación, por ejemplo, cuando un monitor emite una alerta.
Los webhooks de Datadog utilizan la autenticación con el token del portador. Para ver el formato general de las solicitudes de webhooks 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 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, consulta Webhooks
en la documentación de Datadog. En Webhooks, selecciona Nuevo.
En Nombre, introduce un nombre como
devops-agent. Haga referencia a este nombre como@webhook-devops-agenten los mensajes del monitor.En el caso de la URL, pega la URL del webhook del paso 2 (que se puede ver de nuevo en la entrada de Datadog de la pestaña Capacidades de tu espacio de agente).
En Payload, reemplaza la carga 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 la opción Codificar como formulario borrado. 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 guardar 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 las alertas de monitor estándar, incluidos los monitores métricos, de registro, APM y sintéticos. Datadog sustituye los $VARIABLE marcadores de posición cuando envía el webhook; déjalos 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 de webhooks
| 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 nuevas notificaciones se deduplican en una sola investigación. En su lugar, usa $ID (el identificador por evento) únicamente 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 amplía 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, crea un webhook por nivel de prioridad (por ejemplo, devops-agent-critical ydevops-agent-high) y consulta 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 con Markdown eliminado. Prefiero esto a$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 de tu servicio. |
timestamp |
Omitir | 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 |
Las variables de contexto de Datadog | Opcional, aunque recomendado. Todo lo que data contiene se pasa 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: consulta el webhook desde tus monitores
En cada monitor cuyas alertas deban iniciar una investigación, añada la mención del webhook al mensaje del monitor, de forma que solo la active la transición de alerta:
{{#is_alert}} @webhook-devops-agent {{/is_alert}}
Sin el {{#is_alert}} condicional, las notificaciones de advertencia y recuperación también envían el webhook. Los eventos de recuperación se deduplican en función de la investigación abierta$ALERT_CYCLE_KEY, pero las advertencias inician las investigaciones para detectar los umbrales que quizás no desee que se investiguen.
Verificación de la configuración
Envía una notificación de prueba desde un monitor (Notificaciones de prueba en el editor de monitores) y confirma lo siguiente:
El webhook devuelve una respuesta de 200. Puedes ver el estado de entrega en el flujo de eventos de la integración de webhooks de Datadog. Una respuesta de 4xx significa que el
Authorizationencabezado es incorrecto. Re-check la clave de API y confirme que el formulario Codificar como formulario está borrado.Se inicia una investigación en tu espacio de agente. (La investigación de una notificación de prueba se cierra sin causas fundamentales, como era de esperar). Una respuesta de 200 sin una investigación significa que la carga no se validó después de haber sido aceptada. Comprueba el cuerpo de la respuesta del webhook en el flujo de eventos de Datadog: una carga no válida devuelve 200 respuestas en cuyo cuerpo se enumeran los errores de validación (por ejemplo,), mientras que una carga útil válida devuelve 200 respuestas en cuyo cuerpo se muestran los errores de validación (por ejemplo,
'P2' is not one of ['CRITICAL', 'HIGH', ...]).{"message": "Webhook received"}Las causas más comunes son unpriorityvalor no literal (consulta la tabla de mapeo anterior) y un duplicado de una prueba anterior en el mismo cicloincidentIdde alertas.
Para obtener información general sobre la solución de problemas con webhooks, consulte. Invocar al DevOps agente a través de Webhook
Más información: Datadog Remote MCP Server
Eliminación
La fuente de telemetría está conectada en dos niveles: el nivel del espacio del agente y el nivel de la 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 para agentes, seleccione un espacio para agentes y pulse ver detalles
Seleccione la pestaña Capacidades
Desplázate hacia abajo hasta la sección de telemetría
Selecciona Datadog
Presiona eliminar
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.
Compruebe que el número de espacios de agente sea cero (si no, repita el paso 1 anterior en sus otros espacios de agente)
Selecciona Datadog y, a continuación, selecciona Anular registro en el menú Acciones.