Heartbeat резервной копии отправляют только после успешного завершения задания и проверки созданного архива. Рабочая схема: временный файл → проверка формата → атомарное переименование → локальная запись размера → запрос к монитору. HTTP 200 от endpoint сам по себе не доказывает, что правильный монитор получил сигнал; это нужно сверить в кабинете.

Проверка «скрипт запускается по cron» не отвечает на вопрос, сохранились ли данные. Heartbeat сигнализирует, что задача достигла определённой точки. Поэтому поставьте его после всех проверок, а не в начале скрипта и не в блоке finally. Пассивный монитор затем заметит пропуск ожидаемого запуска; настроить его можно на странице heartbeat enterno. Для общей схемы мониторинга задач смотрите руководство по доступности, но не путайте HTTP-проверку сайта с фактом готовности архива.

Проверка архива предшествует сигналу
В репозитории лежит исполняемый backup_and_ping.sh для каталога файлов. Он использует set -euo pipefail, удаляет недописанный .partial при ошибке, проверяет, что tar-архив непустой и читается, затем переносит его на конечное имя. Только после этого вызывается heartbeat. GNU tar описывает проверку и просмотр содержимого архива; перечисление файлов проверяет структуру, но не заменяет тестовое восстановление.
export BACKUP_SOURCE=/srv/app-data
export BACKUP_DEST=/srv/backups/app-$(date -u +%F).tar.gz
export HEARTBEAT_URL=https://enterno.io/api/heartbeat/ВАШ_СЕКРЕТНЫЙ_ТОКЕН
flock -n /run/lock/app-backup.lock bash backup_and_ping.sh
# Локальный стенд: success → backup_bytes=161, heartbeat_sent=1
# missing-source → exit 2, архив отсутствует, запросов к receiver: 0
Пример локального стенда создал маленький архив 161 байт и отправил один запрос в тестовый receiver. При отсутствующем каталоге tar завершился с кодом 2: итогового архива и heartbeat не было. Исходный скрипт, стенд method.py и машинный вывод в data.json. Число 161 относится только к фикстуре; размер реального бэкапа зависит от данных. flock в cron не даёт двум запускам писать один файл одновременно; путь и права каталога нужно настроить под свою систему.
| Этап | Условие продолжения | Что фиксировать |
|---|---|---|
| Создание | Команда завершилась с exit 0 | Ошибка stderr и длительность |
| Проверка | Файл непустой, формат читается | Размер и контрольная сумма локально |
| Публикация | Файл переименован в постоянное имя | Время и путь без секретов |
| Heartbeat | Все предыдущие шаги успешны | Последний принятый сигнал в кабинете |
Для БД используйте проверку её формата
Файловый tar не равен резервной копии работающей БД. Для MariaDB рассмотрите mariadb-dump --single-transaction --quick с проверкой кода всего конвейера через pipefail; документация MariaDB отдельно оговаривает согласованность транзакционных таблиц. Для PostgreSQL архив pg_dump -Fc можно перечислить через pg_restore -l, согласно руководству PostgreSQL. Для restic успешный код 0 означает полный снимок; код 3 означает неполный из-за непрочитанных файлов и не должен запускать «успешный» heartbeat по документации restic. Эти варианты требуют отдельного теста восстановления на ваших данных: в нашем стенде выполнялся только tar.
Контрольную сумму и размер полезно писать в локальный журнал или защищённую метрику. Текущий endpoint enterno /api/heartbeat/{token} не хранит переданный размер архива как отдельное поле; добавление ?size=... к URL не создаст эту метрику. Не обещайте её в отчёте. Монитор обнаруживает пропущенный сигнал, а проверка хранения и восстановления — отдельные задачи. Периодическую проверку внешнего сайта сопоставьте с проверкой содержимого. При планировании запуска используйте чек-лист мониторинга.
HTTP 200 не подтверждает правильный токен
Для защиты от перечисления токенов endpoint одинаково отвечает на неизвестный и неактивный токен: в нашей безопасной проверке выдуманного токена он вернул HTTP 200 и JSON {"status":"ok","msg":"Acknowledged"}. Поэтому после настройки выполните один разрешённый тестовый запуск и посмотрите в личном кабинете время последнего ping именно нужного heartbeat-монитора. Если оно не изменилось, проверяйте токен, статус монитора и адрес. Сам HTTP-код ничего не доказал.
Храните URL с токеном в файле конфигурации с ограниченными правами и не включайте set -x. Не отправляйте его в общие CI-логи. Для периодического задания задайте интервал и допустимое опоздание так, чтобы долгий, но нормальный backup не выглядел пропущенным. Если cron отключён намеренно на выходные, настройте расписание heartbeat, а не игнорируйте все алерты. После первого успешного сигнала выключите запуск на стенде и проверьте, что пропуск действительно обнаруживается. Не делайте этот опыт на единственном продовом бэкапе.
Как сделан материал
Локальный тест запускал настоящий Bash-скрипт с tar на временном каталоге и HTTP receiver на 127.0.0.1: один успешный и один аварийный случай, без реальной БД и без рабочего токена. Отдельный GET с выдуманным токеном подтвердил публичный ответ endpoint; он не менял монитор. Исходники в папке темы. SerpAPI сохранил выдачу Google US и Яндекса; Wordstat региона 225 не вернул оценку точной фразы, широкая «мониторинг резервного копирования» дала 411. Широкий спрос не приписывается heartbeat.
Частые вопросы
Почему heartbeat есть, а архив повреждён?
Сигнал, вероятно, отправляется до проверки или проверка недостаточна. Добавьте форматную проверку и периодическое восстановление на отдельном стенде.
Можно ли считать HTTP 200 подтверждением ping?
Нет. Сверьте время последнего сигнала в нужном мониторе; неизвестный токен тоже получает 200.
Как передать размер архива в enterno?
Текущий heartbeat endpoint не сохраняет размер как метрику. Записывайте байты в локальный журнал или отдельную систему метрик.
Должен ли restic exit 3 отправлять heartbeat?
Не как «полный успех»: restic сообщает о неполном снимке. Разберите непрочитанные файлы и используйте отдельное уведомление об ошибке.