Документация

Статусы и жизненный цикл чека

У heartbeat-чека пять статусов. Понимание переходов между ними объясняет, когда именно придёт алерт — и почему иногда он (правильно) не приходит.

Статус	Что означает	Алерты
new	чек создан, ни одного пинга ещё не было	нет
up	пинги приходят вовремя	событие up при восстановлении после down
late	дедлайн (+ слак до 30 с) пропущен, идёт grace-период	событие late (если включено)
down	grace истёк либо задача явно сообщила о провале	событие down + напоминания
paused	мониторинг выключен вручную	нет

Почему new не алертит

Чек в статусе new не отслеживается планировщиком: дедлайна у него ещё нет — он появится только с первым пингом. Поэтому можно заранее создать чеки под будущие задачи (или раскатать конфигурацию деплоем): пока код не запушен и не пингует, ложных down не будет. Первый успешный пинг переводит чек в up и назначает первый дедлайн.

Дедлайн: period и cron

Дедлайн — момент, когда должен прийти следующий пинг. Считается от фактического времени последнего пинга:

• period — последний пинг + period_sec. Расписание «плавает»: задача, запускающаяся с дрейфом, не копит ошибку;
• cron — ближайшее срабатывание cron-выражения в таймзоне чека после последнего пинга. Переходы летнего времени учитываются таймзоной;
• OnCalendar — аналогично cron, по systemd-выражению.

Grace

Grace — допуск после дедлайна, страховка от дрожания расписания и долгих запусков: cron редко срабатывает секунда в секунду. Чек становится late не в саму секунду дедлайна, а спустя небольшой слак — дедлайн + min(grace, 30 сек): иначе минутный планировщик обгонял бы пинг, приходящий секундой позже расписания, и минутные cron-задачи мигали бы up↔late. Момент down слак не сдвигает — это по-прежнему дедлайн + grace_sec:

up ──(дедлайн + min(grace, 30 c))──▶ late ──(дедлайн + grace)──▶ down
 ▲                                                    │
 └────────────── любой успешный пинг ◀────────────────┘

При grace ≤ 30 сек late-окно схлопывается: порог late совпадает с моментом down, и чек переходит в down сразу. Grace задаётся на чек: от 0 до 30 дней. Переходы по времени выполняет планировщик с точностью до минуты. Алерт о down приходит в течение ~1–2 минут после истечения grace: просрочку находит минутный планировщик, сама доставка занимает секунды.

Мгновенный down

Явный сигнал провала минует grace: пинг на /<uuid>/fail или с ненулевым кодом выхода (/<uuid>/42) флипает чек в down сразу — задача сама сообщила, что упала, ждать нечего.

Восстановление, пауза и сброс

• из late и down чек возвращается в up первым же успешным пингом. Алерт «up» уходит только при восстановлении после down; переход late → up — это штатный чуть запоздавший пинг, о нём не алертим и в журнал доставки ничего не пишем;
• paused — ручная пауза: пинги не меняют статус, дедлайны не отслеживаются, алертов нет. У HTTP-чеков paused означает «не опрашивать»;
• сброс (кнопка «Сбросить» на странице чека) возвращает чек в new, как будто его только что создали: обнуляются последний пинг, длительность и дедлайн. История пингов и флипов при этом сохраняется — сам сброс виден в таймлайне отдельным событием. Отсчёт начнётся заново с первого пинга; удобно после долгого простоя или переноса задачи.

Нестабильные чеки (flap damping)

Чек, который часто прыгает между up и down («флапает»), способен за час прислать десятки одинаковых алертов. CronAlive гасит такой шторм автоматически:

• считаются алертируемые смены статуса — down и восстановление down → up — в скользящем окне длиной 1 час;
• на 6-й смене за час вместо обычного алерта уходит один алерт «чек нестабилен: N смен статуса за час, алерты приостановлены» — во все каналы, подписанные на down-события;
• дальнейшие down/up-алерты подавляются, но журналируются: в журнале доставки они видны со статусом suppressed и причиной «чек нестабилен (flap damping)» — всегда понятно, почему тихо;
• на странице чека рядом со статусом горит янтарный бейдж «нестабилен»;
• после 30 минут без единой смены статуса приходит алерт «стабилизировался, текущий статус: …» — в нём указано, с какого времени алерты были приостановлены, — и обычные алерты возобновляются.

late-алерты порог не двигают и не подавляются — это ранний сигнал. Ручные операции (пауза, возобновление, сброс) флипами не считаются. Значения по умолчанию: порог 6 смен, окно 1 час, тишина для выхода 30 минут.

Пауза, возобновление, удаление и назначение тегов работают и массово — отметьте чеки чекбоксами в списке. Со страницы чека доступны клонирование (конфигурация без истории) и перенос в другой проект аккаунта.

Статусы видны на дашборде, в API и на публичных бейджах; у HTTP-чеков вместо тайминга пингов работают K-подтверждения.