ЛР6 — БПИ2302 — Перевалова — на 3 #30

Closed
perevalova wants to merge 1 commits from perevalova/mtusi2026lab6:lab6-observability into main
First-time contributor

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

Автор / группа: Перевалова Виктория, БПИ2302

Целевая оценка (3/4/5): 3

Трек 5, если заявлен: не заявляется.

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

Перенесена основная инфраструктура предыдущей лабораторной: API, PostgreSQL, S3 (SeaweedFS), RabbitMQ, Worker и Outbox Publisher.

Реализована система наблюдаемости:

  • OpenTelemetry SDK-инструментация API и Worker;
  • OpenTelemetry Collector для приёма и маршрутизации телеметрии;
  • Prometheus для хранения метрик;
  • Loki для хранения логов;
  • Tempo для хранения трасс;
  • Grafana для визуализации;
  • автоматическая настройка источников данных и загрузка дашборда через provisioning;
  • метрики обработки фоновых заданий.

Добавлены конфигурации Docker Compose, Collector, хранилищ телеметрии и Grafana.

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

Требуются Python 3.11, Docker и Docker Compose.

python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install -r requirements.txt

Создать локальный .env на основе .env.example и заполнить необходимые настройки.

docker compose config --quiet
docker compose up -d --build
docker compose ps

Проверки:

python scripts/check_contract.py
python tests/smoke.py --base-url "http://localhost:18082"

Остановка:

docker compose down

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

Подробная инструкция, архитектура, результаты экспериментов и ограничения приведены в REPORT.md.

Результаты:

  • python scripts/check_contract.py — PASS.
  • python tests/smoke.py --base-url "http://localhost:18082" — PASS.
  • docker compose config --quiet — PASS.
  • Нагрузочный тест: 60 успешных запросов, 0 ошибок, 1,86 RPS; p50 — 2078 мс, p95 — 2125 мс, p99 — 2141 мс.
  • Контролируемая остановка Worker: задание осталось в очереди и успешно обработалось после восстановления Worker.
  • Конфигурации Grafana, Prometheus, Loki, Tempo и OpenTelemetry Collector добавлены в репозиторий.

Проверки make check и make test запускались напрямую через соответствующие Python-скрипты, поскольку GNU Make в Windows PowerShell отсутствует.

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

Целевая оценка — 3. Уровень 4 и исследовательский трек уровня 5 не заявляются.

Повторная проверка API при остановленных хранилищах телеметрии не завершилась успешно из-за истёкшего токена авторизации (401 Unauthorized).

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

Использованы официальная документация OpenTelemetry, Prometheus и Grafana. ChatGPT использовался для помощи при разработке, настройке инфраструктуры, диагностике ошибок и подготовке отчёта.

  • Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
  • Контракт и публичные тесты не ослаблены.
  • check и test выполнены через соответствующие Python-скрипты; реальные результаты приведены выше.
  • Все сценарии отказов из общего задания воспроизведены.
  • Локальные секреты и виртуальное окружение исключены из Git; отчёт не содержит токенов.
  • README задания сохранён, REPORT.md содержит инструкцию запуска и описание реализации.
## Лабораторная 6 **Автор / группа:** Перевалова Виктория, БПИ2302 **Целевая оценка (3/4/5):** 3 **Трек 5, если заявлен:** не заявляется. ### Что реализовано и что перенесено Перенесена основная инфраструктура предыдущей лабораторной: API, PostgreSQL, S3 (SeaweedFS), RabbitMQ, Worker и Outbox Publisher. Реализована система наблюдаемости: - OpenTelemetry SDK-инструментация API и Worker; - OpenTelemetry Collector для приёма и маршрутизации телеметрии; - Prometheus для хранения метрик; - Loki для хранения логов; - Tempo для хранения трасс; - Grafana для визуализации; - автоматическая настройка источников данных и загрузка дашборда через provisioning; - метрики обработки фоновых заданий. Добавлены конфигурации Docker Compose, Collector, хранилищ телеметрии и Grafana. ### Команды запуска из чистого clone Требуются Python 3.11, Docker и Docker Compose. ```powershell python -m venv .venv .\.venv\Scripts\Activate.ps1 python -m pip install -r requirements.txt ``` Создать локальный `.env` на основе `.env.example` и заполнить необходимые настройки. ```powershell docker compose config --quiet docker compose up -d --build docker compose ps ``` Проверки: ```powershell python scripts/check_contract.py python tests/smoke.py --base-url "http://localhost:18082" ``` Остановка: ```powershell docker compose down ``` ### Результаты проверок и ссылка на REPORT.md Подробная инструкция, архитектура, результаты экспериментов и ограничения приведены в `REPORT.md`. Результаты: - `python scripts/check_contract.py` — PASS. - `python tests/smoke.py --base-url "http://localhost:18082"` — PASS. - `docker compose config --quiet` — PASS. - Нагрузочный тест: 60 успешных запросов, 0 ошибок, 1,86 RPS; p50 — 2078 мс, p95 — 2125 мс, p99 — 2141 мс. - Контролируемая остановка Worker: задание осталось в очереди и успешно обработалось после восстановления Worker. - Конфигурации Grafana, Prometheus, Loki, Tempo и OpenTelemetry Collector добавлены в репозиторий. Проверки `make check` и `make test` запускались напрямую через соответствующие Python-скрипты, поскольку GNU Make в Windows PowerShell отсутствует. ### Ограничения / известные ошибки Целевая оценка — 3. Уровень 4 и исследовательский трек уровня 5 не заявляются. Повторная проверка API при остановленных хранилищах телеметрии не завершилась успешно из-за истёкшего токена авторизации (401 Unauthorized). ### Источники и использование ИИ Использованы официальная документация OpenTelemetry, Prometheus и Grafana. ChatGPT использовался для помощи при разработке, настройке инфраструктуры, диагностике ошибок и подготовке отчёта. - [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами. - [x] Контракт и публичные тесты не ослаблены. - [x] `check` и `test` выполнены через соответствующие Python-скрипты; реальные результаты приведены выше. - [x] Все сценарии отказов из общего задания воспроизведены. - [x] Локальные секреты и виртуальное окружение исключены из Git; отчёт не содержит токенов. - [x] README задания сохранён, `REPORT.md` содержит инструкцию запуска и описание реализации.
perevalova added 1 commit 2026-11-16 19:27:04 +03:00
Owner

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

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