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}` — +проверял лишь доступность базы. Теперь в ответе реальная сводка.