Наблюдаемость (метрики/логи)

ACP: системные метрики

Эндпоинт: GET /acp/system/metrics — защищён ACP-авторизацией. Дополнительно можно включить Prometheus endpoint /metrics, установив observability.metrics.prometheus_enabled: true в config.{MODE}.yml. Он отдаёт те же показатели в текстовом формате Prometheus и не требует авторизации.

Возвращает агрегированные метрики:

• cache: счетчики операций/ошибок/времени (если кэш обёрнут метриками)
• db: счетчики запросов/ошибок/продолжительности (если БД обёрнута метриками)
• http: метрики HTTP‑клиента (см. ниже)
• controllers: latencies контроллеров (per-route, avg/p95, source)
• tasks: статус и длительности cron‑задач (счётчики запусков, success/fail, p95)
• streams / traffic_flows: runtime метрики per-handler (count, errors, avg/p95) для эндпоинтов /acp/streams/list и /acp/traffic_flows/list
• host: сведения о системе (платформа, аптайм, ядро, runtime)

Пример:

{
  "http": {
    "total_requests": 1234,
    "errors": 12,
    "duration_ms_sum": 456789,
    "buckets_ms": [50,100,200,500,1000,2000,5000],
    "counts": [100,220,400,350,120,30,14] // +Inf - последний элемент
  },
  "host": { "platform": "Ubuntu 22.04", "uptime_seconds": 12345, ... }
}

HTTP‑метрики: buckets

Bucket’ы (мс) для времени HTTP‑запросов настраиваются конфигом:

observability:
  metrics:
    http_buckets_ms: [50, 100, 200, 500, 1000, 2000, 5000]

Если не заданы - используется дефолтный набор [50,100,200,500,1000,2000,5000]. Даже если поверх HTTP-клиента навешен ретрай-декоратор, он проксирует Stats() базовой реализации, поэтому /acp/system/metrics и /metrics всегда видят агрегированные данные.

Таймауты HTTP‑клиента

См. docs/config/main.md, секция app.http.timeouts.*. Таймауты применяются к клиенту, используемому доменными сервисами (Stream, TrafficFlow, IAP и т.д.).