docs: add local observability demo runbook

This commit is contained in:
Mlvn
2026-11-21 11:05:36 +03:00
parent 3be7425eb6
commit 0fdec96a73
2 changed files with 46 additions and 0 deletions
+5
View File
@@ -28,3 +28,8 @@ OTEL_SERVICE_NAME=messenger-api
OTEL_EXPORTER_OTLP_ENDPOINT=http://otel-collector:4318
OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf
OTEL_RESOURCE_ATTRIBUTES=deployment.environment.name=lab
# Local observability demo load (enabled with --profile demo)
MOCK_RATE=2
MOCK_WORKERS=2
VICTORIAMETRICS_PORT=8428
+41
View File
@@ -0,0 +1,41 @@
# Локальная демонстрация observability
Запуск:
```sh
make bootstrap
cp .env.example .env
# для текущего стенда secrets уже создаются bootstrap
docker compose --profile demo up -d
```
Адреса:
- Grafana: http://localhost:3006
- VictoriaMetrics UI/API: http://localhost:8428
- Loki API: http://localhost:3106
- Tempo API: http://localhost:3206
- Prometheus (локальные alert rules): http://localhost:9096
- Messenger API/LB: http://localhost:8086
Mock-load создаёт синтетических пользователей, чат, сообщения, чтение истории и health-запросы. Настройка:
```sh
MOCK_RATE=5 MOCK_WORKERS=4 docker compose --profile demo up -d mock-load
```
Проверить работу:
```sh
docker compose logs -f mock-load
curl 'http://localhost:8428/api/v1/query?query=http_server_requests_total'
curl http://localhost:3106/ready
```
В Grafana откройте provisioned dashboard `Messenger: API and image pipeline`; datasource по умолчанию — VictoriaMetrics. Для логов используйте Explore → Loki, для traces — Explore → Tempo.
Остановить только генератор нагрузки:
```sh
docker compose --profile demo stop mock-load
```