# Faça os monitores do Datadog chegue ao seu celular.

> Receba os alertas de monitores do Datadog como notificações push. Registre o Pocket Alert como webhook e saiba de qualquer problema no seu celular em menos de um segundo.

<!-- source: https://pocketalert.app/pt/use-cases/datadog-alerts -->

Última atualização: 2026-08-11

Quando um monitor do Datadog dispara, o alerta e a gravidade chegam ao seu celular em menos de um segundo. Perceba o incidente antes que ele escale para um plantão.

## Três passos para ter alertas do Datadog no seu celular

1. **Crie um webhook** — Crie um webhook do Pocket Alert com um template de mensagem em GJSON e copie a URL de recebimento.
2. **Configure o webhook** — Registre a URL na integração de Webhooks do Datadog com um payload personalizado de $EVENT_TITLE / $TEXT_ONLY_MSG e depois chame-a a partir de um monitor.
3. **Mapeie e envie** — O GJSON mapeia o título do evento, a mensagem e a transição para a sua notificação push. O próximo disparo faz o seu celular vibrar.

## Do monitor violado à tela de bloqueio

O Datadog já envia um webhook quando um monitor é violado. O Pocket Alert transforma isso em uma notificação push que você não consegue ignorar.

- **Conecta-se aos webhooks do Datadog** — Registre o Pocket Alert na integração de Webhooks do Datadog e chame-o com @webhook-pocketalert a partir de qualquer monitor.
- **Variáveis de template entram, GJSON sai** — As variáveis de template do Datadog preenchem o corpo JSON. Os caminhos GJSON no Pocket Alert extraem o título do evento, a mensagem e a transição para a sua notificação.
- **Disparado vs recuperado** — Mapeie $ALERT_TRANSITION para que um monitor disparado seja diferente de uma recuperação, direto na tela de bloqueio.
- **Um canal por ambiente** — Cada aplicativo tem sua própria URL de webhook, então monitores de infra, APM e por equipe ficam em canais separados.
- **Entrega em menos de um segundo** — A violação chega ao seu celular em menos de um segundo, bem antes de a política de escalonamento entrar em ação.
- **URL de webhook secreta** — A URL do webhook é o segredo do seu aplicativo sobre HTTPS. Renove-a sempre que precisar de um novo endpoint.

## Envie alertas do Datadog para o seu celular

### 1. Crie um webhook do Pocket Alert

Na página de [Webhooks](https://pocketalert.app/pt/webhooks), crie um webhook com um template de `message` em GJSON que mapeia o payload do Datadog que você vai enviar. Você também pode criá-lo pela API:

```
curl -X POST "https://api.pocketalert.app/v1/webhooks" \
  -H "Token: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Datadog","message":"%event_title% — %alert_transition%\n%body%\n%link%","application_id":"qm47b9pzxzxg"}'
```

Você recebe uma URL de entrada como `https://p4a.me/wh/1234abcd`. Os caminhos GJSON acima (`%event_title%`, `%alert_transition%`, `%body%`, `%link%`) leem as chaves JSON que o Datadog enviará via POST na próxima etapa.

### 2. Registre o webhook no Datadog

Acesse [Integrações → Webhooks](https://docs.datadoghq.com/integrations/webhooks/) e adicione um novo webhook. Cole a URL de recebimento e defina um payload personalizado usando as variáveis de template do Datadog:

```
Name:    pocketalert
URL:     https://p4a.me/wh/1234abcd
Payload: {
  "event_title": "$EVENT_TITLE",
  "body": "$TEXT_ONLY_MSG",
  "alert_transition": "$ALERT_TRANSITION",
  "level": "critical",
  "link": "$LINK"
}
```

### 3. Chame o webhook a partir de um monitor

Adicione `@webhook-pocketalert` à mensagem do monitor. Quando o monitor disparar, o Datadog envia via POST o payload acima; o Pocket Alert renderiza o template GJSON e envia a notificação. Uma recuperação envia `$ALERT_TRANSITION = Recovered`, então o mesmo alerta mostra "Recovered" quando é normalizado.

A [documentação de configurações de webhook](https://info.pocketalert.app/api/webhooks/settings.html) cobre todos os caminhos GJSON e opções de webhook.

## Perguntas frequentes

### Como envio alertas do Datadog para o meu celular?

Crie um webhook do Pocket Alert, copie a URL de recebimento e registre-a no Datadog em Integrações → Webhooks. Chame-o com @webhook-pocketalert em qualquer mensagem de monitor e o alerta chega ao seu celular em menos de um segundo.

### Como funciona o mapeamento de campos?

No webhook do Datadog você define o corpo JSON com variáveis de template como $EVENT_TITLE, $TEXT_ONLY_MSG, $ALERT_TRANSITION e $LINK. O Pocket Alert lê esse JSON com caminhos GJSON, então o template da mensagem mapeia esses campos para o título e o corpo da notificação.

### Posso mostrar a transição e a gravidade do alerta?

Sim. Inclua $ALERT_TRANSITION (Triggered / Recovered) ou $ALERT_TYPE no payload e referencie-o no template da mensagem, assim um monitor disparado é diferente de uma recuperação. O Datadog também expõe $PRIORITY e $ALERT_STATUS, se você quiser incluí-los no texto.

### Posso separar produção e staging?

Registre um webhook por ambiente ou equipe e referencie o correto em cada monitor. Produção e staging chegam em canais separados, que você pode silenciar de forma independente.

### Preciso de outro agente?

Nada em um host. O Pocket Alert recebe o webhook que o Datadog envia do seu mecanismo de monitores, então não há nenhum agente extra além do Datadog Agent que você já executa.

### Posso mapear a gravidade do alerta para a prioridade da notificação?

Sim. Como você define o payload do webhook, adicione um campo "level" junto de $EVENT_TITLE — silent, low, default, high ou critical — e o Pocket Alert o mapeia para a prioridade da notificação. Envie critical a partir de um monitor de plantão para que ela fure o modo Não perturbe, ou defina default_level no webhook e omita o campo; um level explícito sempre prevalece. Um valor inválido volta para default, nunca é rejeitado.
