Оповещения Grafana доходят до телефона.
Когда срабатывает правило оповещения Grafana, название оповещения, важность и статус появляются на вашем телефоне меньше чем за секунду. Узнавайте о проблемах раньше, чем панель покраснеет, и не держите экран открытым.
От сработавшей панели до экрана блокировки
Grafana уже отправляет вебхук, когда срабатывает правило оповещения. Pocket Alert превращает его в push-уведомление, которое нельзя пропустить.
Стандартная точка контакта
Добавьте Pocket Alert как точку контакта Webhook в Grafana Alerting. Без плагина и агента, работает в Cloud и self-hosted.
Сопоставление полей через GJSON
Пути GJSON берут alertname, status и аннотацию summary прямо из payload Grafana и подставляют их в уведомление.
Важность и статус в тексте
Показывайте метку severity и статус firing/resolved прямо в push-уведомлении, чтобы критическое оповещение отличалось от восстановления.
Канал для каждой команды
У каждого приложения свой URL вебхука, поэтому оповещения инфраструктуры, приложений и отдельных команд остаются в разных каналах.
Доставка за доли секунды
Сработавшее оповещение попадает на ваш телефон меньше чем за секунду, задолго до того, как кто-то откроет панель.
Секретный URL вебхука
URL вебхука — это секрет вашего приложения, передаваемый по HTTPS. Перевыпускайте его, когда нужна новая конечная точка.
Три шага до оповещений Grafana на телефоне
Создайте вебхук
Создайте вебхук Pocket Alert с шаблоном сообщения GJSON и скопируйте его URL для приёма.
Подключите точку контакта
Добавьте URL как точку контакта Webhook в Grafana Alerting и привяжите её к политике уведомлений.
Сопоставьте поля и отправьте
GJSON передаёт в push-уведомление status, alertname, severity и summary. Следующее сработавшее оповещение заставит телефон вибрировать.
Отправка оповещений Grafana на телефон
1. Создайте вебхук Pocket Alert
На странице Webhooks создайте вебхук, шаблон GJSON message которого читает payload Grafana. Grafana отправляет status, блок commonLabels и массив alerts, поэтому подходящий шаблон выглядит так:
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"}'
Вы получите входящий URL вида https://p4a.me/wh/1234abcd.
2. Добавьте его как точку контакта Webhook
В Grafana перейдите в Alerting → Contact points → Add contact point, выберите интеграцию Webhook и вставьте URL для приёма:
Integration: Webhook
URL: https://p4a.me/wh/1234abcd
Method: POST
Привяжите точку контакта к политике уведомлений, чтобы подходящие оповещения направлялись в неё. Grafana отправляет стандартный JSON; пути GJSON выше передают status, commonLabels.alertname, commonLabels.severity и alerts.0.annotations.summary в push-уведомление.
3. Отправьте тестовое оповещение
Нажмите кнопку Test у точки контакта. Сработавшее оповещение придёт как [firing] HighCPU (critical); когда оно закроется, status изменится на resolved.
В документации по настройкам вебхуков описаны все пути GJSON и параметры вебхука.
Ответы на вопросы
В Grafana перейдите в Alerting → Contact points, добавьте точку контакта Webhook и вставьте URL вашего приложения Pocket Alert. Привяжите её к политике уведомлений, и следующее сработавшее оповещение придёт на телефон меньше чем за секунду.
Grafana отправляет JSON-payload с полями status, блоком commonLabels и массивом alerts. Pocket Alert читает его по путям GJSON, поэтому сопоставьте commonLabels.alertname с заголовком, alerts.0.annotations.summary с текстом, а status используйте для вывода firing или resolved.
Да. Payload содержит метку severity в commonLabels.severity и статус firing или resolved. Используйте оба значения в шаблоне сообщения GJSON, чтобы критическое сработавшее оповещение отличалось от восстановления.
Создайте отдельное приложение для каждой папки или команды Grafana. Оповещения инфраструктуры и приложений попадут в разные каналы, и вы сможете отключить один из них, не трогая другой.
Ничего дополнительного. Pocket Alert получает вебхук, который Grafana уже отправляет из своего движка оповещений, поэтому не нужно устанавливать плагин или агент. Работает и с Grafana Cloud, и с self-hosted версией.
Да. Каждое сообщение принимает уровень: silent, low, default, high или critical. Добавьте поле "level" в payload или задайте default_level для вебхука, чтобы все сообщения, направленные в него, получали этот приоритет; явно указанный level в payload имеет приоритет. Удобно разделить так: firing=critical, resolved=silent. Сработавшее оповещение пробьётся через режим «Не беспокоить», а восстановление останется тихим в истории. Некорректное значение заменяется на default и никогда не отклоняется.
Увидьте оповещение раньше, чем панель покраснеет.
Создайте приложение, скопируйте его URL вебхука и добавьте его как точку контакта Grafana.