diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md index e6e63eb2..11e6ed1c 100644 --- a/.github/pull_request_template.md +++ b/.github/pull_request_template.md @@ -1,18 +1,19 @@ ## Лабораторная 3 -Автор / группа: TODO -Целевая оценка (3/4/5): TODO -Трек 5, если заявлен: TODO +Каменский Андрей Игоревич, БПИ2301. +Целевая оценка — 5, трек 1 «Цена масштабирования». -Что реализовано и что перенесено: TODO -Команды запуска из чистого clone: TODO -Результаты проверок и ссылка на REPORT.md: TODO -Ограничения / известные ошибки: TODO -Источники и использование ИИ: TODO +Добавил две масштабируемые API за HAProxy, общие сессии и идемпотентность сообщений в PostgreSQL. Настроил readiness, Docker DNS, таймауты, лимиты и поочерёдную замену. Миграции выполняет отдельный сервис; текущая схема 006 поддерживает U+0000 в Unicode-полях. -- [ ] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами. -- [ ] Контракт и публичные тесты не ослаблены. -- [ ] make check и make test выполнены; приложен реальный вывод. -- [ ] Сценарии отказов/безопасности своего уровня воспроизведены. -- [ ] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens. -- [ ] README задания сохранён, REPORT.md содержит инструкцию именно моего решения. +Запуск и результаты — [REPORT.md](../REPORT.md), полная методика и исходные измерения — [RESEARCH.md](../RESEARCH.md), дополнительные сценарии — [CHECKS.md](../CHECKS.md). + +В новом репозитории прошли сборка, миграции с нуля, check/validate/lint, smoke, конкурентные и краевые проверки, persistence и failover. Основные измерения отказов/нагрузки получены до переноса; происхождение и ограничения указаны в отчётах. + +- [x] Обязательный контракт и публичные тесты сохранены. +- [x] Подтверждённые сообщения и сессии переживают restart. +- [x] Проверены отказы каждой API и поочерёдное обновление под нагрузкой. +- [x] Приведены фиксированная и растущая серии 1/2/4, исходные данные, графики и измеренное улучшение. +- [x] Переходные ошибки и ограничения исследования описаны. +- [x] .env и приватные данные исключены из Git. + +Ограничения: единые PostgreSQL/Redis/LB/host, локальный HTTP, нет автоматического cleanup старых ключей. Миграции 005/006 требуют окна обслуживания. Полная матрица выполнена до финального аудита; контроль версии 006 сохранён отдельно. diff --git a/CHECKS.md b/CHECKS.md new file mode 100644 index 00000000..1a5caf1d --- /dev/null +++ b/CHECKS.md @@ -0,0 +1,35 @@ +# Дополнительные проверки + +Каменский Андрей Игоревич, БПИ2301. Основные результаты получены до переноса из mtusi2026lab1. В новом форке повторил smoke, конкурентную идемпотентность, краевые случаи, persistence и failover на 8081; журналы имеют префикс lab3-transfer. + +| Сценарий | Результат | Evidence | +| --- | --- | --- | +| Исчезновение каждой из пяти обязательных таблиц | Обе ready=503; профиль и регистрация через LB=503 | [readiness](evidence/lab3-audit-readiness.json) | +| Заморозка PostgreSQL / Redis | Первый ready=503 за 2.007 / 0.308 с; затем LB исключает все API; восстановление с прежней сессией | [pause](evidence/lab3-audit-frozen-stores.json) | +| Обе API получают новые IP | Старые адреса заняты временными контейнерами; LB без restart видит обе новые реплики, запись/чтение работают | [DNS](evidence/lab3-audit-changing-ips.json) | +| 16 одинаковых отправок | Один ID, одна строка messages и одна message_requests | [contract](evidence/lab3-audit-contract.json) | +| 16 отправок двух разных текстов с одним ключом | Восемь 201, восемь 409, одно сообщение в БД | [edge](evidence/lab3-transfer-edge-checks.txt) | +| Ошибка после INSERT сообщения до сохранения результата ключа | Временный trigger вызывает 503; обе строки откатываются; повтор после удаления trigger создаёт одно сообщение | тот же файл | +| Пустые/длинные ключи, другая область пользователя/чата | Неверные ключи=400, другой текст=409; независимые области не конфликтуют | [tests](evidence/lab3-transfer-tests.txt) | +| limit=abc/1.0, cursor=[]/null, дубли параметров | 400; чужой курсор=400, неизвестный участник=400 | [edge](evidence/lab3-transfer-edge-checks.txt) | +| Unicode, U+0000, длины 100/4000 code points | Значения сохраняются и возвращаются без потерь; превышение и неверные типы=400 | тот же файл | +| UTF-8 пароль с двоеточием и U+0000 | Вход успешен; непустое тело входа=400 | тот же файл | +| Повреждённый Unicode/дата в кэше | Профиль восстанавливается из БД с TTL | тот же файл | +| 413 и 500 | Обязательные заголовки на месте; request_id согласован; внутренние детали скрыты | [413](evidence/lab3-audit-contract.json), [500](evidence/lab3-500-headers.txt) | +| Прогретая история с limit=7 | После подтверждения новое сообщение видно при разных limit; кэша истории нет | [contract](evidence/lab3-audit-contract.json) | +| Одно TCP-соединение | Запросы пользователя обслуживают обе API | [edge](evidence/lab3-transfer-edge-checks.txt) | + +## Повторение + +```sh +.venv/bin/python scripts/audit-lab3.py +.venv/bin/python scripts/edge-audit-lab3.py +.venv/bin/python scripts/verify-lab3.py +.venv/bin/python scripts/final-checks-lab3.py +``` + +Только учебный стенд, последовательно. Временные таблицы, pause, trigger и IP-контейнеры восстанавливаются/удаляются в finally. Данные основного стенда не сбрасываются. + +Наличие U+0000 потребовало хранения Unicode-полей как UTF-8 bytea. Количество и контрольные суммы существующих значений до/после миграций совпали: [сообщения](evidence/lab3-unicode-migration.json), [имена и названия](evidence/lab3-unicode-names-migration.json). + +Набор дополнительных сценариев не является исчерпывающим доказательством отсутствия любых ошибок. Временные ошибки при отказах и обновлении учтены отдельно. diff --git a/IMPLEMENTATION.md b/IMPLEMENTATION.md new file mode 100644 index 00000000..6e0f59f2 --- /dev/null +++ b/IMPLEMENTATION.md @@ -0,0 +1,41 @@ +# Запуск реализации + +Каменский Андрей Игоревич, БПИ2301. Полный отчёт — [REPORT.md](REPORT.md), исследование — [RESEARCH.md](RESEARCH.md), дополнительные проверки — [CHECKS.md](CHECKS.md). README.md содержит исходное задание. + +```sh +cp compose.env.example .env +# Задать случайный hex POSTGRES_PASSWORD. +docker compose up -d --build --wait +make check test test-lab3 +``` + +По умолчанию внешний порт 8080. Для совместной работы с предыдущим стендом указать APP_PORT=8081 в .env. Makefile определяет BASE_URL по конфигурации; его можно переопределить явно. В текущем локальном окружении выбран 8081: [Swagger](http://localhost:8081/docs). + +Две API используют общие PostgreSQL и Redis, наружу опубликован только HAProxy. Миграции запускает отдельный сервис. Секреты — в игнорируемом .env; исходный .env.example задания сохранён. + +```sh +make test-failover ACTION_SCRIPT=scripts/stop-one.sh +# Восстановить остановленную API: +docker compose up -d --no-deps --wait api +make test-persistence ACTION_SCRIPT=scripts/restart.sh +``` + +Дополнительные инструменты: + +```sh +python3 -m venv .venv +.venv/bin/python -m pip install -r requirements-dev.txt +make check validate lint PYTHON=.venv/bin/python +.venv/bin/python scripts/review-lab3.py +``` + +Инфраструктурные проверки выполнять последовательно на учебном стенде. Они останавливают контейнеры, временно изменяют схему или занимают освобождённые IP, затем восстанавливают окружение. Новые данные синтетические. + +```sh +docker compose build api +.venv/bin/python scripts/rolling-update.py +``` + +Новая реплика сначала проходит readiness и обнаружение LB; старая выводится в drain и останавливается. Миграции в rolling-скрипт не входят. При смене типов колонок в 005/006 требуется окно обслуживания; со старым образом новую схему смешивать нельзя. + +Остановка без удаления данных: `docker compose down`. Намеренное полное удаление учебных данных: `docker compose down --volumes`. diff --git a/REPORT.md b/REPORT.md index c2679005..8d7d7f86 100644 --- a/REPORT.md +++ b/REPORT.md @@ -1,37 +1,92 @@ # Отчёт — лабораторная 3 -- Автор, группа: TODO -- Целевая оценка; выбранный трек 5, если нужен: TODO -- Commit/PR: TODO после публикации -- Использованные источники, библиотеки и помощь ИИ: TODO +Каменский Андрей Игоревич, БПИ2301. Целевая оценка — **5**, трек 1 — «Цена масштабирования». Изменения пока локальные, PR не создан. -## Запуск из чистого clone +## Запуск -TODO: версии runtime/образов, prerequisites, команды создания локальных secrets/.env, build, миграций, запуска, ожидания готовности, тестов и остановки. Указать необходимые действия оператора. Не вставлять секреты. Отдельно указать безопасную остановку и команду намеренного удаления учебных данных. +Нужны Docker с Compose и Python 3.9+ для публичных проверок. Для проверки схемы, форматирования и графиков использую Python 3.11+ с requirements-dev.txt. Образы: Python 3.13.0, PostgreSQL 16.6, Redis 7.4.2, HAProxy 3.0.12; зависимости закреплены в requirements.txt. -## Архитектура и решения +```sh +cp compose.env.example .env +# В .env задать POSTGRES_PASSWORD — случайную hex-строку. +docker compose up -d --build --wait +make check +make test +make test-lab3 +make test-persistence ACTION_SCRIPT=scripts/restart.sh +``` -TODO: схема процессов/хранилищ, источник истины, транзакционные границы, ограничения. Что перенесено из lab2, что изменено в этой работе. Соответствие переменных из .env.example реальной конфигурации. +API и Swagger по умолчанию: [http://localhost:8080/docs](http://localhost:8080/docs). В текущем локальном .env выбран APP_PORT=8081, поскольку 8080 занят предыдущим стендом; адрес — [http://localhost:8081/docs](http://localhost:8081/docs). Makefile и инфраструктурные скрипты определяют внешний адрес по BASE_URL, затем APP_PORT и выбранному .env. Явное переопределение: `make test BASE_URL=http://localhost:8081`. -## Доказательства критериев +Миграции Alembic выполняет сервис migration до старта API; текущая ревизия — 006. Исходный .env.example сохранён как в задании, для реализации используется compose.env.example. DATABASE_URL_FILE/CACHE_URL_FILE из исходного шаблона не используются: Compose передаёт DATABASE_URL и REDIS_URL. Сессии хранятся в Redis; срок защиты ключа идемпотентности фиксирован — 24 часа. -| Критерий README | Команда/сценарий | Наблюдаемый результат | Файл доказательства | -| --- | --- | --- | --- | -| Публичный smoke | make test | TODO | TODO | -| Остальные пункты уровня 3 | TODO | TODO | TODO | -| Все пункты уровня 4, если заявлен | TODO | TODO | TODO | -| Выбранный трек 5, если заявлен | TODO | TODO | TODO | +Для дополнительных инструментов: -TODO: добавить отдельную строку для каждого заявленного критерия. PASS без команды и наблюдения не является доказательством. Проверка инфраструктурного hook требует подтверждения, какие реальные процессы/хранилища перезапущены. +```sh +python3 -m venv .venv +.venv/bin/python -m pip install -r requirements-dev.txt +make check validate lint PYTHON=.venv/bin/python +``` -## Эксперименты и отказы +Остановка с сохранением данных — `docker compose down`; намеренный сброс учебных данных — `docker compose down --volumes`. Обычные проверки volumes не удаляют. -TODO: гипотеза, hardware/лимиты, версии, объём данных, профиль нагрузки, concurrency/arrival rate, длительность/прогрев, повторы, успешные RPS, ошибки, p50/p95/p99, CPU/RAM. Сохранить raw summary без tokens и объяснить ограничения измерения. +## Что сделал -| Воздействие | Что ожидаем | Что наблюдали | Время восстановления / потеря данных | -| --- | --- | --- | --- | -| TODO | TODO | TODO | TODO | +Сохранил структуру прошлой лабы: роутеры → сервисы → репозитории, DTO на dataclass. Пользователи, чаты, участники, сообщения и результаты отправок находятся в PostgreSQL. Redis хранит общие сессии с абсолютным expiry/TTL и AOF appendfsync always; профили кэшируются отдельно на 60 секунд. История читается из PostgreSQL. -## Ограничения и следующие шаги +Добавил две реплики одного сервиса api за HAProxy. Внешний порт опубликован только у LB на 127.0.0.1. API, PostgreSQL и Redis доступны во внутренней сети; container_name и sticky sessions нет. Число API меняется командой `docker compose up -d --scale api=4 --wait`. X-Instance-Id — UUID процесса, постоянный до его перезапуска; присутствует в ответах API, включая ошибки. -TODO: какие отказы выдерживаются и какие нет; что не реализовано; где учебное упрощение; какое улучшение подтверждено, а какое пока гипотеза. +HAProxy распределяет запросы roundrobin, опрашивает /health/ready раз в секунду, исключает backend после двух неуспехов и возвращает после двух успехов. DNS Docker — 127.0.0.11:53, server-template содержит 16 слотов. Адреса обновляются при замене контейнеров. Readiness проверяет Redis и все колонки пяти обязательных таблиц PostgreSQL, включая message_requests. Проверка ограничена двумя секундами независимо от завершения отмены запроса драйвером; на процесс остаётся не более одной незавершённой пробы. + +Для сообщений обязателен Idempotency-Key: ASCII, 1–128 символов, область — пользователь, POST и путь чата. Таблица message_requests имеет первичный ключ (sender_id, chat_id, key). Регистрация ключа, INSERT сообщения и сохранение результата выполняются одной транзакцией; COMMIT завершается до 201. Конкурентные реплики синхронизируются ограничением PostgreSQL. Повтор возвращает прежнее сообщение и 201, другой текст с тем же ключом — 409. Неподтверждённый запрос можно повторить с прежним ключом; временная 5xx не закрепляется как результат. + +Миграции 005/006 сохраняют Unicode-поля в bytea как UTF-8. SQLAlchemy преобразует str ↔ bytes; внешний JSON прежний, допустимый U+0000 сохраняется. Ограничения длины и непустого текста проверяет API. При переходе со старой схемы требуется окно обслуживания: старый образ нельзя смешивать с новой схемой колонок. Поочерёдная замена проверена для совместимой версии и уже применённой схемы. + +Скрипт rolling-update.py добавляет временную реплику, ждёт readiness и её появления через LB, выводит старую в drain, ждёт завершения запросов и останавливает её. Uvicorn получает 10 секунд на завершение; Docker — 15. Миграции в rolling-скрипт не входят. Команда запуска — `python3 scripts/rolling-update.py`, executable bit этому .py не требуется. + +| Сервис | CPU | RAM | +| --- | ---: | ---: | +| Каждая API, по умолчанию две | 0.5 | 256 MiB | +| PostgreSQL | 1 | 512 MiB | +| Redis | 0.25 | 128 MiB | +| HAProxy | 0.5 | 128 MiB | +| migration | 0.5 | 256 MiB | + +Таймаут соединения HAProxy с API — 1 с, проверки — 1 с, server — 12 с; ожидание пула БД — 2 с, SQL statement — 2.5 с, asyncpg command — 3 с, Redis connect/read — по 0.3 с. Расчётный бюджет обнаружения отказа LB — до 4 с без задержек планирования; фактическое восстановление проверяется относительно 10 с из задания. + +## Проверки + +Основные проверки и измерения выполнены до переноса из mtusi2026lab1, поэтому это имя встречается в логах. В новом форке отдельно прошли сборка, миграции с пустых volumes, публичный smoke, параллельная идемпотентность, дополнительные краевые проверки, persistence и failover на порту 8081. Обязательный контракт и публичные тесты не менял. + +| Проверка | Результат | Evidence | +| --- | --- | --- | +| check / validate / lint в новом репозитории | Пройдены | [quality](evidence/lab3-transfer-quality.txt) | +| Публичный smoke и 16 параллельных повторов | ≥2 API, одно сообщение, корректная область ключа | [tests](evidence/lab3-transfer-tests.txt) | +| Полный restart API, PostgreSQL и Redis | Данные и прежний токен сохранены | [persistence](evidence/lab3-transfer-persistence.txt) | +| Отказ выбранной API в новом репозитории | Восстановление ≤10 с, подтверждённые сообщения сохранены | [failover](evidence/lab3-transfer-failover.txt) | +| Последовательный SIGKILL каждой API | Предыдущая восстановлена до следующего отказа; сообщения сверены | [failures](evidence/lab3-failures.json) | +| Поочерёдная замена под нагрузкой | Обе старые API завершились с code 0, результаты сверены | [rolling](evidence/lab3-rolling.txt), [load](evidence/lab3-rolling-load.json) | +| Новые IP обеих API | Старые IP заняты временными контейнерами; обе новые API обнаружены без рестарта LB | [DNS](evidence/lab3-audit-changing-ips.json) | +| Повреждение схемы и заморозка зависимостей | Readiness и маршрут через LB возвращают ограниченные 503 | [schema](evidence/lab3-audit-readiness.json), [pause](evidence/lab3-audit-frozen-stores.json) | +| Неоднозначные заголовки, Unicode, ошибка посреди транзакции, повреждённый кэш | Запросы отклоняются или данные восстанавливаются; лишних строк нет | [edge checks](evidence/lab3-transfer-edge-checks.txt) | +| CPU/RAM и закрытые API-порты | Проверены реальные ограничения Docker | [infrastructure](evidence/lab3-infrastructure.json) | + +В новом форке публичный failover дал 110 успешных записей и 3 неуспешных попытки; восстановление по метрике теста — **2.597 с**. Остановленную API затем восстановил, финальный smoke прошёл. + +В полной проверке до переноса последовательно отключил два реальных контейнера. Подтверждённых сообщений сверено 1158 и 1312; ошибок — 23 и 23. Rolling под нагрузкой: 6411 записей, 1598 чтений за 40.07 с, 39 переходных ошибок. Потерь подтверждённых сообщений и дублей не обнаружил. Первая успешная операция после отказа не означает полного прекращения переходных ошибок. + +## Исследование масштабирования + +Выбрал трек 1. Сравнил 1/2/4 API при одинаковых суммарных 2 CPU и 1 GiB на все API, затем отдельную серию с ростом ресурсов. Дополнительно проверил concurrency 8/32/64 и увеличение CPU PostgreSQL. Сохранил 18 исходных измерений, CSV и графики. + +При четырёх API PostgreSQL с лимитом 0.25 CPU выбирает квоту и подвергается throttling; рост числа клиентов увеличивает задержки. В исходной серии увеличение ресурса БД до 1 CPU повысило средние успешные RPS с 206.8 до 366.1. WAL и блокировки отдельно не измерял, поэтому не объявляю их доказанной причиной плато. + +Полная серия относится к версии до финального аудита, схеме 004. На версии 006 отдельно выполнил короткий контроль: 198.7 RPS при 0.25 CPU БД и 590.9 при 1 CPU; ошибок соответственно 0 и 10. Эти серии не смешивал; короткий контроль не заменяет полную матрицу финальной версии. Методика, исходные данные, графики и ограничения — [RESEARCH.md](RESEARCH.md). + +## Ограничения + +Стенд выдерживает отказ одного процесса API. PostgreSQL, Redis, HAProxy и Docker-host остаются едиными точками отказа; потеря их узла и volumes не покрыта. HTTP локальный, данные синтетические. Автоматической очистки истёкших ключей пока нет, но после 24 часов ключ можно использовать заново. Между страницами истории нет общего snapshot; запрос, авторизованный до logout, может завершиться. + +Исследование короткое и closed-loop: два повтора по 12 с, прогрев 3 с, заметный разброс и накладные расходы клиента/Docker Desktop. RPS — скорость HTTP-подтверждений, не точное число COMMIT. Ошибки учитываются отдельно; отсутствие единственной ошибки при любом обновлении не заявляется. + +Источники: задание, contracts/README.md, OpenAPI и документация [HAProxy](https://www.haproxy.com/documentation/haproxy-configuration-tutorials/), [Docker Compose](https://docs.docker.com/reference/compose-file/services/), [SQLAlchemy](https://docs.sqlalchemy.org/en/20/), [PostgreSQL](https://www.postgresql.org/docs/16/), [Uvicorn](https://uvicorn.dev/server-behavior/), Alembic и Redis. diff --git a/RESEARCH.md b/RESEARCH.md new file mode 100644 index 00000000..6c2d8bf9 --- /dev/null +++ b/RESEARCH.md @@ -0,0 +1,76 @@ +# Исследование — цена масштабирования + +Каменский Андрей Игоревич, БПИ2301. Лабораторная 3, трек 1 на 5. + +## Гипотеза и методика + +Проверяю, перестаёт ли увеличение числа API помогать при ограниченном общем PostgreSQL и даёт ли увеличение ресурса БД подтверждённый эффект. + +Среда исходной серии: macOS 15.6.1 ARM64, Docker 28.5.1, VM aarch64 с 10 CPU и 8 218 034 176 байт RAM. Полный профиль — [method.json](evidence/lab3-research/method.json). + +| Реплики | Фиксированный бюджет API | Растущий бюджет API | +| ---: | --- | --- | +| 1 | 2 CPU / 1024 MiB | 1 CPU / 256 MiB | +| 2 | По 1 CPU / 512 MiB | По 1 CPU / 256 MiB | +| 4 | По 0.5 CPU / 256 MiB | По 1 CPU / 256 MiB | + +В фиксированной серии суммарно всегда 2 CPU и 1024 MiB на API. В растущей увеличиваются и число процессов, и ресурсы. В основных сериях PostgreSQL имеет 0.25 CPU/512 MiB; Redis 0.25 CPU/128 MiB, LB 0.5 CPU/128 MiB. В проверке улучшения меняю только CPU БД на 1. + +Профиль: 32 клиента, 80% POST с уникальным ключом и 20% GET первых 20 сообщений. Новый пользователь и чат на прогон, 20 seed-сообщений; прогрев 3 с, измерение 12 с, два повтора. Основные серии перемешаны с seed 20261106. Дополнительно — четыре API при 8 и 64 клиентах. Генератор closed-loop, отдельное постоянное HTTP-соединение на поток, автоматических retry нет. Bootstrap не входит в измерение. + +Полная серия выполнена в рабочем проекте mtusi2026lab1 до финального аудита (схема 004), затем перенесена без изменения измерений. Контроль схемы 006 хранится отдельно. Полную матрицу после аудита не повторял. + +## Результаты + +Средние двух прогонов; ошибки — сумма. p95 — среднее p95 отдельных прогонов, а не объединённый квантиль. + +| Серия | API | Успешные RPS | p95 всех попыток, мс | Ошибки | +| --- | ---: | ---: | ---: | ---: | +| Фиксированный бюджет | 1 | 331.5 | 194.0 | 60 | +| Фиксированный бюджет | 2 | 412.8 | 186.0 | 68 | +| Фиксированный бюджет | 4 | 281.9 | 322.6 | 3 | +| Растущий бюджет | 1 | 276.6 | 236.9 | 65 | +| Растущий бюджет | 2 | 420.0 | 187.3 | 26 | +| Растущий бюджет | 4 | 206.8 | 338.4 | 0 | + +![Масштабирование](evidence/lab3-research/scaling.png) + +При постоянном бюджете четыре API не улучшили результат двух. В растущей серии переход с двух на четыре тоже ухудшил скорость. Два повтора имеют заметный разброс; небольшие различия между конфигурациями не считаю доказанными. + +## Насыщение и улучшение + +| Четыре API, БД 0.25 CPU | RPS | p95 всех попыток, мс | Ошибки | +| --- | ---: | ---: | ---: | +| 8 клиентов | 159.8 | 113.2 | 2 | +| 32 клиентов | 206.8 | 338.4 | 0 | +| 64 клиентов | 185.0 | 809.0 | 13 | + +На проверенной сетке насыщение наблюдается около 32 клиентов: переход к 64 не увеличил RPS, а p95 вырос с 338 до 809 мс. При четырёх API БД выбирает выделенные 0.25 CPU; throttling срабатывает примерно в 94% активных периодов учёта. Это не доля всего времени простоя, но свидетельство давления CPU-квоты. LB и Redis не выбирают свои CPU-бюджеты. + +При том же профиле и четырёх API увеличил CPU PostgreSQL с 0.25 до 1. Средние RPS выросли с 206.8 до 366.1, на 77%; в четырёх сравниваемых прогонах ошибок нет. Это реализованное изменение с измерением до/после. В обычном Compose БД уже имеет 1 CPU. + +![Насыщение и улучшение](evidence/lab3-research/bottleneck.png) + +Суммарный предел пула БД растёт вместе с количеством API: до 10/20/40 соединений. Конкуренция операций при недостатке CPU — возможное объяснение дополнительного замедления. Вклад отдельных ожиданий, WAL и блокировок не изолировал и не выдаю за установленную причину. + +## Контроль после исправлений + +На схеме 006, четыре API, 32 клиента, прогрев 3 с, один прогон по 8 с: БД 0.25 CPU — 198.7 RPS, 0 ошибок; БД 1 CPU — 590.9 RPS, 10 ошибок. Это контроль направления эффекта, а не новая статистически устойчивая оценка ускорения. Исходные данные, CPU/RAM и хеши исходников — [lab3-control](evidence/lab3-control/results.json). + +## Данные и повторение + +Полная серия: [results.json](evidence/lab3-research/results.json), [summary.csv](evidence/lab3-research/summary.csv), отдельные run-01.json … run-18.json, [журнал](evidence/lab3-original-research-run.txt). Контроль — [lab3-control/results.json](evidence/lab3-control/results.json). + +```sh +# Полная матрица для текущей версии: +.venv/bin/python scripts/research-lab3.py --full +.venv/bin/python scripts/plot-lab3.py +# Короткий контроль: +.venv/bin/python scripts/research-lab3.py +``` + +Сценарии временно меняют число API и лимиты; в finally возвращают обычную конфигурацию. Volumes не удаляются. + +## Ограничения + +Короткие closed-loop прогоны имеют coordinated omission, накладные расходы клиента и Docker Desktop. Два повтора недостаточны для точной оценки capacity или production SLA; SD на графике не является доверительным интервалом. Общая БД растёт между прогонами, кэш и планировщик влияют на результаты. RPS считает HTTP-подтверждения: timeout мог скрыть COMMIT. Полная исходная серия и финальный короткий контроль относятся к разным версиям и не объединяются. diff --git a/evidence/lab3-transfer-proof.json b/evidence/lab3-transfer-proof.json new file mode 100644 index 00000000..388132ad --- /dev/null +++ b/evidence/lab3-transfer-proof.json @@ -0,0 +1,8 @@ +{ + "runtime_source_identical_to_tested_source": true, + "original_assignment_and_public_contract_preserved": true, + "author": "Каменский Андрей Игоревич", + "group": "БПИ2301", + "runtime_port": 8081, + "reports_complete": true +}