- Главная
- Документация
- Heartbeat мониторинг
Heartbeat мониторинг
Входящие запросы от ваших задач или сервисов
| Функция | Free | Pro | Team |
|---|---|---|---|
| Heartbeat мониторинг | — | Есть | Есть |
То же можно сделать программно — запросом к публичному API из скрипта или CI, либо через MCP-сервер, если задачу выполняет ИИ-ассистент. Понадобится API-ключ, создать его можно на любом тарифе. Ограничения тарифа в API те же, что в интерфейсе.
Heartbeat — это мониторинг для задач и фоновых процессов без публичного HTTP/TCP‑эндпоинта. Вместо активных проверок из локаций Statuser вы сами отправляете сигнал (heartbeat) по расписанию. Если сигнал не пришёл вовремя, создаётся инцидент.
Heartbeat подходит для cron‑задач, бэкапов, ETL‑процессов, CI/CD‑шагов и любых периодических скриптов.
Как это работает
После создания сервера с типом мониторинга Heartbeat Statuser выдаёт уникальный heartbeat_token и URL.
- задача выполняется и отправляет heartbeat
- если heartbeat не пришёл в ожидаемый интервал — создаётся инцидент
- следующий успешный heartbeat автоматически закрывает инцидент
Поддерживаются методы GET, POST и HEAD. Успешный запрос возвращает
204 No Content. Endpoint /fail используется для явного сообщения об
ошибке выполнения задачи.
Пример: cron‑задача
Пример ежедневного бэкапа с использованием Heartbeat:
#!/bin/bash
set -e
# выполняем задачу
pg_dump mydb > backup.sql
# сообщаем об успехе
curl -fsS -X POST "https://hb.statuser.cloud/<token>"Если задача завершилась с ошибкой:
curl -fsS -X POST "https://hb.statuser.cloud/<token>/fail"Инциденты не создаются до получения первого heartbeat. Рекомендуется отправить первый запрос сразу после настройки мониторинга, чтобы Statuser начал отслеживание интервалов.