Перейти к содержимому
EN
← Все статьи

Heartbeat резервной копии: сигнал только после готового архива

Коротко:

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

Завершённый архив на хранилище передаёт сигнал мониторингу
Heartbeat должен означать завершённую, проверенную операцию.

Проверка «скрипт запускается по 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 сообщает о неполном снимке. Разберите непрочитанные файлы и используйте отдельное уведомление об ошибке.

Источники

Проверьте ваш сайт прямо сейчас

Следить за сайтом непрерывно →
Другие статьи: Мониторинг
Мониторинг
Как отсутствие резервирования приводит к сбоям в работе веб-сервисов
04.10.2026 · 2 056 просм.
Мониторинг
Почему не открывается сайт: причины и чек-лист проверки
23.06.2026 · 1 259 просм.
Мониторинг
Проектирование health check эндпоинтов для веб-сервисов
16.03.2026 · 1 122 просм.
Мониторинг
Uptime и SLA: что значит 99,9% и как считать доступность
13.03.2026 · 1 116 просм.