Files
mtusi2026lab6/REPORT.md
T

3.6 KiB
Raw Blame History

Отчёт — лабораторная 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-тесты.