From 294f52cc8ef014e8740bf97ed0b4376264ec5d28 Mon Sep 17 00:00:00 2001 From: buryan-agent Date: Thu, 22 Oct 2026 05:41:50 +0300 Subject: [PATCH] =?UTF-8?q?[A-59]=20/health:=20=D0=BF=D0=BE=D0=BB=D0=BD?= =?UTF-8?q?=D0=B0=D1=8F=20=D1=81=D0=B2=D0=BE=D0=B4=D0=BA=D0=B0=20(=D1=81?= =?UTF-8?q?=D0=B5=D1=80=D0=B2=D0=B8=D1=81=D1=8B,=20=D0=B0=D0=BB=D0=B5?= =?UTF-8?q?=D1=80=D1=82=D1=8B,=20=D0=BD=D0=B0=D0=B3=D1=80=D1=83=D0=B7?= =?UTF-8?q?=D0=BA=D0=B0,=20=D0=B4=D0=B8=D1=81=D0=BA)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ops/hub/HEALTH.md | 39 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 39 insertions(+) create mode 100644 ops/hub/HEALTH.md diff --git a/ops/hub/HEALTH.md b/ops/hub/HEALTH.md new file mode 100644 index 0000000..71a6c06 --- /dev/null +++ b/ops/hub/HEALTH.md @@ -0,0 +1,39 @@ +# Эндпоинт /health + +Одна точка для внешнего мониторинга и быстрых проверок. + +```bash +curl -s http://127.0.0.1:9120/health | python3 -m json.tool +``` + +## Ответ + +```json +{ + "ok": true, + "events": 307, + "services_up": 124, + "services_total": 124, + "services_down": [], + "alerts": 0, + "load": [3.41, 3.11, 4.92], + "disk_root_pct": 22.3 +} +``` + +| Поле | Смысл | +|---|---| +| `ok` | все сервисы живы **и** нет активных алертов | +| `events` | сколько событий в шине хаба | +| `services_down` | список имён упавших (до 10) | +| `alerts` | количество активных алертов в Alertmanager (−1 = недоступен) | +| `load` | средняя нагрузка 1/5/15 минут | +| `disk_root_pct` | занятость корневого диска | + +HTTP-код всегда 200, если сам хаб отвечает; решение принимается по +полю `ok` — так удобнее для uptime-мониторинга. + +## Ловушка + +До 22.10 `/health` отдавал только `{"ok": true, "events": N}` — +проверял лишь доступность базы. Теперь в ответе реальная сводка.