Files
mtusi2026lab3/openspec/changes/profile-resources/proposal.md
T
2026-10-12 17:22:14 +03:00

8.2 KiB
Raw Blame History

Proposal

Why

COURSE.md, «Воспроизводимость и честные измерения»: минимальный отчёт о нагрузке включает CPU/RAM. У профилей уровня «4» — make bench_failover (метка evidence/failover/baseline/) и make bench_rollout (evidence/rollout/baseline/) — в сводной таблице REPORT.md строка «CPU / RAM» говорит «только лимиты, использование не снималось». Не видно, сколько ядер и памяти берёт каждая реплика до отказа, выжившая реплика в окне отказа, перезапуск реплики, третья реплика и миграция во время замены, и есть ли запас до лимитов.

У серий трека 1 это уже измеряется: посекундный сэмплер bench/sampler.sh и разбор его строк в bench/scaling.py. Их можно применить к профилям уровня «4», не трогая нагрузку, фазы и лимиты.

What Changes

  • Сэмплер в профилях failover, failover_quick, rollout, rollout_quick. Тот же bench/sampler.sh в том же контейнере mtusi-bench-sampler (0,25 CPU / 128 МиБ) работает от начала первой нагрузки до конца последней.

    • Новый режим scan: раз в секунду сэмплер читает счётчики каждой cgroup контейнера Docker и ВМ. Роль контейнера оркестратор определяет по меткам compose: реплика, PostgreSQL, LB, Valkey, миграция; k6 и сэмплер — по имени.
    • В режиме scan сэмплер не открывает соединение с PostgreSQL и не опрашивает статистику LB, а его контейнер работает без сети: профилям эти отсчёты не нужны, и наблюдатель не нагружает то, что меряет.
    • Так видны и реплики, созданные посреди замены. Остановленная, убитая, замороженная или пересозданная реплика расчёт не ломает.
    • Серии трека 1 передают сэмплеру явный список контейнеров, как раньше: их отсчёты и методика не меняются.
  • Окна и агрегаты — новый модуль bench/resources.py (stdlib, без docker, --selftest).

    • По каждому компоненту: CPU (среднее и посекундный максимум), пик памяти, доля троттлинга. Плюс занятые ядра ВМ.
    • Счётчики режутся на сегменты: сброс при новой cgroup, пропуск остановленного контейнера, ноль прироста у замороженного.
    • Окна failover — до действия, окно отказа, после возврата. Окна rollout — до, подготовка скрипта (проверки и сборка), замена, после.
    • CPU на успешный запрос — только в установившихся окнах: failover — до действия, rollout — до и после. Почему не в остальных — design.
  • Файлы метки:

    • samples.csv — посекундно по компонентам, секунды от действия или от начала замены, часы ВМ Docker;
    • resources.csv — строка на фазу × окно × компонент;
    • раздел ресурсов в summary.md;
    • лимиты сэмплера и бюджет ВМ в meta.json.

    Сумма лимитов CPU стенда на пике и сэмплера должна помещаться в CPU ВМ, иначе отказ до запуска стенда, как у серий. У rollout пик — три реплики.

  • Методика профилей не меняется: нагрузка, фазы, окна, лимиты, пороги, k6 без лимита. В профиле новое только поле-признак наблюдения.

  • Замеры. Новые полные метки evidence/failover/resources/ и evidence/rollout/resources/. Снимаются с закоммиченного кода на проверенном хосте. Результаты по доступности ставятся рядом с baseline, расхождения описываются честно.

  • Отчёт и документы.

    • REPORT.md: строка «CPU / RAM» сводной таблицы, разделы «Отказ каждой реплики под нагрузкой» и «Поочерёдная замена под нагрузкой». В них — измеренные числа с путями к файлам, сравнение доступности с baseline, накладные расходы сэмплера и ограничения.
    • AGENTS.md, .claude/rules/bench.md, комментарии целей Makefile.

Capabilities

New Capabilities

Нет.

Modified Capabilities

  • load-benchmark:
    • новое требование «Ресурсы профилей отказа и замены»:
      • сэмплер на время нагрузки и поиск контейнеров;
      • устойчивость к остановке, паузе и пересозданию;
      • окна, агрегаты, CPU на запрос только в установившихся окнах;
      • файлы и бюджет ВМ;
      • наблюдение не меняет методику профилей;
    • новое требование «Ресурсы профилей отказа и замены в отчёте»;
    • «Профиль отказа реплик» и «Профиль поочерёдной замены» — ресурсы по окнам фазы и замены, новые сценарии.

load-balancing не меняется. Его требования («Отказ реплики под нагрузкой», «Время обнаружения отказа», «Поочерёдная замена реплик») описывают поведение стенда, а не наблюдение. Новые метки обязаны выполнять их так же, как baseline.

Impact

  • Стенд bench/:

    • sampler.sh — режим scan;
    • новый resources.py;
    • run.py — поле профиля, запуск сэмплера в профилях, карта контейнеров, бюджет, окна, файлы;
    • failover.py, rollout.py — разделы сводки; у rollout начало подготовки — по событию exec_start в потоке событий проекта;
    • Makefile — комментарии целей bench_failover и bench_rollout.

    k6, override compose стенда, лимиты и пороги не меняются.

  • Приложение: код, контракт, Dockerfile, compose рабочего стенда не меняются. Регрессия make test / make student_test не нужна (design). Регрессия стенда — все быстрые профили, включая make bench_scaling_quick: у серий тот же сэмплер в явном режиме.

  • Evidence: метки evidence/failover/resources/, evidence/rollout/resources/ и evidence/tests/profile-resources-checks.md.

  • Документы: REPORT.md, AGENTS.md, .claude/rules/bench.md.

  • Время: ~6 мин bench_failover, ~3 мин bench_rollout, ~15 мин цепочка быстрых профилей. Перед каждым полным замером — проверка хоста.