# Узнайте, когда ваша база данных перестала отвечать.

> Получайте push-уведомления, когда ломается база данных. Потеря соединения с Postgres, MySQL или Redis, отставание репликации или заполненный диск — сообщение придёт на телефон меньше чем за секунду.

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

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

Неудачная проверка состояния, отстающая реплика, диск, который неумолимо заполняется. Ваш мониторинг отправляет вебхук в Pocket Alert, и уведомление доходит до телефона менее чем за секунду. Работает с Postgres, MySQL, Redis и MongoDB и не требует агента на сервере с базой данных.

## Три шага до оповещений о базе данных на телефоне

1. **Создайте вебхук или ключ** — Создайте API-ключ для cron-скрипта или вебхук и скопируйте его URL приёма.
2. **Направьте мониторинг на него** — Добавьте URL приёма в Grafana, Alertmanager или pgwatch либо выполняйте curl к API сообщений из cron-проверки состояния.
3. **Получайте оповещения** — Неудачная проверка запускает оповещение, и телефон вибрирует менее чем за секунду. Для основной базы и реплик используйте отдельные вебхуки.

## От менеджера оповещений до вашего кармана

Ваш мониторинг уже знает, когда база данных работает неправильно. Pocket Alert доставляет это на ваш телефон.

- **Все типы сбоев** — Отказ в соединении, отставание репликации сверх порога, накопление WAL, почти заполненный диск. Любая проверка, которую запускает ваш мониторинг, может отправить push-уведомление.
- **Работает с вашим стеком** — Grafana, Prometheus Alertmanager, pgwatch, Datadog и Zabbix отправляют POST-запросы на URL вебхука, который вы уже настроили для других оповещений.
- **Важность в заголовке** — Падение основной базы и предупреждение о задержке реплики приходят как разные оповещения. Маппинг GJSON берёт уровень важности из payload и выводит его в заголовок.
- **Каналы для каждой базы** — Для каждой базы данных создаётся отдельное приложение, поэтому прод, staging и реплика для аналитики никогда не используют один канал.
- **Доставка за доли секунды** — Push-уведомления приходят значительно быстрее секунды, этого достаточно, чтобы начать переключение на резерв до того, как опустеет пул соединений.
- **Агент не нужен** — Ничего не нужно устанавливать на сервер с БД. Работу выполняет мониторинг, который у вас уже запущен.

## Подключите мониторинг базы данных к телефону

### 1. Отправляйте POST прямо из скрипта проверки состояния

Проверка pg_isready или запрос к медленным запросам и количеству соединений в cron-скрипте может выполнить curl к API сообщений с вашим API-ключом в заголовке Token:

```
#!/usr/bin/env bash
# /usr/local/bin/pg-health.sh (run from cron)
if ! pg_isready -h prod-db -p 5432 -q; then
  curl -X POST "https://api.pocketalert.app/v1/messages" \
    -H "Token: YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"title":"Postgres down","message":"prod-db: connection refused on 5432","level":"critical"}'
fi
```

Поле `"level":"critical"` делает так, что это push-уведомление обходит режим «Не беспокоить», поэтому сбой основной базы в 3 часа ночи действительно до вас дойдёт. На странице [критических оповещений](https://pocketalert.app/ru/use-cases/critical-alerts) описано, как работают уровни важности.

Тот же подход работает для отставания репликации или заполненного тома данных:

```
LAG=$(psql -tA -c "SELECT EXTRACT(EPOCH FROM (now() - pg_last_xact_replay_timestamp()))::int")
[ "$LAG" -gt 120 ] && curl -X POST "https://api.pocketalert.app/v1/messages" \
  -H "Token: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"title\":\"Replication lag\",\"message\":\"replica-1 is ${LAG}s behind primary\"}"
```

### 2. Или создайте вебхук для менеджера оповещений

Создайте вебхук с шаблоном GJSON для `message`, который сопоставляет payload вашего инструмента. Grafana, Alertmanager, pgwatch, Datadog и Zabbix отправляют POST-запросы со своим JSON:

```
curl -X POST "https://api.pocketalert.app/v1/webhooks" \
  -H "Token: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Alertmanager","message":"%alerts.0.labels.alertname%: %alerts.0.annotations.summary%","application_id":"qm47b9pzxzxg"}'
```

Укажите URL приёма `https://p4a.me/wh/1234abcd` в получателе вебхука менеджера оповещений. Cron-проверка также может отправить простой JSON на тот же URL приёма.

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

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

### Как получать push-уведомление, когда база данных падает?

Настройте стек мониторинга так, чтобы при срабатывании проверки он отправлял POST-запрос на вебхук Pocket Alert. Grafana, Prometheus Alertmanager, pgwatch, Datadog и Zabbix поддерживают исходящие вебхуки, а cron-скрипт проверки состояния может выполнить curl на тот же URL.

### Какие базы данных поддерживаются?

Работают Postgres, MySQL, Redis и MongoDB. Pocket Alert читает JSON, который отправляют ваши инструменты, поэтому движок базы данных не имеет значения. Если система может отправить вебхук или запустить скрипт проверки, уведомление дойдёт до вашего телефона.

### Можно ли отличить сбой основной базы от предупреждения о задержке?

Настройте отдельные вебхуки для основной базы и реплик или используйте шаблон GJSON, который берёт уровень важности из payload и подставляет его в заголовок. Тогда сбой основной базы и предупреждение о задержке реплики будут различаться сразу при получении.

### Как разделить оповещения прода и staging?

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

### Нужен ли агент на сервере с базой данных?

Нет. Pocket Alert не запускает агент на хосте с базой данных. Любой имеющийся у вас мониторинг или скрипт проверки состояния отправляет вебхук, а push-уведомления приходят менее чем за секунду.

### Может ли уведомление о падении базы разбудить меня ночью?

Да. Отправьте уведомление с level=critical или задайте default_level равным critical для вебхука, чтобы всё, что он получает, было громким. На Android критические уведомления публикуются в отдельном канале, который обходит режим «Не беспокоить» после предоставления доступа к DND, и может занять экран. На iPhone оно приходит как чувствительное ко времени уведомление, которое пробивает «Фокусирование». На бесплатном тарифе critical доставляется с приоритетом high: по-прежнему мгновенно, но без обхода DND.
