forked from mtusi2026/mtusi2026lab6
56 lines
3.8 KiB
Markdown
56 lines
3.8 KiB
Markdown
## Лабораторная 6 — наблюдаемость, оценка 5, трек 2
|
||
|
||
Автор / группа: Савельев Иван / БВТ2304.
|
||
|
||
### Результат
|
||
|
||
Сохранён работающий pipeline lab5. Добавлены явный OTel SDK для API/worker/publisher,
|
||
Collector, Prometheus, Loki, Tempo и Grafana с provisioning трёх источников и
|
||
импортируемым dashboard на 19 панелей. W3C context хранится в durable job/outbox,
|
||
проходит через broker и сохраняет цепочку при retry до S3/DB ready.
|
||
|
||
Реализованы SLO доступности API 99%/1h и готовности изображения 95% за 30s/1h.
|
||
SLI изображений учитывает failed, late и не завершившиеся jobs. Fast/slow burn
|
||
alerts используют пары 2m/30s и 6m/1m, guards и for; есть high error rate и queue lag.
|
||
Исследование сравнивает короткий всплеск с длительными отказами DB/worker,
|
||
измеряет detection/resolution и ложные срабатывания. Разбор причин использует
|
||
сохранённые метрики, логи и реальные traces; запросы собраны в runbook.
|
||
|
||
### Запуск и проверки
|
||
|
||
```sh
|
||
python3 -m venv .venv
|
||
.venv/bin/python -m pip install -r requirements.txt -r requirements-dev.txt
|
||
./scripts/start.sh
|
||
./scripts/check-lab6.sh
|
||
```
|
||
|
||
- API: http://localhost:8080.
|
||
- Dashboard: http://localhost:3000/d/messenger-lab6, локальный Viewer.
|
||
- [Отчёт, результаты, версии и ограничения](../REPORT.md).
|
||
- [Runbook](../docs/runbook.md), [методика](../research/README.md).
|
||
- API/39 собственных tests: `evidence/lab6-api-checks.txt`.
|
||
- 17 групп сохранённых критериев lab5: `evidence/lab6-lab5-regression.json`.
|
||
- Trace с retry и логи: `evidence/lab6-trace-retry.json`, `evidence/lab6-correlated-logs.json`.
|
||
- Loki outage/ограниченная RAM/измеренные потери: `evidence/lab6-checks.json`.
|
||
- Реальные restart/volumes: `evidence/lab6-restart.json`, `evidence/lab6-telemetry-persistence.json`.
|
||
- Трек 2: `evidence/lab6-slo-research.json`, `evidence/lab6-slo-series.json`.
|
||
- Проверки правил: `evidence/lab6-promtool.txt`.
|
||
|
||
### Ограничения
|
||
|
||
Один host; потеря диска/volumes не покрыта. Telemetry buffer ограничен и допускает
|
||
измеряемые потери при недоступном backend. SLO периода час задан, но один короткий
|
||
live эксперимент проверяет детектор, а не долгосрочную надёжность. Отказы LB/сети
|
||
до API требуют отдельного внешнего SLI. Внешняя доставка alerts не требуется.
|
||
|
||
Источники — ТЗ и официальная документация OTel, W3C, Grafana/Prometheus и Google SRE
|
||
Workbook; ссылки в REPORT.md. Реализация и проверки подготовлены с помощью Codex.
|
||
|
||
- [x] Минимум предыдущей работы сохранён.
|
||
- [x] Обязательные контракты и публичные tests не изменены.
|
||
- [x] Три сигнала поступают в реальные persistent stores; dashboard provisioned из Git.
|
||
- [x] Секреты, тела сообщений/изображений и SQL/params не экспортируются.
|
||
- [x] Локальные .env/secrets и runtime artifacts исключены из Git.
|
||
- [x] Условия alerts, окна, for и runbook сохранены в Git.
|