Files
mtusi2026lab4-fork/experiments/docs/METHODOLOGY.md
T

57 lines
5.1 KiB
Markdown
Raw 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.
# Методика, версия 1
[README](../README.md) · [Гипотеза](HYPOTHESIS.md) · [Ограничения](LIMITATIONS.md) · [Запуск](RUNBOOK.md)
## Сравнение
- **Proxy:** binary POST в API до `201 ready`.
- **Direct:** SHA-256 на клиенте → init API → presigned POST в S3 → complete API до `201 ready`.
Повторов запросов нет. Обе ветки используют один образ API и полную проверку изображения. Direct включает COPY внутри S3 и чтение конечного объекта API.
## Стенд и данные
| Сервис | CPU | RAM |
| --- | --- | --- |
| API ×2 | по 0.5 | по 512 МиБ |
| PostgreSQL / MinIO | по 1 | по 512 МиБ |
| Redis | 0.25 | 128 МиБ |
| HAProxy | 0.5 | 128 МиБ |
Каждая API: один декодер, tmpfs 16 МиБ, GOMAXPROCS=1, GOMEMLIMIT=384MiB, пул БД=10. Swap отключён. Таймауты: операция API 25 с, HTTP 30 с, HAProxy/socket 35 с; бюджет flow 90 с проверяется между стадиями.
Четыре RGB8 PNG-профиля: **1 и 10 МиБ × 1024×1024 и 8000×5000 пикселей**. Размер доводится корректным ancillary chunk `npAD` перед IEND; в паре размеров одной геометрии пиксели одинаковые. Файлы и SHA-256 сохраняются.
## Порядок
Seed `20261018`, 3 парных повтора каждого профиля, порядок пар перемешан; 6 пар proxy→direct и 6 direct→proxy. Всего 24 прогона, 720 измеряемых загрузок.
Для каждого прогона:
1. Поднять отдельный Compose-проект со свежими volumes и закреплёнными image ID. Создать двух пользователей и чат.
2. Выполнить 4 параллельных загрузки прогрева, проверить метаданные; подождать 2 с.
3. Запустить sampler API/S3 с шагом 100 мс. Измерить фон за 5 с.
4. Снять начальные счётчики. Выполнить 3 волны по 10 клиентов со стартовым барьером и паузой 1 с между волнами.
5. Снять конечные счётчики и остановить sampler. Затем скачать оригиналы вторым участником и проверить длину, MIME и SHA-256.
6. Сохранить состояния и ошибки, остановить только этот проект. По умолчанию удалить его volumes.
Файл заранее находится в RAM клиента; direct checksum входит во время flow. Исходники не меняются, параллельная нагрузка запрещена. Ошибки запросов сохраняются, серия продолжается; отмена, изменение исходников или сбой окружения/уборки останавливают запуск.
## Метрики и сохранение
| Метрика | Источник / смысл |
| --- | --- |
| API RX+TX | Разность `/proc/net/dev` всех интерфейсов кроме lo, сумма двух API; служебный обмен включён |
| S3 RX+TX | Отдельный показатель, не складывается с API |
| RAM в окне | Максимум sampled `memory.current`, baseline и интервалы точек |
| Lifetime RAM | `memory.peak` до/после, включая startup и прогрев |
| CPU / throttling / OOM | `cpu.stat`, `memory.events`, состояния и рестарты контейнеров |
| Время / goodput | Monotonic clock; стадии, p50/p95/p99 успешных flow, ready/сек за окно |
| Генератор | CPU, RSS, фактический разброс старта клиентов |
`prepare` фиксирует протокол, план, исходники, fixtures и image ID в `seal.json`. Перед прогонами проверяются контрольные суммы. `summarize` создаёт `metrics.json`, `metrics.csv` и provenance; сравнивает парные R и их медиану отдельно по профилям.
В корневом `evidence/upload-comparison/<серия>/`: замороженная конфигурация и исходники, `cases/*` с запросами, RAM-точками, счётчиками, проверками файлов и ошибками. Секреты и подписанные формы не записываются. Временные credentials находятся вне evidence в `/tmp/highload-upload-exp-*`.
Источники измерителей: [сетевая статистика Linux](https://www.kernel.org/doc/html/latest/networking/statistics.html), [cgroup v2](https://www.kernel.org/doc/html/latest/admin-guide/cgroup-v2.html).