Skip to main content

Visão geral

O Datadog envia alertas pela Webhooks Integration, renderizando um template de payload configurável. Como o Datadog não tem um formato fixo, o aciona.me lê vários campos alternativos — mas o template recomendado abaixo garante o comportamento correto, inclusive a auto-resolução.

Pré-requisitos

  • Permissão para editar integrações e monitors no Datadog.
  • Um serviço criado no aciona.me e vinculado a um time com escala ativa.

1. Crie a fonte de alerta no aciona.me

Em Fontes de alerta, crie uma fonte do tipo Datadog.

2. Copie a URL e o token

3. Crie o webhook no Datadog

1

Integrations → Webhooks → Add Webhook

Name: aciona-me — é assim que você vai referenciá-lo nos monitors, como @webhook-aciona-me.
2

URL

https://ingress.aciona.me/webhooks/<idDaFonte>
3

Payload

Cole o template recomendado:
4

Advanced Options → Custom HTTP Header

X-Aciona-Token: <tokenDaFonte>

4. Referencie o webhook no monitor

No monitor, em “Notify your team as”, adicione @webhook-aciona-me.
Não coloque @webhook-aciona-me apenas dentro de {"{{#is_alert}}"}. Se ele ficar restrito a esse bloco, o Datadog só dispara o webhook na transição Triggered — o Recovered nunca chega e a auto-resolução quebra silenciosamente. Deixe a menção fora de qualquer bloco condicional.
Configure também a prioridade P1–P5 do monitor, que vira a severidade do acionamento.

5. Envie um alerta de teste

Use Test Notifications no monitor, ou force a condição de alerta.

6. Confirme o acionamento

Em Acionamentos, verifique se título, severidade e serviço estão corretos.

7. Como os campos são traduzidos

Estado

Transição ausente ou desconhecida é tratada como disparo — o aciona.me prefere notificar a mais do que deixar de notificar.

Severidade

Sem prioridade definida, o aciona.me usa o tipo do alerta como alternativa e, na falta dele, warning.

Serviço

A pista de serviço vem, nesta ordem, da tag service:, do escopo do alerta, do hostname e da métrica. Marque seus monitors com service:<nome-no-aciona-me>.

Solução de problemas

Quase sempre é o @webhook-aciona-me preso dentro de {"{{#is_alert}}"}. Mova a menção para fora dos blocos condicionais. Verifique também se $ALERT_TRANSITION está no template — sem ele, todo evento é tratado como disparo.
O template não inclui $ALERT_TITLE. Use o template recomendado acima.
O template não inclui $ALERT_CYCLE_KEY, e a correlação caiu em outro campo. Adicione-o.
O monitor não tem prioridade P1–P5 definida.
A Webhooks Integration do Datadog só retenta em erros 5xx. Como o aciona.me responde 202 rapidamente, isso não costuma ser um problema — mas alertas recusados por token inválido (401) não são reenviados.