# Пусть алерты Datadog приходят на телефон.

> Получайте алерты мониторов Datadog как push-уведомления. Подключите Pocket Alert как вебхук и узнавайте о нарушениях на телефоне меньше чем за секунду.

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

Обновлено: 2026-08-11

Когда монитор Datadog срабатывает, алерт и его серьёзность приходят на ваш телефон меньше чем за секунду. Поймайте инцидент до того, как он превратится в вызов дежурного.

## Три шага до алертов Datadog на телефоне

1. **Создайте вебхук** — Создайте вебхук Pocket Alert с шаблоном сообщения GJSON и скопируйте его URL для приёма.
2. **Настройте вебхук** — Зарегистрируйте URL в интеграции Datadog Webhooks с собственным payload $EVENT_TITLE / $TEXT_ONLY_MSG, затем вызывайте его из монитора.
3. **Сопоставьте и отправьте** — GJSON сопоставит заголовок события, сообщение и переход состояния с вашим push-уведомлением. При следующем срабатывании телефон завибрирует.

## От сработавшего монитора до экрана блокировки

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 на телефон

### 1. Создайте вебхук Pocket Alert

На странице [Webhooks](https://pocketalert.app/ru/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](https://docs.datadoghq.com/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», когда состояние нормализуется.

В [документации по настройкам вебхуков](https://info.pocketalert.app/api/webhooks/settings.html) описаны все пути GJSON и параметры вебхука.

## Частые вопросы

### Как отправлять алерты Datadog на телефон?

Создайте вебхук 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?

Зарегистрируйте отдельный вебхук для каждого окружения или команды и указывайте нужный в каждом мониторе. Прод и staging попадут в разные каналы, которые можно отключать независимо.

### Нужен ли ещё один агент?

Ничего на хосте. Pocket Alert принимает вебхук, который Datadog отправляет из движка мониторов, поэтому никаких дополнительных агентов, кроме уже запущенного Datadog Agent, не нужно.

### Можно ли сопоставить серьёзность алерта с приоритетом уведомления?

Да. Так как payload вебхука вы задаёте сами, добавьте поле "level" рядом с $EVENT_TITLE со значением silent, low, default, high или critical. Pocket Alert сопоставит его с приоритетом уведомления. Отправляйте critical из монитора, который должен будить вас, чтобы уведомление проходило режим «Не беспокоить». Либо задайте default_level в вебхуке и не добавляйте поле вовсе. Явно указанный level всегда имеет приоритет. Некорректное значение заменяется на default и никогда не отклоняется.
