View a markdown version of this page

Connessione DataDog - AWS DevOps Agente

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Connessione DataDog

Built-in, integrazione unidirezionale

Attualmente, AWS DevOps Agent supporta gli utenti Datadog con un'integrazione unidirezionale integrata, che consente quanto segue:

  • Attivazione automatica delle indagini: gli eventi Datadog possono essere configurati per attivare le indagini sulla risoluzione degli incidenti degli agenti tramite i AWS DevOps webhook degli agenti. AWS DevOps

  • Introspezione telemetrica: l' AWS DevOps agente può analizzare la telemetria di Datadog mentre analizza un problema tramite il server MCP remoto di ciascun provider.

Onboarding

Fase 1: Connect

Stabilisci la connessione all'endpoint MCP remoto Datadog con le credenziali di accesso all'account

Configurazione

  1. Vai alla pagina Capability Provider (accessibile dalla navigazione laterale)

  2. Trova Datadog nella sezione Provider disponibili sotto Telemetria e scegli Registra

  3. Inserisci i dettagli del tuo server Datadog MCP:

    • Nome server: identificatore univoco (ad es. my-datadog-server)

    • URL dell'endpoint: l'endpoint del server Datadog MCP. L'URL dell'endpoint varia a seconda del sito Datadog. Consulta la tabella degli endpoint del sito Datadog di seguito.

    • Descrizione: descrizione opzionale del server

  4. Seleziona Next (Successivo).

  5. Verifica e invia

Endpoint del sito Datadog

L'URL dell'endpoint MCP varia a seconda del sito Datadog. Per identificare il tuo sito, controlla l'URL nel tuo browser quando accedi a Datadog, oppure consulta Accedi al sito Datadog.

Sito Datadog Dominio del sito URL dell'endpoint MCP
US1 (impostazione predefinita) 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
NOI 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

Autorizzazione

Autorizzazione OAuth completa tramite:

  • Autorizzazione come utente nella pagina Datadog OAuth

  • Se non hai effettuato l'accesso, scegli Consenti, accedi, quindi autorizza

Una volta configurato, Datadog diventa disponibile in tutti gli spazi dell'agente.

Fase 2: Abilita

DataDog Effettua l'attivazione in uno spazio specifico dell'agente e configura l'ambito appropriato

Configurazione

  1. Dalla pagina degli spazi per agenti, seleziona uno spazio agente e premi Visualizza dettagli (se non hai ancora creato uno spazio agente, consultaCreazione di uno spazio per agenti)

  2. Seleziona la scheda Funzionalità

  3. Scorri verso il basso fino alla sezione Telemetria

  4. Premi Aggiungi

  5. Seleziona Datadog

  6. Next

  7. Rivedi e premi Salva

  8. Copia l'URL e la chiave API del Webhook (mostrati una volta al salvataggio; la chiave API non può essere visualizzata in seguito: se li perdi, rigenerali dai dettagli del webhook nella scheda Capacità, per invalidare la chiave precedente)

Fase 3: Configurare i webhook

Utilizzando l'URL del Webhook e la chiave API del passaggio 2, puoi configurare Datadog per inviare eventi che attivano un'indagine, ad esempio quando un monitor avvisa.

I webhook Datadog utilizzano l'autenticazione con token Bearer. Per il formato generale di richiesta dei webhook e lo schema di payload, vedere. Richiamo DevOps dell'agente tramite Webhook Le sezioni seguenti forniscono una configurazione Datadog pronta all'uso; non è necessario creare il payload da soli.

Passaggio 3.1: Creare il webhook in Datadog

  1. In Datadog, apri Integrazioni, cerca Webhook e apri il riquadro di integrazione. Per ulteriori informazioni, consulta Webhook nella documentazione di Datadog.

  2. In Webhook, scegli Nuovo.

  3. Per Nome, inserisci un nome come. devops-agent Fate riferimento a questo nome come @webhook-devops-agent nei messaggi di monitoraggio.

  4. Per l'URL, incolla l'URL del Webhook dal Passaggio 2 (nuovamente visualizzabile dalla voce Datadog nella scheda Capacità dello spazio dedicato agli agenti).

  5. Per Payload, sostituisci il payload predefinito con il modello nel passaggio 3.2.

  6. Lascia il metodo di autenticazione non configurato, quindi seleziona Intestazioni personalizzate e inserisci l'intestazione mostrata nell'esempio seguente, sostituendola <API_KEY_FROM_STEP_2> con la chiave API del passaggio 2.

  7. Lascia Encode come modulo cancellato. L'endpoint webhook richiede un corpo JSON non elaborato; la codifica del modulo impedisce l'elaborazione del payload.

  8. Salva il webhook.

Valore di intestazione personalizzato per il passaggio 6:

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

Per evitare di memorizzare la chiave in modo semplice, definite una variabile personalizzata (ad esempio$DEVOPS_AGENT_API_KEY) nel riquadro del webhook con l'opzione Nascondi dalla vista selezionata e fate invece riferimento alla variabile nel valore dell'intestazione.

Fase 3.2: Modello di payload per avvisi attivati dal monitor

Il seguente modello funziona per gli avvisi di monitoraggio standard, inclusi i monitor metrici, log, APM e Synthetics. Datadog sostituisce i $VARIABLE segnaposto quando invia il webhook; lasciali come scritti.

{ "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" } }

Come le variabili Datadog vengono mappate allo schema del webhook

Campo Webhook Valore da utilizzare Note
eventType La stringa letterale incident Costante richiesta.
incidentId datadog-$ALERT_CYCLE_KEY $ALERT_CYCLE_KEYrimane invariata dal momento in cui un monitor si attiva fino alla sua risoluzione, quindi le nuove notifiche vengono deduplicate in un'unica indagine. Utilizza invece $ID (l'ID per evento) solo se desideri che ogni notifica avvii un'indagine separata.
action La stringa letterale created Non eseguire la $ALERT_TRANSITION mappatura su questo campo. I suoi valori (come Triggered eRecovered) non sono action valori validi. Controlla invece quando il webhook si attiva dal messaggio del monitor (vedi Passaggio 3.3).
priority Una delle stringhe letteraliCRITICAL,,, o HIGH MEDIUM LOW MINIMAL Non usare $ALERT_PRIORITY qui. Si espande alle priorità del monitor Datadog (P1P5), che non sono valori validi per questo campo. Il webhook restituisce 200 risposte, ma non viene avviata alcuna indagine. Per inviare priorità diverse, crea un webhook per livello di priorità (ad esempio, devops-agent-critical edevops-agent-high) e fai riferimento al webhook appropriato da ciascun monitor.
title $ALERT_TITLE Il titolo dell'avviso del monitor.
description $TEXT_ONLY_MSG Il testo dell'evento con Markdown rimosso. Preferisco questo a quello$EVENT_MSG, la cui formattazione Markdown aggiunge rumore.
service Un nome di servizio letterale Opzionale. Una stringa statica che identifica l'origine, ad datadog esempio il nome del servizio.
timestamp Ometti Opzionale. Le variabili di data di Datadog ($DATE,$DATE_POSIX) sono valori epocali, non il formato ISO 8601 previsto da questo campo, quindi ometti il campo.
data Variabili di contesto Datadog Facoltativo ma consigliato. Tutto ciò che data è contenuto viene passato all'agente come evento originale, fornendo all'indagine la query di monitoraggio, l'ambito, i tag e un collegamento all'evento Datadog.

Fase 3.3: Fai riferimento al webhook dai tuoi monitor

In ogni monitor i cui avvisi dovrebbero innescare un'indagine, aggiungi la menzione webhook al messaggio del monitor, con un ambito in modo che venga attivato solo dalla transizione degli avvisi:

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

Senza le notifiche {{#is_alert}} condizionali, anche le notifiche di avviso e ripristino inviano il webhook. Gli eventi di ripristino vengono deduplicati rispetto all'indagine in corso$ALERT_CYCLE_KEY, ma gli avvisi avviano indagini sulle soglie che potrebbero non essere esaminate.

Verifica la configurazione

Invia una notifica di test da un monitor (Notifiche di test nell'editor del monitor) e conferma quanto segue:

  1. Il webhook restituisce una risposta di 200. Puoi vedere lo stato di consegna nel flusso di eventi dell'integrazione con il webhook Datadog. Una risposta 4xx significa che l'intestazione è sbagliataAuthorization. Re-check la chiave API e conferma che Encode as form sia stato cancellato.

  2. Inizia un'indagine nel tuo Agent Space. (L'indagine relativa a una notifica di test si chiude senza che siano state rilevate le cause principali, come previsto). Una risposta pari a 200 senza un'indagine significa che il payload non è stato convalidato dopo essere stato accettato. Controlla il corpo della risposta del webhook nel flusso di eventi Datadog: un payload non valido restituisce una risposta 200 il cui corpo elenca gli errori di convalida (ad esempio,), 'P2' is not one of ['CRITICAL', 'HIGH', ...] mentre restituisce un payload valido. {"message": "Webhook received"} Le cause più comuni sono un priority valore non letterale (vedi la tabella di mappatura precedente) e un duplicato di un test precedente nello stesso ciclo di avvisi. incidentId

Per la risoluzione generale dei problemi relativi ai webhook, vedere. Richiamo DevOps dell'agente tramite Webhook

Per saperne di più: Datadog Remote MCP Server

Rimozione

La fonte di telemetria è connessa a due livelli a livello di spazio dell'agente e a livello di account. Per rimuoverla completamente, è necessario prima rimuoverla da tutti gli spazi dell'agente in cui viene utilizzata, dopodiché può essere annullata la registrazione.

Fase 1: Rimuovi dallo spazio dell'agente

  1. Dalla pagina degli spazi per gli agenti, seleziona uno spazio agente e premi Visualizza dettagli

  2. Seleziona la scheda Funzionalità

  3. Scorri verso il basso fino alla sezione Telemetria

  4. Seleziona Datadog

  5. Premi rimuovi

Fase 2: Annullare la registrazione dall'account

  1. Vai alla pagina dei Capability Provider (accessibile dalla barra di navigazione laterale)

  2. Scorri fino alla sezione Attualmente registrato.

  3. Verifica che il numero di spazi per gli agenti sia pari a zero (in caso contrario, ripeti il passaggio 1 precedente negli altri spazi riservati agli agenti)

  4. Seleziona Datadog, quindi scegli Annulla registrazione dal menu Azioni.