docs: record upload-memory benchmark hypotheses before runs

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-10-22 00:23:37 +03:00
co-authored by Claude Opus 5.5
parent 6cab9d3c41
commit 511e28590b
+36
View File
@@ -561,6 +561,42 @@ TODO: гипотеза, hardware/лимиты, версии, объём данн
| S3 и PostgreSQL остановлены, пока уборщику есть что убирать | строка остаётся, уборщик не падает и доводит уборку после возврата | после G + 3I при остановленном S3 строка на месте; после `start` S3 — убрана за ≤ I + 5 с, без перезапуска уборщика; готовое вложение цело | ≤ 6 с после возврата S3 |
| `docker compose stop cleaner` во время работы и на старте | выход до SIGKILL, код 0 | 0,57 с, код 0, «Stopped cleaner»; через 0,05–1 с после `up` — «Stopped cleaner before startup», 0,2 с; сразу после `up` (окно запуска интерпретатора) — SIGKILL через 10 с (137) | — |
### Одновременные загрузки: гипотезы (change `upload-memory`)
Гипотезы записаны до первого прогона метки профиля `uploads` и
зафиксированы отдельным commit раньше commit с результатами (спек
`load-benchmark`, «Загрузки в отчёте»). Числа в них — из проб design
change `upload-memory` (Context, «Пробы»), а не из метки. Расхождение с
результатом метки гипотезу не меняет: вывод пишется ниже, после прогона.
Методика (design, решение 10): `make bench_uploads` на стенде
`mtusi-bench` — LB, одна реплика API 1 CPU / 512 МБ без swap
(`memswap_limit` = память), PostgreSQL, Valkey и S3 с лимитами рабочего
стенда. Варианты: «до» — образ `f894040` (код до change), «без лимита» —
текущий код с `UPLOADS__MAX_CONCURRENT=1000`, `UPLOADS__MAX_WAITING=0`, «с
лимитом» — значения по умолчанию (4 места, 16 в очереди). Тела — PNG из
шума около 1 MiB и около 10 MiB; C ∈ {1, 10, 20, 40} одновременных
клиентов без пауз (на 429 — пауза `Retry-After`); 3 повтора; на каждый
прогон — новые реплика и volume S3; пик — `memory.peak` cgroup реплики,
сброшенный в начале окна.
- **H1 — «с лимитом»:** пик памяти реплики при 10 MiB и C = 10, 20, 40 не
больше половины лимита контейнера (256 MiB). Сверх пика при C = 10 — не
больше 1 MiB на каждого клиента. OOM нет, ответов 5xx нет, лишние
загрузки получают 429.
- **H2 — «без лимита» и «до»:** у «без лимита» пик растёт примерно на
1,2–1,3 тела на клиента, и при 40 × 10 MiB реплика завершена ядром из-за
памяти (OOM-kill). У «до» пик растёт на ~2,1 тела на клиента (вторая
копия тела при PUT), и реплика убита уже при 20 × 10 MiB.
- **H3 — пропускная способность:** загрузок 201 в секунду при C ≥ 10 у «с
лимитом» не меньше 90 % от «без лимита» на тех же C, пока «без лимита»
жив: предел задаёт S3 (7–8,5 загрузки по 10 MiB в секунду на реплику), а
не места. p95 у «с лимитом» растёт на время ожидания в очереди.
- **H4 — срок записи в S3:** 503 из-за срока PUT (5 с) нет ни в одном
варианте, пока реплика жива: в S3 не больше 4 PUT от одной реплики
(формулировка design, решение 10; p95 PUT при 12 одновременных на пробе
— 1,6–1,9 с).
## Ограничения и следующие шаги
TODO: какие отказы выдерживаются и какие нет; что не реализовано; где учебное упрощение; какое улучшение подтверждено, а какое пока гипотеза.