Files
mtusi2026lab6/REPORT.md
T

5.3 KiB
Raw Blame History

Лабораторная6 — Маслов, БВТ2301

Цель:5, трек2 — SLO и обнаружение инцидентов. Собственная ЛР5 перенесена поверх текущего skeleton с независимой историей; contracts/tests/README и исходные check/validate сохранены. Эта версия — начало runtime-проверок: результаты исследования, clean clone и публикация пока не подтверждены.

Запуск

Нужны Docker Desktop с Compose v2, Git и uv0.13.7. Python3.14.7; SDK OpenTelemetry1.45.2, Collector0.165.0, Prometheus3.16.0, Loki3.7.10, Tempo3.1.1, Grafana13.3.1. Lock и digest в Git; MinIO/mc собираются из точных upstream commits собственной ЛР5 с проверкой GoSumDB.

uv sync --locked
make bootstrap
VCS_REF=$(git rev-parse HEAD) docker compose up -d --build --wait
make check validate lint unit PYTHON=.venv/bin/python
NO_PROXY=localhost,127.0.0.1 no_proxy=localhost,127.0.0.1 make test PYTHON=.venv/bin/python
make test-student

API http://127.0.0.1:8086, Grafana http://127.0.0.1:3006, user admin, локальный пароль secrets/grafana_password. Bootstrap сохраняет прежние файлы и не печатает значения. Datasources/dashboard импортируются автоматически. Остальные telemetry ports внутренние. docker compose down сохраняет volumes. Fault hooks включаются только явным compose.test.yaml.

Архитектура и измерения

API/worker/relay/observer → OTLP/HTTP → Collector → Prometheus/Loki/Tempo; Grafana — интерфейс запросов, а не хранилище трёх сигналов. История backend сохраняется в отдельных томах. Сессии/ACL/идемпотентность/S3/outbox/worker сохранены. Migration005 добавляет W3C context и однократные SLI-решения jobs. Контекст идёт от server span в принимающую транзакцию и outbox, через relay producer span к consumer и дочернему процессу с S3/DB spans, включая retry.

Логи имеют allowlist полей. Тела/пароли/Authorization/SQL/rawURL не экспортируются; exception messages/stack traces не добавляются к spans. Метрики используют route template, ограниченный HTTP method и status class, job type/outcome. Технические IDs допустимы только в логах/трассах синтетических данных.

Dashboard содержит18панелей. p50/p95/p99 вычисляются из общих histogram buckets; SDK HTTP duration измеряет ASGI response. API availability SLI берётся с HAProxy business backend, включая ingress503; health идёт отдельным backend. Ready SLI включает и незавершённые после10s задания. SDK queues512records, timeout0.75s; Collector memory limiter192MiB/batch≤256/queues32/finite retry10s. Политика SLO99%/30m, учебный профиль, окна burn rate и шаги диагностики: RUNBOOK, rules. Фактические имена/единицы панелей будут сверены перед финальным отчётом.

Результаты начальной проверки

Offline/OpenAPI/lint и25unit PASS. Новые unit проверяют перенос causal context между завершёнными producer/consumer spans и отсутствие чувствительных данных. Сначала исправлены импорт Observation из API SDK и сериализация enum severity в тестовом приёмнике; privacy assertions сохранены. Runtime evidence появится только после реального запуска; конфигурация не считается результатом.

Источники и границы

Текущее задание, собственная ЛР5, pinned libraries и официальные материалы: Python OTLP, Loki OTLP, Tempo3.1.1, Collector exporter, Prometheus alerts. Помощь ИИ использована при проектировании, реализации, проверках и отчёте. Чужие студенческие решения/истории/измерения не использовались. Один host/PG/S3/broker/LB остаются SPOF; нет защиты от потери диска. HTTP только локальный с синтетическими данными. TLS/mTLS вводятся независимо в ЛР7.