←К документации

Observability backends

Stable

Как подключить Prometheus/Loki для метрик и логов.

Обновлено: 4 февраля 2026 г.

Monitoring в spg99 состоит из двух частей:

  1. Экспозиция метрик/логов сервисами (gateway/pageserver/safekeeper/compute/CP).
  2. Бэкенды для хранения и запроса (Prometheus‑совместимые метрики, Loki‑совместимые логи) — чтобы Console могла показывать графики/логи.

Метрики

Компоненты публикуют Prometheus‑метрики на отдельных портах (см. Infrastructure → Network requirements).

Для self-hosted:

  • подключите Prometheus (или совместимый TSDB) и настройте scrape targets;
  • при использовании Operator удобно создать ServiceMonitor/PodMonitor.

Console использует API «range query» для построения графиков.

Логи

Для отображения логов в Console нужен агрегатор логов (обычно Loki):

  • на уровне кластера собирайте stdout/stderr контейнеров (например, promtail/fluent-bit/vector);
  • маркируйте логи лейблами tenant/db/worker (если ваша поставка это поддерживает).

Console делает запросы к Loki‑совместимому API и умеет:

  • tail с периодическим обновлением;
  • поиск по подстроке;
  • экспорт.

Если вы не подключали бэкенды

  • UI может показывать пустые графики/логи — это не влияет на работоспособность PostgreSQL.
  • Для прод окружений рекомендуем включить мониторинг: иначе диагностика инцидентов заметно сложнее.