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 di 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 da parte degli AWS DevOps agenti tramite i 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: Connessione

Stabilisci una connessione al tuo endpoint MCP remoto Datadog con le credenziali di accesso all'account

Configurazione

  1. Vai alla pagina dei fornitori di capacità (accessibile dalla barra di navigazione laterale)

  2. Trova Datadog nella sezione Fornitori disponibili in Telemetria e scegli Registra

  3. Inserisci i dettagli del tuo server MCP Datadog:

    • Nome server: identificatore univoco (ad esempio, my-datadog-server)

    • Endpoint URL: l'endpoint del tuo server MCP Datadog. 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 hai effettuato l'accesso a Datadog o consulta Accedi al sito Datadog. https://docs.datadoghq.com/getting_started/site/#access-the-datadog-site

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
AP 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

Autorizzazione

Autorizzazione OAuth completa tramite:

  • Autorizzazione come utente nella pagina OAuth di Datadog

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

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

Ogni registrazione si connette a un'organizzazione Datadog. Per connettere altre organizzazioni Datadog, ripeti questo processo per ognuna e assegna a ciascuna registrazione il proprio nome server.

Fase 2: Attivare

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

Configurazione

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

  2. Seleziona la scheda Funzionalità

  3. Scorri verso il basso fino alla sezione Telemetria

  4. Premi Aggiungi

  5. Scegli la registrazione Datadog che desideri abilitare.

  6. Next

  7. Rivedi e premi Salva

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

Un singolo Agent Space può utilizzare più di una registrazione Datadog. Per aggiungere un'altra registrazione, ripeti questi passaggi.

Fase 3: Configurare i webhook

Utilizzando l'URL 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 al portatore. Per il formato generale di richiesta del webhook e lo schema del payload, vedi. 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 https://docs.datadoghq.com/integrations/webhooks/ Webhooks nella documentazione di Datadog.

  2. In Webhooks, scegli Nuovo.

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

  4. Per l'URL, incolla l'URL del Webhook del passaggio 2 (visualizzabile nuovamente dalla voce Datadog nella scheda Capacità dello spazio agente).

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

  6. Lascia il metodo di autenticazione non configurato, 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 causa la mancata elaborazione del payload.

  8. Salva il webhook.

Valore dell'intestazione personalizzato per il passaggio 6:

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

Per evitare di memorizzare la chiave in piena vista, definisci una variabile personalizzata (ad esempio,$DEVOPS_AGENT_API_KEY) nel riquadro del webhook con Nascondi dalla vista selezionato e fai invece riferimento alla variabile nel valore dell'intestazione.

Passaggio 3.2: modello di payload per gli avvisi attivati dal monitor

Il modello seguente funziona per gli avvisi di monitor 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" } }

In che modo 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 invariato 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 relativi valori (ad esempio Triggered eRecovered) non sono action valori validi. Controlla invece quando il webhook viene generato dal messaggio di monitoraggio (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 una risposta di 200, ma non viene avviata alcuna indagine. Per inviare priorità diverse, create un webhook per livello di priorità (ad esempio, devops-agent-critical edevops-agent-high) e fate riferimento al webhook appropriato da ogni monitor.
title $ALERT_TITLE Il titolo dell'avviso del monitor.
description $TEXT_ONLY_MSG Il testo dell'evento con Markdown è stato rimosso. Preferiscilo a questo$EVENT_MSG, la cui formattazione Markdown aggiunge rumore.
service Un nome letterale di servizio Opzionale. Una stringa statica che identifica l'origine, datadog ad esempio il nome del servizio.
timestamp Ometti Opzionale. Le variabili di data di Datadog ($DATE,$DATE_POSIX) sono valori di epoca, non il formato ISO 8601 previsto da questo campo, quindi ometti il campo.
data Variabili di contesto di Datadog Facoltativo ma consigliato. Tutto ciò che entra data viene passato all'agente come evento originale, fornendo all'indagine la query di monitoraggio, l'ambito, i tag e un collegamento all'evento Datadog.

Passaggio 3.3: Fai riferimento al webhook dai tuoi monitor

In ogni monitor i cui avvisi dovrebbero attivare un'indagine, aggiungi la menzione del webhook al messaggio del monitor, con un ambito in modo che sia attiva solo la transizione dell'avviso:

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

Senza il {{#is_alert}} condizionale, anche le notifiche di avviso e ripristino inviano il webhook. Gli eventi di ripristino vengono deduplicati in base all'indagine aperta$ALERT_CYCLE_KEY, ma gli avvisi avviano le indagini per soglie che potresti non voler esaminare.

Verifica la configurazione

Inviate una notifica di prova da un monitor (Notifiche di test nell'editor del monitor) e confermate quanto segue:

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

  2. Un'indagine inizia nel tuo Agent Space. (L'indagine di una notifica di test si chiude senza cause principali, come previsto). Una risposta pari a 200 senza un'indagine indica 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, consulta. 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 e quindi può essere annullata la registrazione.

Passaggio 1: Rimuovi dallo spazio dell'agente

  1. Dalla pagina degli spazi per gli agenti, seleziona uno spazio per gli agenti 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: Annullamento della registrazione dall'account

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

  2. Scorri fino alla sezione Attualmente registrato.

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

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