ЛР 6 — БВТ2302 — Вотчицева — на 4 #39

Closed
Tutuxa wants to merge 1 commits from Tutuxa/mtusi2026lab6:solution/bvt2302-Votchitseva into main
First-time contributor

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

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

Что реализовано и что перенесено:
Перенесен весь функционал lab5 (API, Worker, RabbitMQ, S3, Postgres).
Внедрен полный стек наблюдаемости (Observability) на базе OpenTelemetry:

  • OTel Collector собирает метрики, логи и трейсы, используя memory_limiter для защиты от OOM.
  • Prometheus собирает метрики (RPS, p50/p95/p99, доля 5xx, Queue Depth, DB Pool).
  • Loki хранит структурированные логи.
  • Tempo хранит распределенные трассы.
  • Grafana автоматически импортирует дашборд через provisioning (лежит в Git).
    Реализована передача W3C Trace Context (traceparent) через RabbitMQ (в Outbox payload), что позволяет видеть единый трейс от HTTP-запроса в API до работы Worker'а в S3/БД.
    Настроены два алерта: MessengerHighErrorRate и MessengerQueueLagGrowing.

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

Copy-Item .env.example .env
docker compose up -d --build --wait --wait-timeout 180

$env:PYTHONUTF8="1"
python tests/smoke.py
python tests/load.py --duration 60 --concurrency 4 --output evidence/load-lab6.json

Результаты проверок и ссылка на REPORT.md:

  • Пройден публичный smoke-тест.
  • Проведена нагрузка (0 ошибок при нормальной работе).
  • Воспроизведены 3 инцидента: остановка Worker (срабатывание алерта Queue Lag), падение БД (срабатывание алерта High Error Rate), отказ Loki/Tempo (приложение продолжило работать).
    Все скриншоты Grafana/Prometheus и JSON-отчеты приложены в описании этого PR. Подробнее — в REPORT.md.

Ограничения / известные ошибки:
Стек мониторинга развернут в одном экземпляре (Single-node). При отказе HAProxy ошибки 5xx могут не попасть в метрики API (ограничение SLI, описано в отчете). Данные телеметрии не являются критическим путем для бизнес-логики.

Источники и использование ИИ:
Python 3.12, FastAPI, RabbitMQ, SeaweedFS (S3), PostgreSQL, Redis.
OTel SDK, Prometheus, Loki, Tempo, Grafana.
При подготовке конфигураций и кода использовался ассистент (Claude).

  • Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
  • Контракт и публичные тесты не ослаблены.
  • make check и make test выполнены; приложен реальный вывод.
  • Сценарии отказов/безопасности своего уровня воспроизведены.
  • Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
  • README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
## Лабораторная 6 Автор / группа: Вотчицева, БВТ2302 Целевая оценка (3/4/5): 4 Трек 5, если заявлен: не заявлен Что реализовано и что перенесено: Перенесен весь функционал lab5 (API, Worker, RabbitMQ, S3, Postgres). Внедрен полный стек наблюдаемости (Observability) на базе OpenTelemetry: - OTel Collector собирает метрики, логи и трейсы, используя `memory_limiter` для защиты от OOM. - Prometheus собирает метрики (RPS, p50/p95/p99, доля 5xx, Queue Depth, DB Pool). - Loki хранит структурированные логи. - Tempo хранит распределенные трассы. - Grafana автоматически импортирует дашборд через provisioning (лежит в Git). Реализована передача W3C Trace Context (`traceparent`) через RabbitMQ (в Outbox payload), что позволяет видеть единый трейс от HTTP-запроса в API до работы Worker'а в S3/БД. Настроены два алерта: `MessengerHighErrorRate` и `MessengerQueueLagGrowing`. Команды запуска из чистого clone: ```powershell Copy-Item .env.example .env docker compose up -d --build --wait --wait-timeout 180 $env:PYTHONUTF8="1" python tests/smoke.py python tests/load.py --duration 60 --concurrency 4 --output evidence/load-lab6.json ``` Результаты проверок и ссылка на REPORT.md: - Пройден публичный smoke-тест. - Проведена нагрузка (0 ошибок при нормальной работе). - Воспроизведены 3 инцидента: остановка Worker (срабатывание алерта Queue Lag), падение БД (срабатывание алерта High Error Rate), отказ Loki/Tempo (приложение продолжило работать). Все скриншоты Grafana/Prometheus и JSON-отчеты приложены в описании этого PR. Подробнее — в REPORT.md. Ограничения / известные ошибки: Стек мониторинга развернут в одном экземпляре (Single-node). При отказе HAProxy ошибки 5xx могут не попасть в метрики API (ограничение SLI, описано в отчете). Данные телеметрии не являются критическим путем для бизнес-логики. Источники и использование ИИ: Python 3.12, FastAPI, RabbitMQ, SeaweedFS (S3), PostgreSQL, Redis. OTel SDK, Prometheus, Loki, Tempo, Grafana. При подготовке конфигураций и кода использовался ассистент (Claude). - [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами. - [x] Контракт и публичные тесты не ослаблены. - [x] make check и make test выполнены; приложен реальный вывод. - [x] Сценарии отказов/безопасности своего уровня воспроизведены. - [x] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens. - [x] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
Tutuxa added 1 commit 2026-11-17 16:02:30 +03:00
Owner

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

Принято. Закрываю МР.
veprickiy closed this pull request 2026-11-17 19:25:48 +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#39