As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Conectando DataDog
Built-in, integração unidirecional
Atualmente, o AWS DevOps Agent oferece suporte aos usuários do Datadog com integração unidirecional integrada, permitindo o seguinte:
Acionamento automatizado de investigação - os eventos do Datadog podem ser configurados para acionar investigações de resolução de incidentes do AWS DevOps agente por meio de webhooks do agente. AWS DevOps
Introspecção de telemetria - O AWS DevOps agente pode fazer uma introspecção da telemetria do Datadog enquanto investiga um problema por meio do servidor MCP remoto de cada provedor.
Onboarding
Etapa 1: Conectar
Estabeleça conexão com seu endpoint MCP remoto Datadog com credenciais de acesso à conta
Configuração
Vá para a página Capability Providers (acessível na navegação lateral)
Encontre o Datadog na seção Provedores disponíveis em Telemetria e escolha Registrar
Insira os detalhes do seu servidor Datadog MCP:
Nome do servidor - Identificador exclusivo (por exemplo, my-datadog-server)
URL do endpoint - Seu endpoint do servidor Datadog MCP. O URL do endpoint varia dependendo do seu site Datadog. Veja a tabela de endpoints do site Datadog abaixo.
Descrição - Descrição opcional do servidor
Escolha Próximo.
Analisar e enviar
Endpoints do site Datadog
O URL do endpoint MCP varia dependendo do seu site Datadog. Para identificar seu site, verifique a URL em seu navegador quando estiver conectado ao Datadog ou consulte Acessar o site do
| Site Datadog | Domínio do site | URL do endpoint MCP |
|---|---|---|
| US1 (padrão) | datadoghq.com |
https://mcp.datadoghq.com/api/unstable/mcp-server/mcp |
| NÓS 3 | us3.datadoghq.com |
https://mcp.us3.datadoghq.com/api/unstable/mcp-server/mcp |
| US5 | 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 |
| MAPA 2 | ap2.datadoghq.com |
https://mcp.ap2.datadoghq.com/api/unstable/mcp-server/mcp |
Autorização
Conclua a autorização do OAuth até:
Autorizando como seu usuário na página OAuth do Datadog
Se não estiver logado, escolha Permitir, faça login e, em seguida, autorize
Depois de configurado, o Datadog fica disponível em todos os espaços do agente.
Etapa 2: Ativar
Ative DataDog em um espaço de agente específico e configure o escopo apropriado
Configuração
Na página de espaços do agente, selecione um espaço do agente e pressione visualizar detalhes (se você ainda não criou um espaço do agente, consulteCriação de um espaço de agente)
Selecione a guia Capacidades
Role para baixo até a seção Telemetria
Pressione Adicionar
Selecione Datadog
Próximo
Revise e pressione Salvar
Copie a URL do webhook e a chave de API (mostradas uma vez ao salvar; a chave de API não pode ser visualizada posteriormente. Se você a perder, regenere a chave a partir dos detalhes do webhook na guia Capacidades, o que invalida a chave anterior)
Etapa 3: configurar webhooks
Usando o URL do Webhook e a chave de API da Etapa 2, você pode configurar o Datadog para enviar eventos que acionem uma investigação, como quando um monitor alerta.
Os webhooks do Datadog usam autenticação de token de portador. Para o formato geral de solicitação de webhook e o esquema de carga útil, consulte. Invocando o DevOps Agente por meio do Webhook As seções a seguir fornecem uma configuração do Datadog pronta para uso; você não precisa criar a carga por conta própria.
Etapa 3.1: Criar o webhook no Datadog
No Datadog, abra Integrações, pesquise por Webhooks e abra o bloco de integração. Para obter mais informações, consulte Webhooks na documentação
do Datadog. Em Webhooks, escolha Novo.
Em Nome, insira um nome como
devops-agent. Você faz referência a esse nome como@webhook-devops-agentnas mensagens do monitor.Para URL, cole o URL do Webhook da Etapa 2 (visível novamente na entrada Datadog na guia Capacidades do seu espaço de agente).
Para Payload, substitua a carga padrão pelo modelo na Etapa 3.2.
Deixe o método de autenticação desconfigurado e, em vez disso, selecione Cabeçalhos personalizados e insira o cabeçalho mostrado no exemplo a seguir,
<API_KEY_FROM_STEP_2>substituindo-o pela chave de API da Etapa 2.Deixe Codificar como formulário limpo. O endpoint do webhook requer um corpo JSON bruto; a codificação do formulário faz com que a carga falhe no processamento.
Salve o webhook.
Valor do cabeçalho personalizado para a etapa 6:
{"Authorization": "Bearer <API_KEY_FROM_STEP_2>"}
Para evitar armazenar a chave em exibição simples, defina uma variável personalizada (por exemplo,$DEVOPS_AGENT_API_KEY) no bloco do webhook com a opção Ocultar da visualização selecionada e, em vez disso, referencie a variável no valor do cabeçalho.
Etapa 3.2: Modelo de carga útil para alertas acionados por monitor
O modelo a seguir funciona para alertas de monitor padrão, incluindo monitores métricos, de log, APM e Synthetics. O Datadog substitui os $VARIABLE espaços reservados ao enviar o webhook; deixe-os como estão 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" } }
Como as variáveis do Datadog são mapeadas para o esquema do webhook
| Campo Webhook | Valor a ser usado | Observações |
|---|---|---|
eventType |
A sequência literal incident |
Constante necessária. |
incidentId |
datadog-$ALERT_CYCLE_KEY |
$ALERT_CYCLE_KEYpermanece o mesmo desde o momento em que um monitor é acionado até que seja resolvido, então as renotificações são desduplicadas em uma única investigação. Em vez disso, use $ID (a ID por evento) somente se quiser que cada notificação inicie uma investigação separada. |
action |
A sequência literal created |
Não mapeie $ALERT_TRANSITION para esse campo. Seus valores (como Triggered eRecovered) não são action valores válidos. Em vez disso, controle quando o webhook é acionado a partir da mensagem do monitor (consulte a Etapa 3.3). |
priority |
Uma das sequências literaisCRITICAL,,, HIGHMEDIUM, ou LOW MINIMAL |
Não use $ALERT_PRIORITY aqui. Ele se expande para as prioridades do monitor Datadog (P1—P5), que não são valores válidos para esse campo. O webhook retorna uma resposta de 200, mas nenhuma investigação é iniciada. Para enviar prioridades diferentes, crie um webhook por nível de prioridade (por exemplo, devops-agent-critical edevops-agent-high) e faça referência ao webhook apropriado de cada monitor. |
title |
$ALERT_TITLE |
O título do alerta do monitor. |
description |
$TEXT_ONLY_MSG |
O texto do evento com Markdown removido. Prefira isso$EVENT_MSG, cuja formatação Markdown adiciona ruído. |
service |
Um nome de serviço literal | Opcional. Uma string estática identificando a fonte, como datadog o nome do seu serviço. |
timestamp |
Omitir | Opcional. As variáveis de data do Datadog ($DATE,$DATE_POSIX) são valores de época, não o formato ISO 8601 que esse campo espera, então omita o campo. |
data |
Variáveis de contexto do Datadog | Opcional, mas não recomendado. Tudo o que entra data é passado para o agente como o evento original, fornecendo à investigação a consulta do monitor, o escopo, as tags e um link para o evento do Datadog. |
Etapa 3.3: Faça referência ao webhook a partir de seus monitores
Em cada monitor cujos alertas devem acionar uma investigação, adicione a menção do webhook à mensagem do monitor, com escopo definido de forma que somente a transição do alerta a acione:
{{#is_alert}} @webhook-devops-agent {{/is_alert}}
Sem as notificações {{#is_alert}} condicionais, de aviso e recuperação também enviam o webhook. Os eventos de recuperação são desduplicados em relação à investigação aberta$ALERT_CYCLE_KEY, mas os avisos iniciam investigações sobre limites que você talvez não queira investigar.
Verificação da configuração
Envie uma notificação de teste de um monitor (Notificações de teste no editor do monitor) e confirme o seguinte:
O webhook retorna uma resposta de 200. Você pode ver o status da entrega no stream de eventos da integração do webhook do Datadog. Uma resposta 4xx significa que o
Authorizationcabeçalho está errado. Re-check a chave de API e confirme se a opção Codificar como formulário está limpa.Uma investigação começa no seu Espaço do Agente. (A investigação de uma notificação de teste é encerrada sem a causa raiz — isso é esperado.) Uma resposta de 200 sem uma investigação significa que a carga falhou na validação depois de ser aceita. Verifique o corpo da resposta do webhook no fluxo de eventos do Datadog: uma carga inválida retorna uma resposta 200 cujo corpo lista os erros de validação (por exemplo,
'P2' is not one of ['CRITICAL', 'HIGH', ...]), enquanto uma carga válida retorna.{"message": "Webhook received"}As causas mais comuns são umpriorityvalor não literal (consulte a tabela de mapeamento anterior) e uma duplicataincidentIdde um teste anterior no mesmo ciclo de alerta.
Para solução geral de problemas com webhook, consulteInvocando o DevOps Agente por meio do Webhook.
Saiba mais: Datadog Remote MCP Server
Remoção
A fonte de telemetria está conectada em dois níveis no nível do espaço do agente e no nível da conta. Para removê-lo completamente, você deve primeiro removê-lo de todos os espaços do agente em que ele é usado e, em seguida, ele pode ser cancelado.
Etapa 1: Remover do espaço do agente
Na página de espaços do agente, selecione um espaço do agente e pressione visualizar detalhes
Selecione a guia Capacidades
Role para baixo até a seção Telemetria
Selecione Datadog
Pressione remover
Etapa 2: Cancelar o registro da conta
Vá para a página Capability Providers (acessível na navegação lateral)
Role até a seção Registrado atualmente.
Verifique se a contagem de espaço do agente é zero (se não, repita a Etapa 1 acima em seus outros espaços do agente)
Selecione Datadog e escolha Cancelar registro no menu Ações.