ЛР 6 - БПИ2304 - Афанасьев Андрей - на 3 #32

Closed
afanasefff_a wants to merge 1 commits from afanasefff_a/mtusi2026lab6:solution/bpi2304-afanasyev-lab6 into main
First-time contributor

Лабораторная 6
Автор / группа: Афанасьев Андрей, БПИ2304
Целевая оценка (3/4/5): 3
Трек 5, если заявлен: не заявляется.
Что реализовано и что перенесено
Перенесена основная инфраструктура предыдущей лабораторной: API, PostgreSQL, persistent storage, RabbitMQ, отдельный Worker, Nginx и асинхронная обработка изображений.
Реализована система наблюдаемости:
•
endpoint /metrics с метриками Prometheus;
•
OpenTelemetry Collector для приёма OTLP-данных;
•
Prometheus для хранения метрик;
•
Grafana для визуализации;
•
автоматическое подключение Prometheus как источника данных;
•
автоматическая загрузка dashboard через provisioning;
•
метрики количества HTTP-запросов;
•
метрики запросов по route, методу и классу ответа;
•
счётчик ошибок 5xx;
•
метрика суммарного времени обработки запросов;
•
структурированные логи API с request_id, service, method, path, status и duration;
•
структурированные события Worker при запуске и успешной обработке заданий;
•
ограничение кардинальности метрик: пользовательские идентификаторы, токены, пароли и тела сообщений не передаются в telemetry;
•
конфигурация Collector с memory_limiter и batch processor;
•
persistent volumes для Prometheus и Grafana.
Добавлены конфигурации Docker Compose, OpenTelemetry Collector, Prometheus и Grafana, а также dashboard observability/dashboard.json.
Команды запуска из чистого clone
Требуются Docker и Docker Compose.
git clone https://gitea.privcloud.tech/afanasefff_a/mtusi2026lab6
cd mtusi2026lab6

make check
docker compose config --quiet
docker compose up -d --build --wait
make test
Основные адреса сервисов:
API: http://localhost:8080
Prometheus: http://localhost:9090
Grafana: http://localhost:3000
Проверка метрик:
curl http://localhost:8080/metrics
Перезапуск стенда с сохранением данных:
./scripts/restart.sh
Остановка:
docker compose down
Результаты проверок и ссылка на REPORT.md
Подробная инструкция, описание архитектуры и ограничения приведены в REPORT.md.
Результаты:
•
make check — PASS;
•
docker compose config --quiet — PASS;
•
docker compose build — PASS;
•
make test — PASS;
•
endpoint /metrics возвращает метрики в формате Prometheus;
•
Grafana успешно запускается и автоматически подключает Prometheus;
•
dashboard импортируется из конфигурации проекта;
•
API, PostgreSQL, RabbitMQ, Worker, Collector, Prometheus и Grafana запускаются в общем Compose-стенде;
•
публичный smoke-тест проверяет авторизацию, чаты, сообщения, вложения, асинхронную обработку и thumbnail;
•
при остановке Worker принятое задание сохраняется в очереди и обрабатывается после восстановления Worker.
Ограничения / известные ошибки
Целевая оценка — 3. Уровень 4 и исследовательский трек уровня 5 не заявляются.
Полная W3C-пропагация trace context через RabbitMQ от API до Worker не реализована. Producer/consumer spans и единая сквозная трасса обработки задания не добавлены. Alert rules, queue lag, p50/p95/p99 и расширенные панели состояния Worker не реализованы. Отдельные Loki и Tempo в текущей конфигурации не используются. Полноценные нагрузочные эксперименты по стоимости observability не проводились.
Весь обязательный минимум текущей и предыдущих лабораторных сохранён. Контракт и публичные тесты не изменялись. Локальные данные и persistent volumes не удаляются при обычном перезапуске стенда.

Лабораторная 6 Автор / группа: Афанасьев Андрей, БПИ2304 Целевая оценка (3/4/5): 3 Трек 5, если заявлен: не заявляется. Что реализовано и что перенесено Перенесена основная инфраструктура предыдущей лабораторной: API, PostgreSQL, persistent storage, RabbitMQ, отдельный Worker, Nginx и асинхронная обработка изображений. Реализована система наблюдаемости: • endpoint /metrics с метриками Prometheus; • OpenTelemetry Collector для приёма OTLP-данных; • Prometheus для хранения метрик; • Grafana для визуализации; • автоматическое подключение Prometheus как источника данных; • автоматическая загрузка dashboard через provisioning; • метрики количества HTTP-запросов; • метрики запросов по route, методу и классу ответа; • счётчик ошибок 5xx; • метрика суммарного времени обработки запросов; • структурированные логи API с request_id, service, method, path, status и duration; • структурированные события Worker при запуске и успешной обработке заданий; • ограничение кардинальности метрик: пользовательские идентификаторы, токены, пароли и тела сообщений не передаются в telemetry; • конфигурация Collector с memory_limiter и batch processor; • persistent volumes для Prometheus и Grafana. Добавлены конфигурации Docker Compose, OpenTelemetry Collector, Prometheus и Grafana, а также dashboard observability/dashboard.json. Команды запуска из чистого clone Требуются Docker и Docker Compose. git clone https://gitea.privcloud.tech/afanasefff_a/mtusi2026lab6 cd mtusi2026lab6 make check docker compose config --quiet docker compose up -d --build --wait make test Основные адреса сервисов: API: http://localhost:8080 Prometheus: http://localhost:9090 Grafana: http://localhost:3000 Проверка метрик: curl http://localhost:8080/metrics Перезапуск стенда с сохранением данных: ./scripts/restart.sh Остановка: docker compose down Результаты проверок и ссылка на REPORT.md Подробная инструкция, описание архитектуры и ограничения приведены в REPORT.md. Результаты: • make check — PASS; • docker compose config --quiet — PASS; • docker compose build — PASS; • make test — PASS; • endpoint /metrics возвращает метрики в формате Prometheus; • Grafana успешно запускается и автоматически подключает Prometheus; • dashboard импортируется из конфигурации проекта; • API, PostgreSQL, RabbitMQ, Worker, Collector, Prometheus и Grafana запускаются в общем Compose-стенде; • публичный smoke-тест проверяет авторизацию, чаты, сообщения, вложения, асинхронную обработку и thumbnail; • при остановке Worker принятое задание сохраняется в очереди и обрабатывается после восстановления Worker. Ограничения / известные ошибки Целевая оценка — 3. Уровень 4 и исследовательский трек уровня 5 не заявляются. Полная W3C-пропагация trace context через RabbitMQ от API до Worker не реализована. Producer/consumer spans и единая сквозная трасса обработки задания не добавлены. Alert rules, queue lag, p50/p95/p99 и расширенные панели состояния Worker не реализованы. Отдельные Loki и Tempo в текущей конфигурации не используются. Полноценные нагрузочные эксперименты по стоимости observability не проводились. Весь обязательный минимум текущей и предыдущих лабораторных сохранён. Контракт и публичные тесты не изменялись. Локальные данные и persistent volumes не удаляются при обычном перезапуске стенда.
afanasefff_a added 1 commit 2026-11-16 21:44:48 +03:00
Owner

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

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