Files
mtusi2026lab6/.github/pull_request_template.md

3.3 KiB
Raw Permalink Blame History

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

Автор / группа: Меркулова М. А. / БВТ2303 Целевая оценка: 4. Трек 5 не заявлен.

Реализация

Перенесена собственная lab5: две Go API-реплики, Nginx, PostgreSQL, Redis sessions, MinIO, Redis Streams/outbox/worker, варианты изображений и обработка отказов.

Добавлены OTel Go SDK и отдельный Collector; Prometheus, Loki, Tempo и Grafana с persistent volumes и provisioning. HTTP/API, producer/consumer и S3/DB/image spans связаны W3C context через durable job и broker, включая retry. Структурные logs связаны с trace/request IDs; секреты и business payload не экспортируются. Dashboard показывает histogram percentiles, errors/RPS, queue lag/depth, DB pool, worker saturation/heartbeat и CPU/RAM. Есть SLI/SLO, два alert rules, memory limiter/batch/bounded queues и runbook.

Запуск

sh scripts/init-local.sh
docker compose --env-file .env up -d --build --wait
make check
make test
python3 student-tests/verify_observability.py
python3 student-tests/verify_incidents.py
python3 student-tests/verify_resilience.py

API по умолчанию 8080, Grafana 13000. При занятом 8080 изменить APP_PORT в .env и передать BASE_URL тестам. Локальная проверка: API 18086, Grafana 13000; Grafana admin password создаётся в secrets и не коммитится.

Доказательства

Worker stop → queue lag firing/resolved; PostgreSQL stop → DB error spans и error-rate firing/resolved. Tempo stop под нагрузкой → бизнес-записи сохранены, queue/RAM ограничены, drops посчитаны. Чистый запуск с новыми secrets и8 пустыми volumes прошёл.

Ограничения и источники

Один Docker-host, нет HA хранилищ; telemetry при отказах может теряться. Sampling ParentBased/AlwaysSample для локального стенда; треки 5 не заявлены. Источники — собственная lab5 и официальные OTel/Grafana/Prometheus/W3C docs; помощь ИИ Codex описана в REPORT.md.

  • Минимум lab5 и бизнес-контракт сохранены.
  • Обязательные contracts/tests/README/Makefile не изменены.
  • make check, make test, Go tests/vet и собственные проверки выполнены.
  • Три сигнала, W3C chain и provisioning проверены на реальных данных.
  • Alerts и telemetry backend outage воспроизведены.
  • Секреты исключены из Git.