Реализована лабораторная 6 на оценку 4

This commit is contained in:
MacBook
2026-11-16 15:16:54 +03:00
parent 470d9d6f1e
commit 4262a16ada
64 changed files with 8467 additions and 43 deletions
+43 -14
View File
@@ -1,18 +1,47 @@
## Лабораторная 6
Автор / группа: TODO
Целевая оценка (3/4/5): TODO
Трек 5, если заявлен: TODO
Автор / группа: **Меркулова М. А. / БВТ2303**
Целевая оценка: **4**. Трек 5 не заявлен.
Что реализовано и что перенесено: TODO
Команды запуска из чистого clone: TODO
Результаты проверок и ссылка на REPORT.md: TODO
Ограничения / известные ошибки: TODO
Источники и использование ИИ: TODO
### Реализация
- [ ] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
- [ ] Контракт и публичные тесты не ослаблены.
- [ ] make check и make test выполнены; приложен реальный вывод.
- [ ] Сценарии отказов/безопасности своего уровня воспроизведены.
- [ ] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
- [ ] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
Перенесена собственная 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.