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.
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 tagservice:, do escopo do alerta, do hostname e da métrica. Marque seus monitors com service:<nome-no-aciona-me>.
Solução de problemas
O acionamento abre, mas nunca fecha sozinho
O acionamento abre, mas nunca fecha sozinho
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.Título aparece como Untitled alert
Título aparece como Untitled alert
O template não inclui
$ALERT_TITLE. Use o template recomendado acima.Acionamentos duplicados
Acionamentos duplicados
O template não inclui
$ALERT_CYCLE_KEY, e a correlação caiu em outro campo. Adicione-o.Severidade sempre warning
Severidade sempre warning
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.