forked from mtusi2026/mtusi2026lab6
Реализована лабораторная 6 на оценку 4
This commit is contained in:
@@ -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.
|
||||
|
||||
Reference in New Issue
Block a user