doc: update progress and thinking log for v0.1.23-v0.1.24 (billing + metrics)

2026-04-12 12:10:28 +03:00
parent 35d7985b87
commit c870c09fff
2 changed files with 60 additions and 5 deletions
@@ -431,4 +431,48 @@ sqs_usage_records (
 INDEX: idx_sqs_usage_tenant_time (tenant_id, recorded_at)
 ```

-Именно такое разделение и нужно, чтобы дальше не смешивать хорошие рабочие метрики сервиса с чужим инфраструктурным ограничением.
+Именно такое разделение и нужно, чтобы дальше не смешивать хорошие рабочие метрики сервиса с чужим инфраструктурным ограничением.
+
+---
+
+## Prometheus Metrics + Victoria Metrics integration
+
+### Контекст
+После добавления billing (PostgreSQL) решено добавить Prometheus-метрики для мониторинга в реальном времени.
+Проверил кластер — уже установлены:
+- Victoria Metrics с оператором (namespace `victoria-metrics`)
+- VMAgent с pod collectors — скрейпят через VMServiceScrape / VMPodScrape CRD
+- Grafana на `grafana.ngcloud.ru` — подключена к VM
+
+### Решение
+Не писать свой мониторинг — подключиться к существующей инфраструктуре:
+1. shared-sqs отдаёт `/metrics` в Prometheus-формате
+2. VMServiceScrape говорит VMAgent скрейпить наш Service
+3. Grafana видит данные через VM — дашборд можно создать вручную
+
+### Метрики
+| Метрика | Тип | Labels | Назначение |
+|---------|-----|--------|-----------|
+| `sqs_requests_total` | Counter | tenant, operation | Количество запросов |
+| `sqs_request_bytes_total` | Counter | tenant, operation | Объём трафика |
+| `sqs_request_duration_seconds` | Histogram | operation | Latency (бакеты 1ms — 30s) |
+| `sqs_errors_total` | Counter | operation | Ошибки (HTTP >= 400) |
+| `sqs_queues_count` | Gauge | tenant | Текущее кол-во очередей |
+| `sqs_messages_count` | Gauge | tenant | Текущее кол-во сообщений |
+
+### Реализация
+- `app/metrics/metrics.go` — определение метрик через promauto
+- `app/metrics/gauge_updater.go` — горутина, пересчёт gauges каждые 15s через RLock
+- `router.go` — `/metrics` endpoint + инструментация actionHandler (duration, counters, errors)
+- `goaws.go` — запуск gauge updater из main
+- `deployments/k8s/vmservicescrape.yaml` — VMServiceScrape (каждые 30s, port http)
+
+### Проблема: Go 1.22 → 1.23
+Prometheus client v1.23.2 требует Go >= 1.23. go.mod обновился автоматически.
+Пришлось обновить Dockerfile с `golang:1.22-alpine` на `golang:1.23-alpine`.
+
+### Результат
+- `/metrics` отдаёт все sqs_* метрики
+- VMServiceScrape applied, status pending (VMAgent подхватывает)
+- quick_test.sh: 31/31 PASS
+- Docker image: `naeel/shared-sqs:v0.1.24`