ЛР6 - БПИ2301 - Антонова - на 4 #72

Open
k00kza wants to merge 2 commits from k00kza/mtusi2026lab6-fork:solution/BPI2301-Antonova into main
First-time contributor

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

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

Что реализовано и что перенесено: Из ЛР № 5 перенесены две реплики API за Nginx, Redis (сессии), MinIO, RabbitMQ, отдельный worker и PostgreSQL; бизнес-API не менялся. Добавлены: OpenTelemetry SDK в API и worker, отдельный OTel Collector, Prometheus (метрики), Loki (логи), Tempo (трассы) и Grafana с provisioning и импортируемым дашбордом; у каждого хранилища свой persistent volume. W3C trace context (traceparent/tracestate) сохраняется вместе с заданием и переносится API → RabbitMQ → worker, повторы видны по job.attempt. Структурные логи содержат trace_id/span_id; секреты, тела сообщений и изображения в телеметрию не попадают. Дашборд показывает p50/p95/p99 (из histogram, в секундах), долю ошибок, глубину и возраст очереди, пул БД и загрузку worker. SLO: ≥ 99% запросов без 5xx за 24 ч; alert rules MessengerHighErrorRate и MessengerQueueLag. Экспорт Collector ограничен очередью в 256 пакетов.

Команды запуска из чистого clone:
python scripts/init_local.py
docker compose --env-file .env up -d --build
python -m pytest -q
python tests/smoke.py --base-url <адрес API>
Остановка: docker compose --env-file .env down
Удаление учебных данных: docker compose --env-file .env down --volumes --remove-orphans
Подробности (версии образов, порты, миграции) — в REPORT.md.

Результаты проверок и ссылка на REPORT.md: REPORT.md. Прогон 22.11.2026, профиль full, все 13 шагов с кодом 0: pytest — 206 из 206; smoke — PASS; check_observability — PASS (метрики, логи, трассы, приватность, корреляция, история после перезапуска); persistence и failover — PASS (восстановление записи за 2,81 с). Оповещения при остановке PostgreSQL и worker сработали через 25,9 с и 32,7 с и снялись. При остановке Loki API записал 204 сообщения, очередь экспорта достигла 48 из 256 пакетов. Логи в evidence/lab6/.

Ограничения / известные ошибки: Один Docker-хост; нагрузка небольшая (10 запр./с, 10 с), это не тест производительности. Для проверки SLO нужно полное 24-часовое окно. Доставка оповещений наружу не реализована. При недоступном Loki часть логов теряется (6 пакетов в прогоне) ради ограниченной памяти. Вывод hook-скриптов restart.sh и stop-one.sh скрыт из-за секретов. Трек 5 не реализован.

Источники и использование ИИ: Контракт ЛР № 6, документация OpenTelemetry, W3C Trace Context, Prometheus, Loki, Tempo, Grafana provisioning; OpenTelemetry SDK 1.45.1. Codex помог перенести код из ЛР № 5 и адаптировать запуск.

  • Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
  • Контракт и публичные тесты не ослаблены.
  • make check и make test выполнены; приложен реальный вывод.
  • Сценарии отказов/безопасности своего уровня воспроизведены.
  • Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
  • README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
## Лабораторная 6 Автор / группа: Антонова Ирина Андреевна, БПИ2301 Целевая оценка (3/4/5): 4 Трек 5, если заявлен: не заявляется Что реализовано и что перенесено: Из ЛР № 5 перенесены две реплики API за Nginx, Redis (сессии), MinIO, RabbitMQ, отдельный worker и PostgreSQL; бизнес-API не менялся. Добавлены: OpenTelemetry SDK в API и worker, отдельный OTel Collector, Prometheus (метрики), Loki (логи), Tempo (трассы) и Grafana с provisioning и импортируемым дашбордом; у каждого хранилища свой persistent volume. W3C trace context (`traceparent`/`tracestate`) сохраняется вместе с заданием и переносится API → RabbitMQ → worker, повторы видны по `job.attempt`. Структурные логи содержат `trace_id`/`span_id`; секреты, тела сообщений и изображения в телеметрию не попадают. Дашборд показывает p50/p95/p99 (из histogram, в секундах), долю ошибок, глубину и возраст очереди, пул БД и загрузку worker. SLO: ≥ 99% запросов без 5xx за 24 ч; alert rules `MessengerHighErrorRate` и `MessengerQueueLag`. Экспорт Collector ограничен очередью в 256 пакетов. Команды запуска из чистого clone: python scripts/init_local.py docker compose --env-file .env up -d --build python -m pytest -q python tests/smoke.py --base-url <адрес API> Остановка: docker compose --env-file .env down Удаление учебных данных: docker compose --env-file .env down --volumes --remove-orphans Подробности (версии образов, порты, миграции) — в REPORT.md. Результаты проверок и ссылка на REPORT.md: [REPORT.md](REPORT.md). Прогон 22.11.2026, профиль full, все 13 шагов с кодом 0: pytest — 206 из 206; smoke — PASS; check_observability — PASS (метрики, логи, трассы, приватность, корреляция, история после перезапуска); persistence и failover — PASS (восстановление записи за 2,81 с). Оповещения при остановке PostgreSQL и worker сработали через 25,9 с и 32,7 с и снялись. При остановке Loki API записал 204 сообщения, очередь экспорта достигла 48 из 256 пакетов. Логи в evidence/lab6/. Ограничения / известные ошибки: Один Docker-хост; нагрузка небольшая (10 запр./с, 10 с), это не тест производительности. Для проверки SLO нужно полное 24-часовое окно. Доставка оповещений наружу не реализована. При недоступном Loki часть логов теряется (6 пакетов в прогоне) ради ограниченной памяти. Вывод hook-скриптов restart.sh и stop-one.sh скрыт из-за секретов. Трек 5 не реализован. Источники и использование ИИ: Контракт ЛР № 6, документация OpenTelemetry, W3C Trace Context, Prometheus, Loki, Tempo, Grafana provisioning; OpenTelemetry SDK 1.45.1. Codex помог перенести код из ЛР № 5 и адаптировать запуск. - [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами. - [x] Контракт и публичные тесты не ослаблены. - [x] make check и make test выполнены; приложен реальный вывод. - [x] Сценарии отказов/безопасности своего уровня воспроизведены. - [x] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens. - [x] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
k00kza added 2 commits 2026-11-22 20:15:53 +03:00
You are not authorized to merge this pull request.
This pull request can be merged automatically.
View command line instructions

Checkout

From your project repository, check out a new branch and test the changes.
git fetch -u https://gitea.privcloud.tech/k00kza/mtusi2026lab6-fork solution/BPI2301-Antonova:k00kza-solution/BPI2301-Antonova
git checkout k00kza-solution/BPI2301-Antonova
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: mtusi2026/mtusi2026lab6#72