View a markdown version of this page

Conectando DataDog - AWS DevOps Agente

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

  1. Vá para a página Capability Providers (acessível na navegação lateral)

  2. Encontre o Datadog na seção Provedores disponíveis em Telemetria e escolha Registrar

  3. 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

  4. Escolha Próximo.

  5. 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 Datadog.

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

  1. 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)

  2. Selecione a guia Capacidades

  3. Role para baixo até a seção Telemetria

  4. Pressione Adicionar

  5. Selecione Datadog

  6. Próximo

  7. Revise e pressione Salvar

  8. 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

  1. 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.

  2. Em Webhooks, escolha Novo.

  3. Em Nome, insira um nome comodevops-agent. Você faz referência a esse nome como @webhook-devops-agent nas mensagens do monitor.

  4. 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).

  5. Para Payload, substitua a carga padrão pelo modelo na Etapa 3.2.

  6. 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.

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

  8. 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 (P1P5), 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:

  1. 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 Authorization cabeçalho está errado. Re-check a chave de API e confirme se a opção Codificar como formulário está limpa.

  2. 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 um priority valor não literal (consulte a tabela de mapeamento anterior) e uma duplicata incidentId de 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

  1. Na página de espaços do agente, selecione um espaço do agente e pressione visualizar detalhes

  2. Selecione a guia Capacidades

  3. Role para baixo até a seção Telemetria

  4. Selecione Datadog

  5. Pressione remover

Etapa 2: Cancelar o registro da conta

  1. Vá para a página Capability Providers (acessível na navegação lateral)

  2. Role até a seção Registrado atualmente.

  3. 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)

  4. Selecione Datadog e escolha Cancelar registro no menu Ações.