Как добавить health check — эндпоинт, который скажет, что приложение живо

Приложение задеплоено, адрес открывается — вроде живое. А потом оно тихо зависает ночью, и ты узнаёшь об этом утром из сообщения пользователя.
Health check — это адрес вроде /healthz, который отвечает «я работаю». По нему стучится хостинг, оркестратор или внешний пингер. Не ответил — перезапускают или будят тебя.
Сделать его — минут пятнадцать. Но есть одна ошибка, которая превращает health check из страховки в причину аварии. С неё и начнём — а потом соберём по шагам.
Главная ошибка: проверка, которая ходит в базу
Логика кажется железной: «раз проверяем здоровье — проверим и базу, без неё приложение всё равно бесполезно».
А дальше происходит вот что. База на десять секунд задумалась под нагрузкой. Health check не дождался ответа и вернул ошибку — на всех инстансах сразу, они же ходят в одну базу. Оркестратор видит, что все умерли, и дружно их перезапускает. Инстансы поднимаются, разом идут в базу за соединениями — и добивают её окончательно.
База моргнула — приложение легло полностью. Само себя убило собственной проверкой.
Это не теория: документация Kubernetes прямо предупреждает, что неаккуратно настроенные liveness-пробы приводят к каскадным сбоям, когда контейнеры перезапускаются без нужды под нагрузкой.
Отсюда правило: проверка «жив ли я» не должна зависеть ни от чего внешнего.
Шаг 1. Сделай /healthz — он не проверяет ничего
Первый эндпоинт отвечает на один вопрос: процесс жив и способен обработать запрос? Всё. Никаких походов в базу, кэш или чужие API.
app.get('/healthz', (req, res) => {
res.status(200).json({ status: 'ok' })
})
Выглядит бессмысленно — но именно в этом смысл. Если этот адрес не ответил, значит процесс завис, кончилась память или упал event loop. Тут перезапуск реально поможет. А если упала база — перезапуск не поможет, и трогать приложение не надо.
Шаг 2. Сделай /ready — вот он проверяет зависимости
Второй эндпоинт отвечает на другой вопрос: могу ли я прямо сейчас обслуживать пользователей? Вот здесь зависимости уместны.
app.get('/ready', async (req, res) => {
const checks = {}
try {
await db.query('SELECT 1')
checks.db = 'ok'
} catch {
checks.db = 'fail'
}
const healthy = Object.values(checks).every((v) => v === 'ok')
res.status(healthy ? 200 : 503).json({ status: healthy ? 'ok' : 'degraded', checks })
})
Разница принципиальная. Провал /healthz означает «перезапусти меня». Провал /ready — «не шли мне пока трафик, я разберусь сам». Второе не приводит к перезапускам, поэтому каскада не возникает.
Проверка базы — это SELECT 1, а не настоящий запрос к таблицам. Нужно убедиться, что соединение живо, а не прогнать бизнес-логику.
Шаг 3. Поставь таймаут на каждую проверку
Без таймаута проверка зависимости зависает ровно настолько, насколько зависла зависимость. Health check, который отвечает 30 секунд, бесполезен — за это время пингер уже посчитал тебя мёртвым.
const withTimeout = (p, ms) =>
Promise.race([p, new Promise((_, rej) => setTimeout(() => rej(new Error('timeout')), ms))])
await withTimeout(db.query('SELECT 1'), 1000)
Секунды достаточно. Не ответила база за секунду — она в любом случае не в порядке.
Шаг 4. Отдавай правильный код ответа
Пингеры и оркестраторы смотрят не в текст, а в код ответа HTTP. Живой — 200. Не готов — 503 Service Unavailable.
Частая ошибка: возвращать 200 с телом {"status":"error"}. Формально ты сообщил о проблеме — но снаружи никто её не заметил, потому что 200 означает «всё хорошо».
Шаг 5. Не выкладывай наружу лишнее
В health check тянет положить версию сборки, имя ветки, строку подключения к базе, список сервисов. Помни, что адрес открыт всему интернету и не требует авторизации.
Наружу — статус и не более. Детали — либо в отдельный закрытый эндпоинт, либо в логи.
Шаг 6. Подключи внешнего наблюдателя
Эндпоинт сам себя не проверит. Нужен кто-то снаружи: настройки хостинга или платформы деплоя (там почти везде есть поле health check path), внешний сервис пинга или простой cron, который раз в минуту делает запрос и пишет тебе, если ответ не 200.
Важно, чтобы наблюдатель жил не на том же сервере. Иначе сервер упадёт вместе с наблюдателем, и предупреждать будет некому.
Что получится
Два адреса и минута работы:
$ curl -s -o /dev/null -w "%{http_code}\n" https://твой-сайт/healthz
200
$ curl -s https://твой-сайт/ready
{"status":"ok","checks":{"db":"ok"}}
Теперь зависшее приложение перезапускается само, а про упавшую базу ты узнаёшь сообщением, а не от пользователя. Следующий логичный шаг — понять, почему именно упало: об этом разбор про observability и три её сигнала.
Зачем два эндпоинта, если можно один?
Потому что у них разные последствия. Один просит перезапуск, другой — паузу в трафике. Слепив их в один, ты получаешь ровно тот каскад из начала статьи: любая внешняя проблема начинает перезапускать твоё приложение.
А если у меня обычный хостинг без оркестратора?
/healthz всё равно полезен: почти любая платформа деплоя умеет пинговать адрес и перезапускать процесс. А если не умеет — хватит внешнего пингера, который просто напишет тебе, что сайт молчит.
Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.





