42 lines
5.4 KiB
Markdown
42 lines
5.4 KiB
Markdown
## Лабораторная 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
|
|
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](https://gitea.privcloud.tech/kolya/mtusi2026lab6/src/branch/solution/bpi2302-kushnarenko/student-tests/README.md).
|
|
|
|
Результаты проверок и ссылка на REPORT.md:
|
|
[REPORT.md](https://gitea.privcloud.tech/kolya/mtusi2026lab6/src/branch/solution/bpi2302-kushnarenko/REPORT.md), [Word](https://gitea.privcloud.tech/kolya/mtusi2026lab6/src/branch/solution/bpi2302-kushnarenko/docs/report_lab6.docx), [вывод 66 тестов](https://gitea.privcloud.tech/kolya/mtusi2026lab6/src/branch/solution/bpi2302-kushnarenko/evidence/checks_2026-11-12.txt), [текущие доказательства](https://gitea.privcloud.tech/kolya/mtusi2026lab6/src/branch/solution/bpi2302-kushnarenko/evidence/recheck_2026-11-12).
|
|
- контракт, полная 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 помогали с кодом, тестами и оформлением; результаты проверены реальными запусками.
|
|
|
|
- [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
|
|
- [x] Контракт и публичные тесты не ослаблены.
|
|
- [x] make check и make test выполнены эквивалентными Python-командами; приложен реальный вывод.
|
|
- [x] Сценарии отказов/безопасности своего уровня воспроизведены.
|
|
- [x] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
|
|
- [x] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
|