Для закрытого адреса запускайте проверку внутри сети и отправляйте heartbeat только после успешного ответа приложения. Если локальная проверка упала, сигнал не придёт и монитор обнаружит пропуск. Такой подход подтверждает путь из вашей сети, а не доступность сервиса извне.

Публичный HTTP-монитор не увидит endpoint в приватной VPC или за VPN. Публиковать его ради мониторинга опасно и обычно не требуется. Агент внутри сети может проверить статус, тело ответа и затем отправить короткий запрос на публичный heartbeat-адрес. Мы проверили этот порядок на локальном стенде: при ошибке приватного endpoint сигнал не уходил.
Что понадобится
- Хост, контейнер или CronJob с доступом к приватному адресу и внешнему heartbeat-URL.
- Ответ приложения, в котором можно отличить готовность от ошибки. В примере это HTTP 200 и строка
"ready":true. - Отдельный heartbeat-монитор и расписание с запасом на сеть и перезапуски.
- Безопасное хранение URL heartbeat: сам адрес может служить токеном отправки.
Шаг 1. Определите контракт готовности
Статус 200 у reverse proxy ещё не доказывает готовность базы или очереди. Для критичного endpoint добавьте лёгкую проверку зависимости и явный маркер в ответе. Не помещайте в ответ секреты, версии внутренних компонентов или персональные данные. При деградации возвращайте код, который скрипт распознает как ошибку.
Для чувствительной службы полезно завести отдельный /ready, доступный только из внутренней сети. Проверка должна занимать заметно меньше интервала запуска. Если она иногда длится 40 секунд, минутный cron с последующим повтором может перекрывать предыдущий запуск.
Шаг 2. Запускайте проверку перед heartbeat
Пример check_and_ping.sh в материалах партии использует curl с ограничением времени, проверяет HTTP-код и маркер тела, затем отправляет heartbeat. В нём ограничен таймаут локальной проверки, а повтор разрешён для отправки heartbeat; повторный ping не меняет результат проверки сервиса.
PRIVATE_URL=http://service.internal/ready \
HEARTBEAT_URL=https://enterno.io/hb/EXAMPLE_TOKEN \
./check_and_ping.sh
# healthy fixture: exit 0, heartbeat received: 1
# failing fixture: exit 22, heartbeat received: 0
Указанный токен примерный. Фактический адрес выдаёт ваш монитор. Не включайте set -x, если переменные окружения содержат URL с секретом. Для разборов храните код локального ответа и время выполнения, но маскируйте адрес heartbeat в журналах.
Шаг 3. Поставьте расписание
В systemd timer запуск каждые 5 минут даёт понятный предел обнаружения; grace period heartbeat должен быть длиннее одного интервала и времени выполнения. Например, интервал 5 минут, timeout 15 секунд, одна повторная попытка и grace около 12 минут дают запас для единичного пропуска. Это пример настройки, не универсальный SLA.
[Timer]
OnBootSec=2min
OnUnitActiveSec=5min
Persistent=true
[Install]
WantedBy=timers.target
Для Kubernetes используйте CronJob с образом, в котором есть curl, Secret для URL и concurrencyPolicy: Forbid, если параллельные проверки вредят сервису. При этой политике пропущенный запуск не исполняется параллельно позже; настройте окно heartbeat с учётом расписания и возможных пропусков. Официальная документация CronJob описывает его приблизительную природу: приложение должно переносить повторные запуски.

Проверяйте отсутствие сигнала и качество локального теста
В heartbeat-мониторе enterno.io задайте интервал и допустимое опоздание. После настройки принудительно вызовите ошибку на тестовом endpoint: локальный скрипт должен завершиться неуспешно, heartbeat не должен отправиться, а монитор — зарегистрировать пропуск после grace. Затем восстановите endpoint и подтвердите возврат сигнала. Создание монитора без негативного теста не доказывает работоспособность цепочки.
Heartbeat говорит, что агент успешно прошёл свою проверку. Он не подтверждает путь от пользователя до публичного сайта. Для внешней доступности нужен отдельный HTTP-монитор; для действий в браузере — синтетический сценарий. Если частная сеть связана с платежами, проверяйте и состояние заказа по платёжному сценарию.
Если сигнал пропал
| Признак | Что проверить | Действие |
|---|---|---|
| Нет локального запуска | Таймер, CronJob, события планировщика | Восстановить расписание и добавить контроль агента |
| Скрипт завершился с ошибкой | Код HTTP, маркер готовности, DNS внутри сети | Исправить сервис или маршрут |
| Проверка прошла, ping не ушёл | Исходящий DNS, TLS, firewall | Проверить путь до heartbeat |
| Ping есть, тревога остаётся | Неверный URL или окно ожидания | Сверить токен и расписание |
Разделяйте ошибки агента и ошибки приложения. Если запланированный контейнер не стартовал, отсутствие heartbeat выглядит так же, как неготовность сервиса. Поэтому полезен второй контроль инфраструктуры запуска и журнал попыток без секретных данных.
Планировщик и сеть: два независимых места отказа
Для systemd создайте отдельный service unit с Type=oneshot, непривилегированным пользователем и ограничением времени запуска. Timer только назначает время; он не гарантирует, что скрипт выполнился успешно. Посмотрите systemctl list-timers, а затем журнал service unit с кодом завершения. Если интервал меняли, проверьте фактическое следующее срабатывание после daemon-reload. При перезагрузке сервера Persistent=true помогает запустить пропущенный календарный таймер, но не заменяет контроль самого сервера.
Для Kubernetes проверяйте не только объект CronJob, но и созданные Jobs и Pods. Ошибка скачивания образа, нехватка ресурсов или запрет сетевой политики могут остановить проверку до первой команды curl. Выделите короткий deadline и ограничьте число одновременных запусков. В кластере с несколькими зонами решите, откуда именно должен измеряться путь: один pod в одной зоне не проверит доступность из другой. Если требуется несколько точек, создайте отдельные мониторы и подпишите их по зоне.
Исходящий маршрут тоже может отказать. Если приватный endpoint готов, но DNS для публичного heartbeat не разрешается, сигнал пропадёт. Это корректная тревога о невозможности подтвердить состояние, но её причина находится вне приложения. Логируйте отдельно результат внутреннего curl и внешнего ping. Не меняйте логику так, чтобы при ошибке внешнего ping скрипт завершался успехом: иначе планировщик покажет зелёный запуск при отсутствии данных у монитора.
Настройте срок ожидания на реальном отказе
Посчитайте максимальный нормальный разрыв между сигналами. При интервале 5 минут и одном пропуске следующий ping может прийти примерно через 10 минут, а длительность проверки добавит ещё секунды. Поэтому окно около 12 минут в нашем примере защищает от единичного пропуска, но обнаруживает устойчивый отказ позже. Если бизнесу нужно узнать о сбое за 3 минуты, этот график не подходит: уменьшите интервал, разнесите точки запуска или добавьте прямой монитор, если endpoint доступен снаружи.
Проверьте настройки тремя пробами. Сначала запустите скрипт при готовом сервисе и убедитесь, что время последнего heartbeat обновилось. Затем заставьте тестовый endpoint вернуть 503: запуск должен завершиться с ошибкой, а новый сигнал не должен появиться. Наконец, остановите сам планировщик и убедитесь, что отсутствие запуска обнаруживается так же. Это разные причины одного алерта; локальный журнал и статус scheduler помогут выбрать нужную команду для расследования.
Не используйте рабочий heartbeat URL при публичной демонстрации команды или в issue. Его следует ротировать после случайной публикации, потому что посторонний запрос способен создать ложный сигнал готовности. В документации команды оставляйте только примерный токен и инструкцию, где получить настоящий адрес внутри защищённого кабинета.
Для резервной проверки планировщика полезен отдельный пример heartbeat фонового задания: там сигнал отправляется только после проверки результата. Если два агента видят один сервис, дайте им разные токены и явно определите, какой отказ должен вызвать тревогу. Иначе один здоровый агент способен скрыть неисправность второго и задержать поиск причины до следующей ручной проверки.
Как сделан материал
14 ноября 2026 года мы запустили Bash-скрипт с локальным приватным HTTP endpoint и локальным приёмником heartbeat. При ответе готовности он отправил один сигнал и завершился с кодом 0. При неготовности завершился с кодом 22 и не отправил ни одного сигнала. Данные находятся рядом с исходником. Реальный приватный сервис и рабочий heartbeat-монитор в этом тесте не создавались.
Частые вопросы
Нужен ли публичный доступ к закрытому endpoint?
Нет. Агент проверяет endpoint внутри сети, наружу выходит только heartbeat. Ограничьте исходящий доступ агента нужными адресами.
Можно ли посылать ping до проверки?
Тогда heartbeat будет подтверждать только запуск агента. Отправляйте его после успешной проверки, если нужен сигнал о готовности приложения.
Сколько ждать перед тревогой?
Окно должно включать интервал, время проверки и разумный запас на один пропуск. Проверьте настройку на тестовом сбое и соотнесите задержку с вашим SLA.