# Faça os alertas do Grafana chegar ao seu celular.

> Receba alertas do Grafana como notificações push. Adicione o Pocket Alert como contact point de webhook e veja os alertas disparados no seu celular em menos de um segundo.

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

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

Quando uma regra de alerta do Grafana dispara, o nome do alerta, a severidade e o status chegam ao seu celular em menos de um segundo. Veja problemas antes que o painel fique vermelho, sem precisar manter uma tela aberta.

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

1. **Crie um webhook** — Crie um webhook do Pocket Alert com uma template de mensagem GJSON e copie a URL de recebimento.
2. **Configure o ponto de contato** — Adicione a URL como ponto de contato do tipo Webhook no Alerting do Grafana e associe-o a uma política de notificação.
3. **Mapeie e envie** — O GJSON mapeia status, alertname, severidade e o resumo para a sua notificação push. O próximo alerta disparado faz o seu celular vibrar.

## Do painel em alerta à tela de bloqueio

O Grafana já dispara um webhook quando uma regra de alerta é acionada. O Pocket Alert transforma isso em uma notificação push que você não consegue ignorar.

- **Um ponto de contato padrão** — Adicione o Pocket Alert como ponto de contato do tipo Webhook no Alerting do Grafana. Sem plugin, sem agente, funciona no Cloud e em instalações auto-hospedadas.
- **Mapeie campos com GJSON** — Caminhos GJSON extraem alertname, status e a anotação summary diretamente do payload do Grafana para a sua notificação.
- **Severidade e status na notificação** — Mostre o rótulo de severidade e o status firing/resolved direto na notificação push, para que um alerta crítico seja diferente de uma recuperação.
- **Um canal por time** — Cada aplicativo tem sua própria URL de webhook, então alertas de infraestrutura, de aplicação e de cada time ficam em canais separados.
- **Entrega em menos de um segundo** — O alerta disparado chega ao seu celular em menos de um segundo, bem antes de alguém abrir o painel.
- **URL de webhook secreta** — A URL do webhook é o segredo do seu aplicativo, transmitido por HTTPS. Gere uma nova sempre que precisar de um endpoint novo.

## Envie alertas do Grafana para o seu celular

### 1. Crie um webhook do Pocket Alert

Na página [Webhooks](https://pocketalert.app/pt/webhooks), crie um webhook cuja template GJSON `message` leia o payload do Grafana. O Grafana envia `status`, um bloco `commonLabels` e um array `alerts`, então uma boa template é:

```
curl -X POST "https://api.pocketalert.app/v1/webhooks" \
  -H "Token: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Grafana","default_level":"critical","message":"[%status%] %commonLabels.alertname% (%commonLabels.severity%)\n%alerts.0.annotations.summary%","application_id":"qm47b9pzxzxg"}'
```

Você recebe uma URL de entrada como `https://p4a.me/wh/1234abcd`.

### 2. Adicione como ponto de contato do tipo Webhook

No Grafana, vá em [Alerting → Contact points → Add contact point](https://grafana.com/docs/grafana/latest/alerting/configure-notifications/manage-contact-points/integrations/webhook-notifier/), escolha a integração Webhook e cole a URL de recebimento:

```
Integration: Webhook
URL:    https://p4a.me/wh/1234abcd
Method: POST
```

Associe o ponto de contato a uma política de notificação para que os alertas correspondentes sejam roteados para ele. O Grafana envia seu JSON padrão; os caminhos GJSON acima extraem `status`, `commonLabels.alertname`, `commonLabels.severity` e `alerts.0.annotations.summary` para a notificação push.

### 3. Faça um teste

Use o botão Test do ponto de contato. Um alerta disparado chega como `[firing] HighCPU (critical)`; quando ele é normalizado, `status` muda para `resolved`.

A [documentação das 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 Grafana para o meu celular?

No Grafana, vá em Alerting → Contact points, adicione um ponto de contato do tipo Webhook e cole a URL do seu aplicativo Pocket Alert. Associe-o a uma política de notificação e o próximo alerta disparado chega ao seu celular em menos de um segundo.

### Como funciona o mapeamento de campos?

O Grafana envia um payload JSON com status, um bloco commonLabels e um array alerts. O Pocket Alert lê esses dados com caminhos GJSON, então você mapeia commonLabels.alertname para o título, alerts.0.annotations.summary para o corpo e status para mostrar firing ou resolved.

### Posso mostrar severidade e status?

Sim. O payload traz o rótulo de severidade em commonLabels.severity e um status de firing ou resolved. Use os dois na sua template de mensagem GJSON para que um alerta crítico disparado seja exibido de forma diferente de um alerta resolvido.

### Posso separar os alertas por time?

Dê a cada pasta ou time do Grafana o seu próprio aplicativo. Alertas de infraestrutura e de aplicação chegam em canais separados, e você pode silenciar um sem afetar o outro.

### Preciso de um plugin?

Nada extra. O Pocket Alert recebe o webhook que o Grafana já envia do seu mecanismo de alertas, então não há plugin nem agente para instalar. Funciona igualmente com o Grafana Cloud e com instalações auto-hospedadas.

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

Sim. Toda mensagem aceita um nível: silent, low, default, high ou critical. Inclua um campo "level" no payload ou defina default_level no webhook para que tudo roteado para ele chegue com essa prioridade; um level explícito no payload tem precedência. Uma divisão firing=critical, resolved=silent funciona bem: o alerta disparado atravessa o modo Não perturbe, enquanto a recuperação fica silenciosa no histórico. Um valor inválido volta para default e nunca é rejeitado.
