Heartbeat мониторинг

Входящие запросы от ваших задач или сервисов

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 начал отслеживание интервалов.

Виды мониторингаМониторинг медленных ответов