Faça os alertas do Grafana chegar ao seu celular.
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.
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.
Três passos para ter alertas do Grafana no seu celular
Crie um webhook
Crie um webhook do Pocket Alert com uma template de mensagem GJSON e copie a URL de recebimento.
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.
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.
Envie alertas do Grafana para o seu celular
1. Crie um webhook do Pocket Alert
Na página 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, 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 cobre todos os caminhos GJSON e opções de webhook.
Dúvidas respondidas
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.
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.
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.
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.
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.
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.
Veja o alerta antes que o painel fique vermelho.
Crie um aplicativo, copie a URL do webhook e adicione-a como ponto de contato do Grafana.