Sergey Antropoff
48df10b17e
- Harden DB-backed handlers and seed profiles; align client wire shapes for cluster resources, QEMU config, and node SSL fields - Serve plain HTTP on Compose :8006; keep TLS optional (--profile tls) and terminate HTTPS at Kubernetes Ingress - Add pulumi-tests (full contract surface majors 6–9 + BPG lifecycle) and make pulumi-tests - Ship bilingual docs, CHANGELOG, SECURITY, CONTRIBUTING, and GitHub Actions (make ci + Compose/Helm validation)
44 lines
1.8 KiB
Markdown
44 lines
1.8 KiB
Markdown
**Language / Язык:** [English](../observability.md) | [Русский](observability.md)
|
|
|
|
# Наблюдаемость
|
|
|
|
## Health
|
|
|
|
| Путь | Назначение |
|
|
|---|---|
|
|
| `GET /health/live` | Liveness процесса |
|
|
| `GET /health/ready` | База доступна **и** миграции актуальны; HTTP 503 при невыполнении |
|
|
|
|
Пример:
|
|
|
|
```bash
|
|
curl -s http://localhost:8006/health/live
|
|
curl -s http://localhost:8006/health/ready
|
|
```
|
|
|
|
## Корреляция запросов
|
|
|
|
Входящие запросы принимают или генерируют ID через `REQUEST_ID_HEADER`
|
|
(по умолчанию `X-Request-ID`). Структурированные логи включают поля корреляции и
|
|
редактируют известные шаблоны секретов.
|
|
|
|
## Метрики / трейсинг
|
|
|
|
В текущем приложении **нет** scrape-эндпоинта Prometheus `/metrics` и **нет**
|
|
встроенного экспортёра OpenTelemetry. Архитектурные заметки, где они упоминаются,
|
|
описывают целевой дизайн, а не поставляемую телеметрию.
|
|
|
|
Не путайте пути Proxmox API под `/cluster/metrics` с телеметрией процесса
|
|
симулятора — эти обработчики симулируют состояние конфигурации metrics-server PVE
|
|
внутри PostgreSQL.
|
|
|
|
## Evidence совместимости
|
|
|
|
Операционные отчёты совместимости:
|
|
|
|
- `/admin/compatibility`
|
|
- `/admin/compatibility.md`
|
|
- `/admin/compatibility.html`
|
|
|
|
Также доступны через панель совместимости Web UI.
|