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:

Onboarding

Etapa 1: Conectar

Estabeleça conexão com seu endpoint MCP remoto Datadog com credenciais de acesso à conta

Configuração

Endpoints do site Datadog

O URL do endpoint MCP varia de acordo com seu site do Datadog. Para identificar seu site, verifique a URL em seu navegador quando estiver conectado ao Datadog ou consulte Acessar o site do Datadog.

Autorização

Conclua a autorização do OAuth por meio de:

Depois de configurado, o Datadog fica disponível em todos os espaços do agente.

Cada registro se conecta a uma organização Datadog. Para conectar outras organizações do Datadog, repita esse processo para cada uma delas e atribua a cada registro seu próprio nome de servidor.

Etapa 2: Ativar

Ative DataDog em um espaço específico do agente e configure o escopo apropriado

Configuração

Um único Agent Space pode usar mais de um registro do Datadog. Para adicionar outro registro, repita essas etapas.

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 por token portador. Para obter o formato geral da 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 construir a carga sozinho.

Etapa 3.1: Crie o webhook no Datadog

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, faça referência à variável no valor do cabeçalho.

Etapa 3.2: Modelo de carga útil para alertas acionados pelo monitor

O modelo a seguir funciona para alertas de monitor padrão, incluindo monitores métricos, de registro, APM e sintéticos. 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

Etapa 3.3: Consulte o webhook em seus monitores

Em cada monitor cujos alertas devem acionar uma investigação, adicione a menção do webhook à mensagem do monitor, com um escopo definido de forma que somente a transição de alerta a acione:

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

Sem a {{#is_alert}} condição, as notificações 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:

Para solução geral de problemas com webhooks, 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

Etapa 2: cancelar o registro da conta