ЛР 6 — БВТ2303 — Кропивка — на 4 #22

Closed
Viktoria wants to merge 1 commits from Viktoria/mtusi2026lab6:solution/БВТ-23-Кропивка into main
First-time contributor

Лабораторная 6

Автор / группа: Кропивка Виктория, БВТ2303
Целевая оценка: 4 (уровень 3 + уровень 4)
Трек 5: не заявлен

Что реализовано и что перенесено

Из ЛР5 перенесены src/, migrations/, scripts/, student_tests/, Dockerfile, alembic.ini, infra/haproxy.cfg, infra/s3-*.json, compose.yaml. Контракты и публичные тесты — из скелета ЛР6 (не перезаписаны).

Добавлено в ЛР6:

  • src/otel.py — Tracer/Meter/LoggerProvider через OTLP HTTP; src/logging_config.py — JSON-логи с trace_id/span_id.
  • src/main.py — FastAPI instrumentation, /metrics, DB pool gauge.
  • src/broker.py — W3C traceparent в AMQP headers; src/store.py — outbox jobs.traceparent.
  • src/relay.py — producer span из outbox; src/worker.py — consumer span (parent через broker), job-метрики.
  • Миграция 2667e1880881 — jobs.traceparent, jobs.tracestate.
  • compose.yaml — otel-collector, prometheus, loki, tempo, grafana; /metrics на worker/relay.
  • infra/otel/ — collector (memory_limiter, batch, bounded queue), prometheus + 4 alerts, loki, tempo, grafana provisioning + 2 dashboard JSON, runbooks.
  • evidence/ — 2 скриншота дашбордов + README.md с методикой.

Команды запуска из чистого clone

cp .env.example .env   # заполнить POSTGRES_PASSWORD, S3_*, BROKER_*, GRAFANA_ADMIN_PASSWORD
docker compose --env-file .env up -d --build
make test
# Grafana: http://localhost:3000 → Dashboards → Messenger

Подробно — REPORT.md → «Запуск из чистого clone».

Результаты проверок

  • make check, make validate, make test — PASS.
  • Prometheus targets: 7/7 up.
  • Tempo: messenger-api, messenger-relay, messenger-worker.
  • Loki: service_name и др.
  • W3C trace: один trace от POST /upload до worker.job.process через jobs.traceparent → AMQP headers.
  • Alerts проверены: QueueLagHigh (stop worker → firing → start → inactive), HighErrorRate (stop postgres → firing → start → inactive).
  • Доказательства: evidence/dashboard-api-overview.png, evidence/dashboard-worker-pipeline.png, evidence/README.md.

Ограничения / известные ошибки

  • Имена контейнеров в prometheus.yml захардкожены (compose; в production — service discovery).
  • Tempo metrics_generator не используется (не требуется для 4).
  • GRAFANA_ADMIN_PASSWORD в .env; в production — секрет-менеджер (ЛР7).
  • 5-й трек не заявлен.

Источники и использование ИИ

OTel SDK 1.28.2, Collector 0.111.0, Prometheus 2.55.1, Loki 3.2.1, Tempo 2.6.1, Grafana 11.3.1. LLM-ассистент — для черновиков конфигов и отладки (например, prometheusremotewrite без sending_queue в 0.111.0; metrics.readers[].pull вместо metrics.address). Код проверен smoke, observability-сценариями и alerts firing→resolved.


  • Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
  • Контракт и публичные тесты не ослаблены.
  • make check и make test выполнены; приложен реальный вывод.
  • Сценарии отказов/безопасности своего уровня воспроизведены.
  • Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
  • README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
## Лабораторная 6 **Автор / группа:** Кропивка Виктория, БВТ2303 **Целевая оценка:** 4 (уровень 3 + уровень 4) **Трек 5:** не заявлен ### Что реализовано и что перенесено Из ЛР5 перенесены `src/`, `migrations/`, `scripts/`, `student_tests/`, `Dockerfile`, `alembic.ini`, `infra/haproxy.cfg`, `infra/s3-*.json`, `compose.yaml`. Контракты и публичные тесты — из скелета ЛР6 (не перезаписаны). Добавлено в ЛР6: - **`src/otel.py`** — Tracer/Meter/LoggerProvider через OTLP HTTP; `src/logging_config.py` — JSON-логи с trace_id/span_id. - **`src/main.py`** — FastAPI instrumentation, `/metrics`, DB pool gauge. - **`src/broker.py`** — W3C traceparent в AMQP headers; **`src/store.py`** — outbox `jobs.traceparent`. - **`src/relay.py`** — producer span из outbox; **`src/worker.py`** — consumer span (parent через broker), job-метрики. - **Миграция `2667e1880881`** — `jobs.traceparent`, `jobs.tracestate`. - **`compose.yaml`** — otel-collector, prometheus, loki, tempo, grafana; `/metrics` на worker/relay. - **`infra/otel/`** — collector (memory_limiter, batch, bounded queue), prometheus + 4 alerts, loki, tempo, grafana provisioning + 2 dashboard JSON, runbooks. - **`evidence/`** — 2 скриншота дашбордов + `README.md` с методикой. ### Команды запуска из чистого clone ```bash cp .env.example .env # заполнить POSTGRES_PASSWORD, S3_*, BROKER_*, GRAFANA_ADMIN_PASSWORD docker compose --env-file .env up -d --build make test # Grafana: http://localhost:3000 → Dashboards → Messenger ``` Подробно — `REPORT.md` → «Запуск из чистого clone». ### Результаты проверок - `make check`, `make validate`, `make test` — **PASS**. - Prometheus targets: **7/7 up**. - Tempo: `messenger-api`, `messenger-relay`, `messenger-worker`. - Loki: `service_name` и др. - W3C trace: один trace от `POST /upload` до `worker.job.process` через `jobs.traceparent` → AMQP headers. - Alerts проверены: `QueueLagHigh` (stop worker → firing → start → inactive), `HighErrorRate` (stop postgres → firing → start → inactive). - Доказательства: `evidence/dashboard-api-overview.png`, `evidence/dashboard-worker-pipeline.png`, `evidence/README.md`. ### Ограничения / известные ошибки - Имена контейнеров в `prometheus.yml` захардкожены (compose; в production — service discovery). - Tempo `metrics_generator` не используется (не требуется для 4). - `GRAFANA_ADMIN_PASSWORD` в `.env`; в production — секрет-менеджер (ЛР7). - 5-й трек не заявлен. ### Источники и использование ИИ OTel SDK 1.28.2, Collector 0.111.0, Prometheus 2.55.1, Loki 3.2.1, Tempo 2.6.1, Grafana 11.3.1. LLM-ассистент — для черновиков конфигов и отладки (например, `prometheusremotewrite` без `sending_queue` в 0.111.0; `metrics.readers[].pull` вместо `metrics.address`). Код проверен smoke, observability-сценариями и alerts firing→resolved. --- - [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами. - [x] Контракт и публичные тесты не ослаблены. - [x] make check и make test выполнены; приложен реальный вывод. - [x] Сценарии отказов/безопасности своего уровня воспроизведены. - [x] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens. - [x] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
Viktoria added 1 commit 2026-11-13 13:29:31 +03:00
Owner

Принято. Закрываю МР.

Принято. Закрываю МР.
veprickiy closed this pull request 2026-11-15 20:58:17 +03:00

Pull request closed

Please reopen this pull request to perform a merge.
Sign in to join this conversation.
No Reviewers
No labels
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: mtusi2026/mtusi2026lab6#22