Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
3.6 KiB
Отчёт — лабораторная 6
Автор / группа: Афанасьев Андрей, БПИ2304
Целевая оценка: 3
Трек 5: не заявлен
Что перенесено из lab5
Сохранены PostgreSQL, две API-реплики, Nginx, RabbitMQ, отдельный worker, persistent staging, асинхронная обработка вложений, JPEG thumbnail, статусы queued/processing/ready/failed и идемпотентная фиксация результата.
Что реализовано
Добавлена наблюдаемость API и worker:
/metricsотдаёт Prometheus-метрики HTTP requests, 5xx errors и длительности запросов;- структурные логи содержат
service,request_id, route, status и duration; - worker пишет структурные события обработки job;
- добавлен OpenTelemetry Collector с OTLP receivers, memory limiter и batch processor;
- добавлен Prometheus с persistent volume;
- добавлен Grafana с автоматическим datasource provisioning и импортируемым dashboard;
- конфигурации Collector, Prometheus и Grafana находятся в
observability/; - в Compose добавлены отдельные сервисы
otel-collector,prometheusиgrafana; - пользовательские идентификаторы, тела сообщений, пароли и токены не используются в labels метрик.
Назначение хранилищ: Prometheus хранит числовые метрики, Grafana визуализирует панели, а Collector принимает OTLP-сигналы и ограничивает буферизацию. Логи контейнеров остаются структурированными и доступны через docker compose logs.
Запуск
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. Перезапуск выполняется ./scripts/restart.sh без удаления volumes.
Результаты проверок
make check— PASS;docker compose config --quiet— PASS;docker compose build— PASS;- публичный
make test— PASS; /metricsсодержит низкокардинальные HTTP-метрики;- dashboard Grafana и datasource импортируются из файлов репозитория.
Ограничения
Для целевой оценки 3 не заявлены полноценная W3C-пропагация trace context через RabbitMQ, end-to-end span-цепочка API → worker → S3/DB, alert rules, p95/p99 панели, queue lag и fault-injection уровня 4. Collector и конфигурация OTLP включены в общий стенд; бизнес-API не зависит от доступности telemetry backend. Для production следует дополнить Java instrumentation официальным OpenTelemetry SDK и подключить долговременное хранилище логов и traces.
Использованные технологии: Java 21, PostgreSQL, RabbitMQ, Nginx, Docker Compose, Prometheus, OpenTelemetry Collector, Grafana, Jackson, MinIO SDK, Java ImageIO и Python-тесты.