Files
mtusi2026lab6/.github/pull_request_template.md

48 lines
3.3 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
## Лабораторная 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
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 и не коммитится.
### Доказательства
- [Отчёт](../REPORT.md)
- [Команды и результаты](../evidence/lab6-results.md)
- [Сигналы, trace и logs](../evidence/observability-grade4.json)
- [Инциденты и alert firing/resolved](../evidence/incidents-grade4.json)
- [Dashboard JSON](../infra/otel/grafana/dashboards/messenger.json)
- [Runbook и SLO](../infra/otel/runbook.md)
- [Перезапуски и persistent история](../evidence/resilience.json)
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.
- [x] Минимум lab5 и бизнес-контракт сохранены.
- [x] Обязательные contracts/tests/README/Makefile не изменены.
- [x] make check, make test, Go tests/vet и собственные проверки выполнены.
- [x] Три сигнала, W3C chain и provisioning проверены на реальных данных.
- [x] Alerts и telemetry backend outage воспроизведены.
- [x] Секреты исключены из Git.