Files
mtusi2026lab6/QUESTIONS.md
T
2026-11-11 05:51:59 +03:00

13 KiB
Raw Blame History

Вопросы и решения лабы 6

Решения, принятые без пользователя, и вопросы, которые не блокируют работу. Раздел на каждый change: ## <change>, внутри «Решения» и «Вопросы». Вопросы преподавателю дублируются в REPORT.md. План изменений лабы — PLAN.md.

Ответы пользователя перед прогоном (2026-11-11)

  • Оценка — 5, трек 1 «Цена наблюдаемости».
  • Хранилища — Prometheus (метрики), Loki (логи), Tempo (трассы), отдельными сервисами; интерфейс — Grafana.
  • Уровень 4 — два change: job-trace-propagation, затем slo-alerts.
  • Без пользователя можно (как в лабе 5): коммиты на ветках feat/<change>, ff-merge в solution/bvt2301-safronov, архивация, установка зависимостей и образов, запуск стенда и замеров, в конце git push ветки решения в свой fork. PR не открывать. Разрешения — .claude/settings.local.json.
  • Длинные замеры исключений (make bench_uploads, make bench_queue) — в последнем шаге, на коде лабы 6 с телеметрией.

Перенос из лабы 5

Источник: mtusi2026lab5-safronov, ветка solution/bvt2301-safronov, commit 046ec9e. Перенос — 2026-11-11.

Решения

  • Перенесены отслеживаемые файлы по AGENTS.md, «Переход в следующую лабу», git archive 046ec9e: src/, student-tests/, service-tests/, migrations/, alembic.ini, Dockerfile, docker-compose.yml, infra/valkey/, infra/haproxy/, infra/s3/, infra/rabbitmq/, infra/rollback/ (на него ссылаются balancer.md и откат реплик; в списке переноса его не было — список дополнен), свои scripts/restart.sh, scripts/stop-one.sh, scripts/rolling-update.sh, pyproject.toml, uv.lock, .python-version, config_example.toml, AGENTS.md, CLAUDE.md, .claude/, openspec/, .graphifyignore, bench/, KNOWN_ISSUES.md, .github/workflows/application.yml, .github/ci/.
  • Не перенесены: README.md, COURSE.md, tests/, contracts/, lab.json, REPORT.md, evidence/, graphify-out/, QUESTIONS.md (этот файл — новый), .env, config.toml, .venv.
  • Makefile, .gitignore, .dockerignore skeleton лаб 5 и 6 совпадают побайтно, поэтому взяты целиком из лабы 5 (skeleton + свои секции).
  • .env.example — свой файл лабы 5 без правок. Новые имена skeleton (OTEL_SERVICE_NAME, OTEL_EXPORTER_OTLP_ENDPOINT, OTEL_EXPORTER_OTLP_PROTOCOL, OTEL_RESOURCE_ATTRIBUTES) сопоставляет первый change лабы (PLAN.md), как BROKER_URL_FILE и др. в лабе 5.
  • Контракт API лабы 6 не изменился: contracts/openapi.json отличается только info (заголовок, версия 1.6.0), contracts/README.md и tests/ совпадают с лабой 5. Новое — contracts/observability.md, три роли в contracts/infrastructure.json (otel_collector, telemetry_storage с persistent volume, grafana с provisioning в git), infra/otel/README.md. tests/client.py для лабы 6 ведёт себя как для лабы 5 (загрузка — 202).
  • Имя проекта compose и образ — mtusi-lab6, mtusi-messenger:lab6 (docker-compose.yml, спеки container-run и container-image, правила docker.md и balancer.md, драйвер и SKILL.md, комментарии override CI и стенда отказов), префикс проектов CI — mtusi-lab6-safronov-ci-. Иначе стенд лабы 6 подключился бы к volumes лабы 5.
  • .claude/settings.local.json (не в git) — только запреты: удаление volumes лаб 5 и 6, make wipe_data, down -v, force push. Разрешения прогона лабы 5 (commit, merge, push) не перенесены: для лабы 6 их даёт пользователь перед прогоном (PLAN.md, «Что решает пользователь»).
  • Commit «до» профилей rollout, uploads, reconcile стенда bench/ (Profile.rollout_from, uploads_before, reconcile_before) указывали на commit лабы 5 (7f38948, 04f8592), которых в истории лабы 6 нет: профили отказали бы с кодом 2 до стенда. Они переведены на commit переноса 9cc6c0c отдельным коммитом, как cc33a03 в лабе 5. Там же код успеха варианта «до» профиля uploads — 202 вместо 201 (uploads_success_codes): «до» теперь код лабы 5, его загрузка отвечает 202; с 201 вариант насчитал бы ноль успешных.
  • Проверено на рабочем дереве после переноса: make check — PASS; ruff check и ruff format --check — чисто (545 файлов); make service_test — 215 passed; make run_docker на новом проекте mtusi-lab6 — см. дефект ниже, после повторного docker compose up -d --wait все сервисы healthy / running; make test — PASS («lab6 public API scenario»); make student_test — 223 passed, 1 failed: test_exclusion_evidence_exists (ожидаемо, evidence не переносится). Нет 10 файлов: evidence/attachments/failover.md, evidence/attachments/storage.md, evidence/auth/passwords-and-tokens.md, evidence/broker/isolated.md, evidence/broker/stand.md, evidence/cache/hits.md, evidence/idempotency/replay-after-restart.md, evidence/queue/baseline4/summary.md, evidence/replicas/test-persistence.md, evidence/uploads/baseline/summary.md. Сверка становится зелёной, когда они сняты заново на стенде лабы 6 (PLAN.md, шаг 0 и последний шаг).
  • Найден дефект первого старта RabbitMQ на пустом volume (eacces на .erlang.cookie из-за healthcheck от root): make run_docker из чистого clone падает на «dependency failed to start». Записан в KNOWN_ISSUES.md с предложением правки, не исправлен: правка входит в первый change (PLAN.md).

Вопросы

Пока нет: решения пользователя — раздел «Ответы пользователя перед прогоном».

otel-telemetry

Change openspec/changes/otel-telemetry/, propose 2026-11-11. Номера — решения design.

Решения

  • Развилки PLAN.md (раздел «1. otel-telemetry»): Collector — contrib 0.164.0, ради tail_sampling трека 1 (1); логи — из SDK, процессором structlog в обеих цепочках, а не filelog по журналам Docker (2); метрики — prometheus exporter Collector и scrape Prometheus, а не OTLP-приёмник Prometheus и не remote write (3); инструментирование — вручную в единственных точках вызова, библиотек автоинструментирования нет: instrumentation-sqlalchemy 0.66b2 требует sqlalchemy<2.1, а в lock 2.1.1 (4); relay и уборщик — без SDK до change 2 (5); scripts/restart.sh сервисы телеметрии не трогает, история проверяется telemetry-check (6); начальные лимиты телеметрии — 2,5 CPU и 2048 МиБ, итог — по замеру (7).
  • Версии — последние патчи линий, вышедшие хотя бы за две недели до прогона: Prometheus v3.15.1, Loki 3.7.9, Tempo 3.1.1; Grafana 13.3.1 — патч всех линий от 10.11 (1).
  • Настройки — секция [telemetry], по умолчанию выключено; стенд включает её окружением api и worker. Имена skeleton OTEL_* не настройки: SDK собирается из явных значений, переменные OTEL_* удаляются из окружения процесса с warning (8).
  • service.version — версия контракта 1.6.0 (заодно FastAPI(version=…) вместо устаревшего 1.5.0), а не commit сборки (9).
  • API не продолжает входящий traceparent клиента: публичная точка входа (10).
  • Класс статуса HTTP — первая цифра http.response.status_code в запросах; отдельной метки нет (10).
  • Исход доставки worker (ready, failed, retry, skipped, requeued, dropped, error) возвращает сервис, метрику и span пишет точка входа; меняется тип результата handle и быстрые тесты сервиса (11).
  • Текст исключений в span не пишется — только класс ошибки; traceback — в журнале (10, 12).
  • Закрытие SDK — со своим сроком в отдельном потоке: пробы — до 6 с на shutdown() при замороженном Collector (13).
  • Grafana — без состояния (tmpfs), без загрузки плагинов, лишние встроенные источники выключены (проба: 368 → 251 МиБ) (16).
  • Хранилища и Grafana — в отдельной сети telemetry, наружу — только Grafana на 127.0.0.1 (17).
  • Collector, Loki и Tempo без healthcheck Docker: в образах нет оболочки и HTTP-клиента; живость — up в Prometheus (18).
  • Брокер: healthcheck от пользователя брокера (gosu rabbitmq) — закрывает дефект первого старта (19).
  • Консоль, make test_isolated, стенд отказов и bench/ — без телеметрии (20).
  • Проверка «стенд с нуля» — команда драйвера со своим проектом compose, которая сама удаляет свои volumes: make wipe_data и down -v агенту запрещены (21).

Вопросы

Не блокируют работу; ответ меняет только указанное место.

  1. Преподавателю: класс статуса HTTP («method, route template, status class») — допустимо ли выводить его из кода статуса в запросах (http_response_status_code=~"5..") без отдельной метки? Иначе — атрибут http.response.status_class в middleware и в запросах dashboard.
  2. Преподавателю: restart hook перезапускает API и хранилища бизнес-данных, но не хранилища телеметрии; сохранность истории телеметрии показана отдельно (evidence/telemetry/check.md). Достаточно ли так? Иначе — строка в scripts/restart.sh.
  3. Преподавателю: service.version — версия контракта, а не ревизия сборки. Иначе — аргумент сборки и четыре пути сборки (design, решение 9).
  4. Преподавателю: ответы, которые генерирует HAProxy (502, 503, 504), в метрики API не попадают, метрик HAProxy на уровне 3 нет. Для SLO уровня 4 это решает change slo-alerts.
  5. Пользователю: метки последнего шага (make bench_uploads, make bench_queue) по методике bench/ снимаются с выключенным SDK: «код лабы 6 с телеметрией» — код есть, телеметрия выключена. Если нужны метки с включённой телеметрией — это профиль трека 1 (change track1-telemetry-cost) и другая методика.