forked from mtusi2026/mtusi2026lab6
48 lines
3.3 KiB
Markdown
48 lines
3.3 KiB
Markdown
## Лабораторная 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.
|