Files
mtusi2026lab6/docs/pull_request_lab6.md

5.4 KiB

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

Автор / группа: Кушнаренко Николай Вячеславович, БПИ2302 Целевая оценка (3/4/5): 5 Трек 5, если заявлен: Трек 1 — цена наблюдаемости

Что реализовано и что перенесено: Собственный мессенджер из ЛР5: две API-реплики, HAProxy, PostgreSQL, Valkey, приватный S3, RabbitMQ и worker. Бизнес-API сохранён. Добавлены OpenTelemetry SDK/Collector, Prometheus, Loki, Tempo и Grafana; provisioning трёх источников и dashboard из 22 панелей, гистограммы, SLI/SLO и шесть alert rules. Контекст W3C проходит API → outbox → broker → worker → S3/DB, включая retry. Есть memory limiter, batch, ограниченные очереди, удаление чувствительных атрибутов. Исправления базы ЛР5 (HAProxy/reconciler), Windows LF и ограниченный S3 recovery hook выделены в REPORT.md.

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

sh scripts/init-secrets.sh
cp .env.example .env
docker compose --env-file .env config --quiet
docker compose --env-file .env up -d --build --wait --wait-timeout 180
python3 scripts/check_contract.py
python3 tests/smoke.py --base-url http://127.0.0.1:8080

Полные команды своих тестов и исследований — student-tests/README.md.

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

  • контракт, полная OpenAPI-валидация, публичный smoke — PASS; 66 собственных тестов — OK;
  • отдельный чистый clone: build/up на новых секретах и пустых volumes, public smoke и provisioning Grafana — PASS;
  • перезапуск 13 контейнеров сохранил volumes, сессии и данные; обе API-реплики проверены отдельными failover;
  • четыре инцидента (worker, медленная БД, S3, Tempo/Loki): alerts firing → resolved; отказ Tempo/Loki не нарушил бизнес-запросы;
  • трек 1: off/on100/head10/tail, одинаковая нагрузка, два повтора; latency, CPU/RAM, ingest и сохранение редких трасс измерены. Tail уменьшил отправку спанов относительно приёма на 85.7 %;
  • на Windows выполнены Python-эквиваленты целей make check/validate/test. Серверный CI Gitea не заявляется как пройденный.

Ограничения / известные ошибки: Один Docker-host и по одному экземпляру stateful-компонентов; возможны потери телеметрии при простое backend. Два коротких повтора, фоновые процессы и накопленная БД ограничивают точность сравнения. TraceQL-окно включает прогрев, поэтому отношения сохранённых трасс приближённые. Первый полный S3 recovery probe превысил таймаут на ~58 тыс. вложений; после ограничения до 16 последних оригиналов persistence/failover прошли, оба вывода сохранены.

Источники и использование ИИ: Собственный код ЛР5, Python/uvicorn, asyncpg, aiobotocore, aio-pika, Pillow, OpenTelemetry и указанные хранилища. Первичные материалы — ссылки README; версии закреплены в репозитории. Claude/Codex помогали с кодом, тестами и оформлением; результаты проверены реальными запусками.

  • Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
  • Контракт и публичные тесты не ослаблены.
  • make check и make test выполнены эквивалентными Python-командами; приложен реальный вывод.
  • Сценарии отказов/безопасности своего уровня воспроизведены.
  • Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
  • README задания сохранён, REPORT.md содержит инструкцию именно моего решения.