Files
mtusi2026lab6/.github/pull_request_template.md
2026-11-18 21:37:25 +03:00

38 lines
3.1 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: OpenTelemetry и Grafana
Автор / группа: Хакимов Дмитрий БВТ2301
Целевая оценка: **5**. Трек 1: **цена наблюдаемости**.
Из lab5 перенесены API, PostgreSQL, Redis Streams, S3 и worker с durable outbox/retry.
Добавлены SDK traces/metrics/logs, Collector, Prometheus, Loki, Tempo и Grafana.
W3C context сохраняется вместе с job; API, publish, consume, S3/DB и retry видны в одной трассе.
Dashboard, datasources и два alerts provisioned из Git. Назначение компонентов и сигналы описаны в REPORT.md.
Запуск из чистого clone: `make up`, `make wait`, `make test`.
API: http://localhost:18086. Grafana: http://localhost:13000/d/messenger/messenger-observability.
Подробные prerequisites, bootstrap, остановка и удаление учебных данных: [REPORT.md](../REPORT.md).
Проверки: OpenAPI/contract, Go tests с race detector, public smoke, persistence и API failover прошли.
Полный fault suite подтвердил worker backlog, retry при отказе S3, DB timeout и работу API без Tempo.
Отдельный backend outage: 35/35 записей успешны, потеряны 3 request traces, queue27/256→0, OOM нет.
Исследование: 8 опытов,960 запросов,48 изображений ready,0 неожиданных ошибок.
Sampling50% уменьшил trace ingest на48,10%; сохранены125/240 request traces.
Методика, latency/CPU/RAM/ingest и ограничения: [RESEARCH.md](../RESEARCH.md).
Runbook: [RUNBOOK.md](../RUNBOOK.md); разбор отказов: [INCIDENTS.md](../INCIDENTS.md).
Все доказательства находятся в evidence/; результаты прежней lab5 не выдаются за результаты lab6.
Ограничения: один host, head sampling теряет часть ошибок и медленных запросов,
короткая нагрузка не доказывает улучшение latency или предельный throughput.
Начальный OOM Tempo исправлен увеличением cgroup и ограничением Go heap; неуспешные журналы сохранены.
Основа реализации — проект lab5; источники SDK и документации указаны в REPORT.md.
- [x] Обязательный минимум lab5 и lab6 сохранён.
- [x] Контракт и публичные tests не ослаблены.
- [x] make check, validate и make test выполнены; реальный вывод приложен.
- [x] Сценарии отказов и исследование воспроизведены.
- [x] Credentials находятся вне Git; evidence не содержит session tokens или тел сообщений.
- [x] README задания сохранён, REPORT.md описывает это решение.
🤖 Generated with [O3 Agent Codex](https://o3-agent.o3t.ru)