Пусть алерты Datadog приходят на телефон.
Когда монитор Datadog срабатывает, алерт и его серьёзность приходят на ваш телефон меньше чем за секунду. Поймайте инцидент до того, как он превратится в вызов дежурного.
От сработавшего монитора до экрана блокировки
Datadog уже отправляет вебхук, когда монитор срабатывает. Pocket Alert превращает его в push-уведомление, которое невозможно пропустить.
Подключается к вебхукам Datadog
Зарегистрируйте Pocket Alert в интеграции Datadog Webhooks и вызывайте его через @webhook-pocketalert из любого монитора.
Переменные шаблона на входе, GJSON на выходе
Шаблонные переменные Datadog заполняют JSON-тело. Пути GJSON в Pocket Alert извлекают заголовок события, сообщение и переход состояния для вашего уведомления.
Срабатывание и восстановление
Сопоставьте $ALERT_TRANSITION, чтобы срабатывание монитора отличалось от восстановления прямо на экране блокировки.
Канал на каждое окружение
У каждого приложения свой URL вебхука, поэтому инфраструктурные, APM и командные мониторы остаются в отдельных каналах.
Доставка за доли секунды
Нарушение попадает на ваш телефон меньше чем за секунду, задолго до срабатывания политики эскалации.
Секретный URL вебхука
URL вебхука по HTTPS — это секрет вашего приложения. Перевыпускайте его, когда нужна новая конечная точка.
Три шага до алертов Datadog на телефоне
Создайте вебхук
Создайте вебхук Pocket Alert с шаблоном сообщения GJSON и скопируйте его URL для приёма.
Настройте вебхук
Зарегистрируйте URL в интеграции Datadog Webhooks с собственным payload $EVENT_TITLE / $TEXT_ONLY_MSG, затем вызывайте его из монитора.
Сопоставьте и отправьте
GJSON сопоставит заголовок события, сообщение и переход состояния с вашим push-уведомлением. При следующем срабатывании телефон завибрирует.
Отправка алертов Datadog на телефон
1. Создайте вебхук Pocket Alert
На странице Webhooks создайте вебхук с шаблоном сообщения GJSON message, который сопоставляет payload Datadog, который вы будете отправлять. Также его можно создать через 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"}'
Вы получите входящий URL вида https://p4a.me/wh/1234abcd. Пути GJSON выше (%event_title%, %alert_transition%, %body%, %link%) читают ключи JSON, которые Datadog отправит на следующем шаге.
2. Зарегистрируйте вебхук в Datadog
Откройте Integrations → Webhooks и добавьте новый вебхук. Вставьте URL для приёма и задайте собственный payload с шаблонными переменными 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. Вызовите вебхук из монитора
Добавьте @webhook-pocketalert в сообщение монитора. Когда монитор срабатывает, Datadog отправляет payload выше; Pocket Alert формирует сообщение по шаблону GJSON и отправляет push-уведомление. При восстановлении передаётся $ALERT_TRANSITION = Recovered, поэтому тот же алерт покажет «Recovered», когда состояние нормализуется.
В документации по настройкам вебхуков описаны все пути GJSON и параметры вебхука.
Ответы на вопросы
Создайте вебхук Pocket Alert, скопируйте его URL для приёма и зарегистрируйте его в Datadog в разделе Integrations → Webhooks. Вызывайте его через @webhook-pocketalert в сообщении любого монитора, и алерт придёт на ваш телефон меньше чем за секунду.
В вебхуке Datadog вы задаёте JSON-тело с шаблонными переменными, например $EVENT_TITLE, $TEXT_ONLY_MSG, $ALERT_TRANSITION и $LINK. Pocket Alert читает этот JSON с помощью путей GJSON, поэтому шаблон сообщения сопоставляет эти поля с заголовком и текстом уведомления.
Да. Добавьте в payload $ALERT_TRANSITION (Triggered / Recovered) или $ALERT_TYPE и используйте его в шаблоне сообщения, чтобы срабатывание монитора отличалось от восстановления. Datadog также передаёт $PRIORITY и $ALERT_STATUS, если хотите видеть их в тексте.
Зарегистрируйте отдельный вебхук для каждого окружения или команды и указывайте нужный в каждом мониторе. Прод и staging попадут в разные каналы, которые можно отключать независимо.
Ничего на хосте. Pocket Alert принимает вебхук, который Datadog отправляет из движка мониторов, поэтому никаких дополнительных агентов, кроме уже запущенного Datadog Agent, не нужно.
Да. Так как payload вебхука вы задаёте сами, добавьте поле "level" рядом с $EVENT_TITLE со значением silent, low, default, high или critical. Pocket Alert сопоставит его с приоритетом уведомления. Отправляйте critical из монитора, который должен будить вас, чтобы уведомление проходило режим «Не беспокоить». Либо задайте default_level в вебхуке и не добавляйте поле вовсе. Явно указанный level всегда имеет приоритет. Некорректное значение заменяется на default и никогда не отклоняется.
Поймайте нарушение до эскалации.
Создайте приложение, скопируйте его URL вебхука и зарегистрируйте его как интеграцию вебхуков Datadog.