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
Vai alla pagina Capability Provider (accessibile dalla navigazione laterale)
Trova Datadog nella sezione Provider disponibili sotto Telemetria e scegli Registra
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
Seleziona Next (Successivo).
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
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)
Seleziona la scheda Funzionalità
Scorri verso il basso fino alla sezione Telemetria
Premi Aggiungi
Seleziona Datadog
Next
Rivedi e premi Salva
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
In Datadog, apri Integrazioni, cerca Webhook e apri il riquadro di integrazione. Per ulteriori informazioni, consulta Webhook
nella documentazione di Datadog. In Webhook, scegli Nuovo.
Per Nome, inserisci un nome come.
devops-agentFate riferimento a questo nome come@webhook-devops-agentnei messaggi di monitoraggio.Per l'URL, incolla l'URL del Webhook dal Passaggio 2 (nuovamente visualizzabile dalla voce Datadog nella scheda Capacità dello spazio dedicato agli agenti).
Per Payload, sostituisci il payload predefinito con il modello nel passaggio 3.2.
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.Lascia Encode come modulo cancellato. L'endpoint webhook richiede un corpo JSON non elaborato; la codifica del modulo impedisce l'elaborazione del payload.
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 (P1—P5), 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:
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 è sbagliata
Authorization. Re-check la chiave API e conferma che Encode as form sia stato cancellato.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 unpriorityvalore 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
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
Dalla pagina degli spazi per gli agenti, seleziona uno spazio agente e premi Visualizza dettagli
Seleziona la scheda Funzionalità
Scorri verso il basso fino alla sezione Telemetria
Seleziona Datadog
Premi rimuovi
Fase 2: Annullare la registrazione dall'account
Vai alla pagina dei Capability Provider (accessibile dalla barra di navigazione laterale)
Scorri fino alla sezione Attualmente registrato.
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)
Seleziona Datadog, quindi scegli Annulla registrazione dal menu Azioni.