{"canonical_url":"https://engineer.company/uk/glossary/health-check/","content_markdown":"# Перевірка справності\n\n## Що це таке\n\nПеревірка справності (health check) — це невеликий тест, який повторюється за\nрозкладом і запитує працюючий сервіс, чи може він виконувати свою роботу, разом\nіз правилом, що робити, коли відповідь негативна. Тестом може бути HTTP-запит до\nокремого шляху, команда, запущена всередині контейнера, або спроба відкрити\nTCP-порт. Саме правило перетворює перевірку з вимірювання на механізм керування:\nневдала перевірка може вивести сервер із ротації, перезапустити контейнер,\nзупинити розгортання або розбудити когось посеред ночі.\n\nDocker вбудовує цю ідею просто в образ. Інструкція `HEALTHCHECK` у Dockerfile\nзадає команду, яку Docker запускає всередині контейнера з фіксованим інтервалом.\nКод виходу 0 означає, що контейнер справний, 1 — що несправний, а код 2\nзарезервовано, і використовувати його не можна. Контейнер із перевіркою починає\nв стані `starting`, переходить у `healthy`, щойно одна перевірка пройде, і стає\n`unhealthy` після заданої кількості невдач поспіль. Типові значення — перевірка\nкожні 30 секунд, тайм-аут 30 секунд і три спроби; запуск, що перевищив тайм-аут,\nзараховується як невдача, а його процес примусово завершується. Необов'язковий\nстартовий період дає повільному застосунку час запуститися, і невдачі в цей\nперіод не зараховуються. У Dockerfile може бути лише одна така інструкція: якщо\nїх кілька, діє остання, а `HEALTHCHECK NONE` вимикає перевірку, успадковану від\nбазового образу.\n\nKubernetes розбиває це питання на три проби, і кожна має власний наслідок.\nStartup-проба з'ясовує, чи застосунок завершив запуск; доки вона не пройде, дві\nінші чекають, а якщо вона раз у раз провалюється, контейнер завершують, і далі з\nним чинять згідно з його політикою перезапуску. Liveness-проба з'ясовує, чи\nтреба перезапустити контейнер, і призначена для станів на кшталт взаємного\nблокування (deadlock), коли процес працює, але не просувається вперед.\nReadiness-проба з'ясовує, чи має контейнер отримувати трафік. Коли вона\nпровалюється, контейнер не перезапускають; натомість адресу Pod вилучають з\nендпоінтів кожного Service, чий селектор його обирає, і запити йдуть до інших\nреплік, доки проба знову не пройде.\n\nКожна проба використовує один із чотирьох механізмів. Проба `httpGet` проходить\nза будь-якого коду статусу від 200 до 399 включно. Проба `tcpSocket` проходить,\nякщо порт приймає з'єднання, навіть таке, що одразу закривається. Проба `grpc`\nпроходить, коли сервіс відповідає `SERVING` за протоколом перевірки справності\ngRPC. Проба `exec` виконує команду в контейнері й проходить, якщо та завершилася\nз кодом 0. Якщо не вказано інше, Kubernetes перевіряє кожні десять секунд, чекає\nна відповідь одну секунду й реагує після трьох невдач поспіль.\n\nБалансувальники навантаження додають ще один різновид. Описані вище перевірки\nактивні: щось надсилає тестовий запит незалежно від того, чи є зараз\nкористувачі. Пасивна перевірка натомість стежить за справжнім трафіком. Саме так\nпрацює nginx з відкритим кодом: коли запит до upstream-сервера закінчується\nпомилкою, nginx позначає цей сервер як несправний і на якийсь час його оминає, а\nза типового значення `max_fails`, що дорівнює 1, для цього досить однієї\nневдалої спроби. Документація nginx зараховує перевірки справності застосунків\n(application health checks) до можливостей платних підписок NGINX Plus. Пасивна\nперевірка не коштує додаткових ресурсів, але про несправний сервер вона\nдізнається з невдалого запиту користувача і мовчить про сервер, на який трафік\nне надходить.\n\n## Чому це важливо\n\nПрацюючий процес — ще не справний сервіс. Довідник Docker наводить типовий\nприклад: вебсервер, що застряг у нескінченному циклі й перестав приймати\nз'єднання, хоча його процес досі живий. Усе, що стежить лише за тим, чи існує\nпроцес, як-от юніт [systemd](/uk/glossary/#systemd) із політикою перезапуску, не\nбачить жодної проблеми. Розрізнити ці стани може тільки питання, поставлене\nчерез ті самі двері, якими заходять користувачі, і в цьому весь сенс перевірки\nсправності: вона замінює питання «чи він запущений?» питанням «чи він\nвідповідає?».\n\nДва рішення визначають, чи буде перевірка корисною, чи небезпечною. Перше — що\nсаме вона перевіряє, а це, по суті, визначення слова «працює», записане в коді.\nОбробник, який повертає 200, нічого не торкаючись, доводить лише, що\nвебфреймворк запущено; обробник, який ще й звертається до бази даних, доводить,\nщо база досяжна, і провалюється щоразу, коли вона недосяжна. Друге — що\nвідбувається в разі невдачі, і від цього залежить радіус ураження. Вивести одну\nрепліку з ротації дешево, і це легко скасувати. Перезапуск викидає її\nнезавершену роботу й прогріті кеші, а якщо всі репліки провалюють ту саму\nперевірку одночасно, перезапуск усіх перетворює повільну залежність на повну\nвідмову сервісу.\n\nKubernetes попереджає саме про це. Документація каже, що liveness-проби треба\nналаштовувати так, щоб вони справді вказували на збій, з якого застосунок не\nвідновиться сам, і що неправильна реалізація може спричинити каскадні збої:\nперезапуски контейнерів під високим навантаженням, невдалі клієнтські запити й\nдодаткову роботу для подів, що лишилися. Звідси порада тримати ці два питання\nокремо. Коли застосунок жорстко залежить від бекенд-сервісів, його\nliveness-проба має проходити, доки справний сам застосунок, а readiness-проба\nмає перевіряти ще й кожен потрібний бекенд. Тоді трафік оминає Pod, який міг би\nвідповідати лише помилками, а сам Pod не вбивають через несправність, що\nкриється деінде.\n\nПеревірки справності також працюють на [моніторинг](/uk/glossary/#monitoring).\nЕндпоінт, який опитує балансувальник навантаження, можна опитувати й ззовні, і\n[тривога](/uk/glossary/#alert), що спрацьовує, коли він падає, часто стає першою\nознакою [інциденту](/uk/glossary/#incident). Коли Irakli Nadareishvili писав\nInternet-Draft Health Check Response Format for HTTP APIs, стандарту на те, що\nмає повертати такий ендпоінт, не існувало, і більшість застосунків покладалися\nабо лише на код статусу HTTP, або на власний формат. Чернетка пропонувала\nJSON-відповідь із типом медіа `application/health+json` і обов'язковим полем\n`status` зі значенням `pass`, `fail` або `warn`, де `pass` і `warn` поєднуються\nз кодом статусу 2xx чи 3xx, а `fail` — з кодом 4xx чи 5xx. Остання редакція, від\nжовтня 2021 року, втратила чинність у квітні 2022-го, і IETF зазначає, що IETF\nїї не схвалювала і формального статусу вона не має. Вона корисна як спільний\nсловник, а не як стандарт.\n\n## Як це виглядає на практиці\n\nУ Dockerfile перевірка постачається разом з образом, який вона перевіряє. Тут\nвласна невелика програма-проба застосунку запитує шлях на localhost і\nзавершується з кодом 0 або 1:\n\n```dockerfile\nHEALTHCHECK --interval=15s --timeout=3s --start-period=60s --retries=3 \\\n  CMD [\"/app/bin/probe\", \"http://127.0.0.1:8080/livez\"]\n```\n\nDocker запускає пробу кожні 15 секунд і дає кожному запуску три секунди. Невдачі\nв першу хвилину не зараховуються, доки хоч одна перевірка не пройде успішно, а в\nDocker Engine 25.0 і новіших перевірки в цю хвилину виконуються кожні п'ять\nсекунд — це типовий стартовий інтервал, — тож швидкий запуск помічають швидко.\nПісля трьох невдач поспіль контейнер позначається як `unhealthy`. Перші 4096\nбайтів виводу проби зберігаються для `docker inspect`, а кожна зміна стану\nпороджує подію `health_status`. Довідник описує стан, а не дію: реагувати на\nнього має щось інше.\n\nУ Kubernetes трьом пробам можна задати різні шляхи, щоб кожна ставила своє\nпитання:\n\n```yaml\ncontainers:\n  - name: api\n    ports:\n      - containerPort: 8080\n    startupProbe:\n      httpGet: { path: /livez, port: 8080 }\n      periodSeconds: 5\n      failureThreshold: 24 # до 2 хвилин на запуск\n    livenessProbe:\n      httpGet: { path: /livez, port: 8080 }\n      periodSeconds: 10\n      timeoutSeconds: 2\n      failureThreshold: 6 # близько хвилини до перезапуску\n    readinessProbe:\n      httpGet: { path: /readyz, port: 8080 }\n      periodSeconds: 5\n      timeoutSeconds: 2\n      failureThreshold: 2\n```\n\n`/livez` відповідає лише за сам процес, а `/readyz` перевіряє ще й базу даних та\nвсе інше, без чого запит не обійдеться. Startup-проба використовує шлях\nliveness, як радить документація Kubernetes, і дає 24 × 5 секунд, перш ніж\nконтейнер вважатимуть безнадійним. Щойно вона пройде, керування переходить до\nliveness із довгим запалом і до readiness із коротким: близько десяти секунд\nневдач виводять Pod із Service, а хвилина невдач перезапускає його. Типові\nзначення дали б три невдачі з інтервалом у десять секунд, а цього замало для\nзастосунку, якому потрібно дві хвилини, щоб завантажити свої дані. Власне\nправило документації таке: контейнеру, якому на запуск зазвичай потрібно більше,\nніж initialDelaySeconds плюс failureThreshold × periodSeconds, потрібна\nstartup-проба.\n\nПеревірку справності можна й вивернути навиворіт. У [моніторингу хоста з dead man's switch](/uk/portfolio/built-dead-mans-switch-host-monitoring/), зробленому у вересні 2026 року, хост із 464 МБ пам'яті, на якому працюють git-сервер і вебсервер, перевіряє сам себе кожні п'ятнадцять хвилин із випадковим зсувом: невеликий скрипт вимірює доступну пам'ять і вільне місце на диску й пінгує зовнішній сервіс, лише якщо обидва показники вищі за свої пороги. Тривогу здіймає тиша. Машина, у якої скінчилася пам'ять, пропала мережа або яка перестала завантажуватися, дає той самий сигнал, що й просто несправна, і саме тому обрали такий підхід, а не агента, який звітує про стан. Перевірка читає доступну пам'ять, а не вільну, бо ядро віддає незайняту пам'ять під кеш, і шість імен змінних зі словом «free» виправили, щоб ніхто не «полагодив» робочу сигналізацію, перетворивши її на таку, що постійно перебуває за порогом. Отриманий сигнал підтверджує, що скрипт виконався, а перевірки доступної пам'яті й вільного місця на диску пройдено за встановленими порогами; він не засвідчує загальної справності хоста чи того, що сайт обслуговує запити. Моніторинг може виявляти тривожні ознаки, хоча час їх появи залежить від навантаження й умов спостереження.\n\nПеревірка під час запуску відповідає на ще одне питання. У\n[пошті з failover і журналом доставки](/uk/portfolio/built-email-with-failover-and-delivery-logging/)\n2025 року листи йдуть через трьох провайдерів з автоматичним резервним\nперемиканням, а на вході до всього цього стоїть стартова перевірка, яку вмикає\nпрапорець: вона надсилає справжній лист через увесь стек. У середовищі розробки\nневдача лише записує попередження в журнал, і застосунок працює далі; у staging\nі production вона фатальна, і процес завершується, щоб не розгорнути збірку, яка\nне здатна надсилати пошту. Сторінка підсумовує результат так: цілий клас тихих\nзбоїв перейшов із розряду «користувач помітить через кілька днів» у розряд\n«розгортання зупиняється».\n\n## Де виникають проблеми\n\n**Перевірка доводить лише, що процес відповідає.** Обробник, який повертає 200,\nнічого не торкаючись, лишається зеленим, коли база даних недосяжна, диск\nзаповнений або кожен справжній запит закінчується помилкою. Нехай\nreadiness-перевірка дешево випробовує те, що потрібно запиту, і додайте\nперевірку ззовні, яка проходить шляхом користувача через DNS, TLS і\nбалансувальник навантаження, бо kubelet надсилає проби прямо на власну IP-адресу\nPod і нічого з цього не бачить.\n\n**Liveness залежить від чогось поза контейнером.** Якщо liveness-проба\nзвертається до бази даних, повільна база валить її в усіх репліках одночасно, і\nKubernetes перезапускає їх усі саме тоді, коли сервісу й так важко. Нехай\nliveness відповідає лише за сам процес, як радить документація Kubernetes, а\nзалежності перенесіть у readiness, де невдача відводить трафік, а не вбиває\nконтейнери.\n\n**Часові параметри обрано без огляду на застосунок.** За замовчуванням\nKubernetes чекає на відповідь одну секунду, тож ендпоінт, який сповільнюється\nпід навантаженням, провалює перевірку, хоча застосунок просто зайнятий, а\nконтейнер, який запускається повільніше, ніж дозволяє його liveness-проба,\nвбивають ще до того, як він буде готовий, і так раз за разом. Виміряйте, скільки\nчасу ендпоінт відповідає під навантаженням, задайте тайм-аут із запасом понад це\nзначення, а повільним застосункам дайте startup-пробу, розраховану на\nнайповільніший реальний запуск.\n\n**Перенаправлення проходить.** HTTP-проба в Kubernetes вважає успіхом будь-який\nстатус від 200 до 399, тож шлях, що перенаправляє на сторінку входу, виглядає\nсправним. Якщо перенаправлення веде на інший хост, kubelet за ним не переходить,\nа записує пробу як успішну з попередженням. Зі схемою HTTPS kubelet до того ж\nпропускає перевірку сертифіката, тож прострочений сертифікат ніколи не провалить\nпробу. Спрямовуйте проби на шлях, який відповідає 200 напряму й повертає 5xx,\nколи щось не так, а сертифікати перевіряйте ззовні.\n\n**Ендпоінт розповідає забагато й забагатьом.** Детальна відповідь, що перелічує\nкожну залежність, версію та ім'я хоста, інформує зловмисника не гірше, ніж\nбалансувальник навантаження, а розділ Internet-Draft про безпеку зазначає, що\nендпоінтам перевірки справності може знадобитися автентифікація й рольовий\nконтроль доступу. Залиште в публічній відповіді лише статус, а подробиці\nвіддавайте на внутрішньому порту або тільки автентифікованим клієнтам.\n\n**Перевірка коштує більше, ніж мала б.** Kubernetes попереджає, що проби `exec`\nпід час кожного запуску створюють нові процеси, і на щільно заповнених вузлах із\nкороткими інтервалами це може додати навантаження на процесор вузла. Проба, яка\nкожні кілька секунд виконує важкий запит на кожній репліці, сама по собі стає\nнавантаженням. Віддавайте перевагу пробам HTTP, TCP або gRPC, тримайте ендпоінт\nдешевим і кешуйте результат дорогої перевірки залежностей на кілька секунд, а не\nповторюйте її для кожної проби.\n\n## Що почитати далі\n\n- [Dockerfile reference: HEALTHCHECK](https://docs.docker.com/reference/dockerfile/#healthcheck)\n  — інструкція, її параметри й типові значення та що означає кожен код виходу.\n- [Liveness, Readiness, and Startup Probes](https://kubernetes.io/docs/concepts/workloads/pods/probes/)\n  — що робить кожен тип проби, чотири механізми перевірки та всі поля\n  конфігурації з їхніми типовими значеннями.\n- [Configure Liveness, Readiness and Startup Probes](https://kubernetes.io/docs/tasks/configure-pod-container/configure-liveness-readiness-startup-probes/)\n  — покрокові приклади, зокрема startup-проба, яка дає повільному застосунку\n  п'ять хвилин.\n- [Health Check Response Format for HTTP APIs](https://datatracker.ietf.org/doc/draft-inadarei-api-health-check/)\n  — чернетка Internet-Draft, що вже втратила чинність, на якій ґрунтується\n  `application/health+json`, та її статуси pass, fail і warn.\n- [Using nginx as HTTP load balancer](https://nginx.org/en/docs/http/load_balancing.html)\n  — пасивні вбудовані (in-band) перевірки справності в nginx з відкритим кодом і\n  параметри `max_fails` та `fail_timeout`.\n\n\u003chttps://engineer.company/uk/glossary/health-check/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Як працюючий сервіс запитують, чи може він виконувати свою роботу, що Docker і Kubernetes роблять із відповіддю і як погано обрана перевірка спричиняє збої.","formats":{"gemtext":"https://engineer.company/uk/glossary/health-check/index.gmi","gopher":"https://engineer.company/uk/glossary/health-check/gophermap","html":"https://engineer.company/uk/glossary/health-check/","json":"https://engineer.company/uk/glossary/health-check/index.json","markdown":"https://engineer.company/uk/glossary/health-check/index.md","pdf":"https://engineer.company/uk/glossary/health-check/index.pdf"},"kind":"page","language":"uk","title":"Що таке перевірка справності?","url":"https://engineer.company/uk/glossary/health-check/","version":1}