From a7f3ab11a7bd21aab7a1fb57a2ce6ec6c43a8891 Mon Sep 17 00:00:00 2001 From: AndrewNikkk Date: Fri, 23 Oct 2026 16:38:27 +0300 Subject: [PATCH] lab3 --- .env.example | 8 + CMakeLists.txt | 33 + Dockerfile | 49 + REPORT.md | 140 +- compose.yaml | 99 ++ evidence/api_scaling.png | Bin 0 -> 70563 bytes evidence/db_scaling.png | Bin 0 -> 79483 bytes evidence/load-rolling.json | 17 + evidence/track1-A-r1-apicpu1.0-dbcpu2.0.json | 54 + .../track1-A-r1-apicpu1.0-dbcpu2.0.load.json | 17 + evidence/track1-A-r2-apicpu0.5-dbcpu2.0.json | 55 + .../track1-A-r2-apicpu0.5-dbcpu2.0.load.json | 17 + evidence/track1-A-r4-apicpu0.25-dbcpu2.0.json | 57 + .../track1-A-r4-apicpu0.25-dbcpu2.0.load.json | 17 + evidence/track1-B-r4-apicpu0.25-dbcpu1.0.json | 57 + .../track1-B-r4-apicpu0.25-dbcpu1.0.load.json | 17 + evidence/track1-B-r4-apicpu0.25-dbcpu2.0.json | 57 + .../track1-B-r4-apicpu0.25-dbcpu2.0.load.json | 17 + evidence/track1-B-r4-apicpu0.25-dbcpu4.0.json | 57 + .../track1-B-r4-apicpu0.25-dbcpu4.0.load.json | 17 + evidence/track1-C-r4-apicpu0.25-dbcpu4.0.json | 57 + .../track1-C-r4-apicpu0.25-dbcpu4.0.load.json | 17 + evidence/track1-L-r4-apicpu0.25-dbcpu4.0.json | 57 + .../track1-L-r4-apicpu0.25-dbcpu4.0.load.json | 17 + evidence/track1-M-r4-apicpu0.25-dbcpu4.0.json | 57 + .../track1-M-r4-apicpu0.25-dbcpu4.0.load.json | 17 + evidence/track1-P-r4-apicpu0.25-dbcpu4.0.json | 57 + .../track1-P-r4-apicpu0.25-dbcpu4.0.load.json | 17 + evidence/track1-R-r4-apicpu0.25-dbcpu4.0.json | 57 + .../track1-R-r4-apicpu0.25-dbcpu4.0.load.json | 17 + evidence/track1-W-r4-apicpu0.25-dbcpu4.0.json | 57 + .../track1-W-r4-apicpu0.25-dbcpu4.0.load.json | 17 + lb/nginx.conf | 39 + migrations/001_init.sql | 33 + migrations/002_sessions.sql | 6 + migrations/003_idempotency.sql | 11 + requirements-dev.txt | 1 + scripts/plot_graphs.py | 100 ++ scripts/restart.sh | 38 + scripts/run_track1.py | 234 +++ scripts/run_track1.sh | 53 + scripts/run_track1_improvement.sh | 15 + scripts/run_track1_scaling.sh | 29 + scripts/stop-one.sh | 24 + src/auth.cpp | 39 + src/auth.hpp | 7 + src/chat_repo.cpp | 186 +++ src/chat_repo.hpp | 23 + src/cursor.hpp | 47 + src/db.cpp | 360 +++++ src/db.hpp | 62 + src/errors.hpp | 11 + src/main.cpp | 1379 +++++++++++++++++ src/message_repo.cpp | 297 ++++ src/message_repo.hpp | 37 + src/models.hpp | 38 + src/pg_session_repo.cpp | 66 + src/pg_session_repo.hpp | 18 + src/redis_pool.cpp | 216 +++ src/redis_pool.hpp | 59 + src/session_repo.cpp | 87 ++ src/session_repo.hpp | 18 + src/session_repo_base.hpp | 22 + src/user_repo.cpp | 100 ++ src/user_repo.hpp | 22 + student-tests/idempotency_parallel.py | 114 ++ 66 files changed, 5004 insertions(+), 16 deletions(-) create mode 100644 CMakeLists.txt create mode 100644 Dockerfile create mode 100644 compose.yaml create mode 100644 evidence/api_scaling.png create mode 100644 evidence/db_scaling.png create mode 100644 evidence/load-rolling.json create mode 100644 evidence/track1-A-r1-apicpu1.0-dbcpu2.0.json create mode 100644 evidence/track1-A-r1-apicpu1.0-dbcpu2.0.load.json create mode 100644 evidence/track1-A-r2-apicpu0.5-dbcpu2.0.json create mode 100644 evidence/track1-A-r2-apicpu0.5-dbcpu2.0.load.json create mode 100644 evidence/track1-A-r4-apicpu0.25-dbcpu2.0.json create mode 100644 evidence/track1-A-r4-apicpu0.25-dbcpu2.0.load.json create mode 100644 evidence/track1-B-r4-apicpu0.25-dbcpu1.0.json create mode 100644 evidence/track1-B-r4-apicpu0.25-dbcpu1.0.load.json create mode 100644 evidence/track1-B-r4-apicpu0.25-dbcpu2.0.json create mode 100644 evidence/track1-B-r4-apicpu0.25-dbcpu2.0.load.json create mode 100644 evidence/track1-B-r4-apicpu0.25-dbcpu4.0.json create mode 100644 evidence/track1-B-r4-apicpu0.25-dbcpu4.0.load.json create mode 100644 evidence/track1-C-r4-apicpu0.25-dbcpu4.0.json create mode 100644 evidence/track1-C-r4-apicpu0.25-dbcpu4.0.load.json create mode 100644 evidence/track1-L-r4-apicpu0.25-dbcpu4.0.json create mode 100644 evidence/track1-L-r4-apicpu0.25-dbcpu4.0.load.json create mode 100644 evidence/track1-M-r4-apicpu0.25-dbcpu4.0.json create mode 100644 evidence/track1-M-r4-apicpu0.25-dbcpu4.0.load.json create mode 100644 evidence/track1-P-r4-apicpu0.25-dbcpu4.0.json create mode 100644 evidence/track1-P-r4-apicpu0.25-dbcpu4.0.load.json create mode 100644 evidence/track1-R-r4-apicpu0.25-dbcpu4.0.json create mode 100644 evidence/track1-R-r4-apicpu0.25-dbcpu4.0.load.json create mode 100644 evidence/track1-W-r4-apicpu0.25-dbcpu4.0.json create mode 100644 evidence/track1-W-r4-apicpu0.25-dbcpu4.0.load.json create mode 100644 lb/nginx.conf create mode 100644 migrations/001_init.sql create mode 100644 migrations/002_sessions.sql create mode 100644 migrations/003_idempotency.sql create mode 100644 scripts/plot_graphs.py create mode 100755 scripts/restart.sh create mode 100755 scripts/run_track1.py create mode 100755 scripts/run_track1.sh create mode 100755 scripts/run_track1_improvement.sh create mode 100755 scripts/run_track1_scaling.sh create mode 100755 scripts/stop-one.sh create mode 100644 src/auth.cpp create mode 100644 src/auth.hpp create mode 100644 src/chat_repo.cpp create mode 100644 src/chat_repo.hpp create mode 100644 src/cursor.hpp create mode 100644 src/db.cpp create mode 100644 src/db.hpp create mode 100644 src/errors.hpp create mode 100644 src/main.cpp create mode 100644 src/message_repo.cpp create mode 100644 src/message_repo.hpp create mode 100644 src/models.hpp create mode 100644 src/pg_session_repo.cpp create mode 100644 src/pg_session_repo.hpp create mode 100644 src/redis_pool.cpp create mode 100644 src/redis_pool.hpp create mode 100644 src/session_repo.cpp create mode 100644 src/session_repo.hpp create mode 100644 src/session_repo_base.hpp create mode 100644 src/user_repo.cpp create mode 100644 src/user_repo.hpp create mode 100644 student-tests/idempotency_parallel.py diff --git a/.env.example b/.env.example index d32b9be..5a6b7a9 100644 --- a/.env.example +++ b/.env.example @@ -10,4 +10,12 @@ DATABASE_URL_FILE=/run/secrets/database_url SESSION_STORE=postgres CACHE_URL_FILE=/run/secrets/cache_url API_REPLICAS=2 +# Per-replica CPU limit. Series A keeps replicas * API_CPU_LIMIT = 1.0. +API_CPU_LIMIT=0.50 +# PostgreSQL cgroup CPU limit. +DB_CPU_LIMIT=1.0 +# Nginx cgroup CPU limit. 0.25 saturated in the track-1 plateau runs. +LB_CPU_LIMIT=0.25 IDEMPOTENCY_TTL_SECONDS=86400 +# Seconds /health/ready stays 503 after SIGTERM before the listen socket closes. +DRAIN_SECONDS=2 diff --git a/CMakeLists.txt b/CMakeLists.txt new file mode 100644 index 0000000..9b38064 --- /dev/null +++ b/CMakeLists.txt @@ -0,0 +1,33 @@ +cmake_minimum_required(VERSION 3.16) +project(mtusi_messenger CXX) + +set(CMAKE_CXX_STANDARD 17) +set(CMAKE_CXX_STANDARD_REQUIRED ON) + +find_package(Threads REQUIRED) +find_package(PkgConfig REQUIRED) + +pkg_check_modules(PQXX REQUIRED IMPORTED_TARGET libpqxx>=7.9) +pkg_check_modules(HIREDIS REQUIRED IMPORTED_TARGET hiredis) +pkg_check_modules(SODIUM REQUIRED IMPORTED_TARGET libsodium) + +add_executable(messenger + src/main.cpp + src/db.cpp + src/auth.cpp + src/user_repo.cpp + src/chat_repo.cpp + src/message_repo.cpp + src/redis_pool.cpp + src/session_repo.cpp + src/pg_session_repo.cpp +) + +target_include_directories(messenger PRIVATE src) + +target_link_libraries(messenger PRIVATE + Threads::Threads + PkgConfig::PQXX + PkgConfig::HIREDIS + PkgConfig::SODIUM +) \ No newline at end of file diff --git a/Dockerfile b/Dockerfile new file mode 100644 index 0000000..4683e4f --- /dev/null +++ b/Dockerfile @@ -0,0 +1,49 @@ +FROM ubuntu:25.10 AS builder + +RUN apt-get update && apt-get install -y --no-install-recommends \ + build-essential \ + cmake \ + pkg-config \ + libpqxx-dev \ + libpq-dev \ + libhiredis-dev \ + libsodium-dev \ + nlohmann-json3-dev \ + && rm -rf /var/lib/apt/lists/* + +WORKDIR /src +COPY CMakeLists.txt ./ +COPY src ./src +COPY migrations ./migrations + +RUN cmake -S . -B build -DCMAKE_BUILD_TYPE=Release \ + && cmake --build build -j + +FROM ubuntu:25.10 + +RUN apt-get update && apt-get install -y --no-install-recommends \ + ca-certificates \ + curl \ + libpqxx-7.10 \ + libhiredis1.1.0 \ + libsodium23 \ + && rm -rf /var/lib/apt/lists/* \ + && useradd --system --no-create-home --uid 10001 app + +WORKDIR /app +COPY --from=builder /src/build/messenger /app/messenger +COPY --from=builder /src/migrations /app/migrations + +RUN chown -R app:app /app + +USER 10001 + +ENV APP_HOST=0.0.0.0 +ENV APP_PORT=8080 + +EXPOSE 8080 + +HEALTHCHECK --interval=5s --timeout=3s --start-period=20s --retries=3 \ + CMD curl -fsS http://127.0.0.1:8080/health/live || exit 1 + +CMD ["/app/messenger"] \ No newline at end of file diff --git a/REPORT.md b/REPORT.md index c267900..c742fc1 100644 --- a/REPORT.md +++ b/REPORT.md @@ -1,37 +1,145 @@ # Отчёт — лабораторная 3 -- Автор, группа: TODO -- Целевая оценка; выбранный трек 5, если нужен: TODO -- Commit/PR: TODO после публикации -- Использованные источники, библиотеки и помощь ИИ: TODO +- Автор, группа: Никитин Андрей Александрович БВТ2301 +- Целевая оценка: 5. Трек 1 (цена масштабирования) +- Commit/PR: не публиковался +- Источники и помощь: контракт и публичные тесты курса; PostgreSQL 16, Valkey, Nginx, libpqxx, libsodium, hiredis, nlohmann/json. Помощь ИИ: DeepSeek, Cursor, GigaCode. ## Запуск из чистого clone -TODO: версии runtime/образов, prerequisites, команды создания локальных secrets/.env, build, миграций, запуска, ожидания готовности, тестов и остановки. Указать необходимые действия оператора. Не вставлять секреты. Отдельно указать безопасную остановку и команду намеренного удаления учебных данных. +Хост этого прогона: 12th Gen Intel Core i5-12450H, 12 потоков, 14 GiB RAM. Образы: `postgres:16.15-alpine`, `valkey/valkey:8.1.10-alpine`, `nginx:1.28.0-alpine`, приложение собирается из `ubuntu:25.10` (g++ 15.2, libpqxx 7.10, libsodium 1.0.18, hiredis 1.2.0). + +Лимиты: db 1 CPU / 512 MiB, cache 0.5 CPU / 256 MiB, каждая реплика api 0.5 CPU / 256 MiB, lb 0.25 CPU / 128 MiB. Проверено через `docker inspect` (`NanoCpus` / `Memory`). + +```sh +cp .env.example .env +# В .env задать POSTGRES_USER, POSTGRES_PASSWORD, POSTGRES_DB, SESSION_STORE=redis +mkdir -p secrets +printf 'postgresql://USER:PASSWORD@db:5432/DB\n' > secrets/database_url +printf 'redis://cache:6379/0\n' > secrets/cache_url +docker compose --env-file .env config --quiet +docker compose --env-file .env up -d --build +# Дождаться healthy у lb, затем: +make test +make test-persistence ACTION_SCRIPT=scripts/restart.sh +make test-failover ACTION_SCRIPT=scripts/stop-one.sh +docker compose --env-file .env stop +``` + +Хосты в секретах — имена сервисов Compose (`db`, `cache`), не loopback: внутри контейнера loopback не является базой. Секреты и `.env` не коммитятся. Остановка без удаления данных: `docker compose --env-file .env stop`. Удаление учебных volumes — только явно: `docker compose --env-file .env down -v`. + +Миграции применяет процесс API при старте, под сессионным `pg_advisory_lock`. Отдельный шаг миграции не нужен. ## Архитектура и решения -TODO: схема процессов/хранилищ, источник истины, транзакционные границы, ограничения. Что перенесено из lab2, что изменено в этой работе. Соответствие переменных из .env.example реальной конфигурации. +Клиент ходит только на `lb:8080`. Две реплики `api` порты наружу не публикуют. Общая PostgreSQL хранит пользователей, чаты, сообщения и `idempotency_keys`. Сессии — Valkey (`SESSION_STORE=redis`, AOF `everysec`, volume `valkeydata`). Sticky session нет. + +`X-Instance-Id` — `INSTANCE_ID`, иначе `HOSTNAME` контейнера, иначе 8 hex. В Compose `HOSTNAME` совпадает с `Config.Hostname` (короткий id контейнера). Nginx этот заголовок и `X-Request-Id` не подменяет. + +Идемпотентность `POST /api/v1/chats/{id}/messages`: в одной транзакции `INSERT messages` и `INSERT idempotency_keys ... ON CONFLICT (user_id, chat_id, key) DO NOTHING RETURNING`. Проигравшая транзакция откатывает своё сообщение и читает уже зафиксированную строку. Тот же семантический текст — тот же `message_id` и 201. Другой текст — 409. Другой чат того же пользователя — независимый ключ. Хеш — SHA-256 текста; в контракте lab3 у тела одно поле `text`, отсутствующий `attachment_ids` в хеше считается пустым. TTL — `IDEMPOTENCY_TTL_SECONDS` (86400). 5xx до COMMIT не записывается. + +`/health/live` — процесс жив. `/health/ready` — PostgreSQL и Valkey отвечают. По SIGTERM ready сразу 503, слушающий сокет закрывается через `DRAIN_SECONDS` (2). `stop_grace_period` API — 15 с. Docker healthcheck образа — `/health/live`, `--start-period=20s`. Healthcheck Compose у api — `/health/ready`, `start_period: 20s` (он подменяет HEALTHCHECK образа при запуске через Compose). + +Nginx 1.28: `resolver 127.0.0.11 valid=2s`, `server api:8080 resolve`, `max_fails=1 fail_timeout=5s`, `keepalive 32`, `proxy_next_upstream error timeout http_502 http_503 http_504`, `proxy_connect_timeout 2s`, `proxy_read_timeout 10s`. Активного health_check, как в Nginx Plus, в этом образе нет: недоступный backend уходит с маршрута после ошибки соединения или 502/503/504. Пока реплика дренируется и ещё отвечает 201, трафик на неё возможен; после закрытия сокета следующий запрос уходит на вторую реплику. + +Из lab2 сохранены регистрация, Basic → Bearer, Argon2id, чаты, keyset-пагинация, logout, пул PostgreSQL с `statement_timeout` и `is_alive()`. ## Доказательства критериев -| Критерий README | Команда/сценарий | Наблюдаемый результат | Файл доказательства | +| Критерий | Команда | Наблюдение | Файл | | --- | --- | --- | --- | -| Публичный smoke | make test | TODO | TODO | -| Остальные пункты уровня 3 | TODO | TODO | TODO | -| Все пункты уровня 4, если заявлен | TODO | TODO | TODO | -| Выбранный трек 5, если заявлен | TODO | TODO | TODO | +| Контракт и синтаксис | `make check` | PASS | вывод команды | +| OpenAPI 3.1 | `make validate PYTHON=.venv/bin/python` | PASS | вывод команды | +| Compose | `docker compose --env-file .env config --quiet` | код 0 | — | +| Две реплики и один вход | `docker compose --env-file .env ps` | api ×2 без публикации порта; наружу только `lb` `0.0.0.0:8080` | — | +| Разные реплики, одна сессия | 20× `GET /health/live` через :8080 | `X-Instance-Id`: `a54079f2595c` и `f9a279e85405` | — | +| Smoke | `make test` | PASS, lab3 | — | +| Идемпотентность, гонка, другой чат | `python3 student-tests/idempotency_parallel.py` | 8 ответов, 1 message id, 2 instance id, другой чат — другой id, другой body — 409 | — | +| Общий ключ переживает реплики | тот же скрипт, ответы с двух instance id | один id | — | +| Отказ одной реплики | `make test-failover ACTION_SCRIPT=scripts/stop-one.sh` | два прогона, оба остановили api-2: до отказа 2 instance; успехи 128 и 128; ошибок 0; первое успешное после возврата hook 3.381 с и 3.369 с | — | +| Вторая реплика тем же скриптом | `TARGET_INSTANCE_ID=a54079f2595c scripts/stop-one.sh` во время записей | hook 0 за окно 15 с; успехи 130; ошибок 0; first recovery 3.134 с; последние id только `f9a279e85405`; контейнер api-1 `Exited (0)` | — | +| Сохранность | `make test-persistence ACTION_SCRIPT=scripts/restart.sh` | PASS. После hook все пять контейнеров снова Up (healthy), volumes не удалялись | — | +| SIGTERM и ready | `docker kill --signal=TERM` одной реплики, `curl` из контейнера | сразу ready=503, live=200, сокет ещё принимает; через ~3 с процесс `Exited (0)`, в логе drain 2 с, затем `shutting down` | — | +| Миграции один раз | логи двух реплик при старте | у обеих `migration advisory lock acquired`; строка `applied migration 4` одна | — | +| Лимиты | `docker inspect` | api 5e8 / 268435456, db 1e9 / 536870912, cache 5e8 / 268435456, lb 2.5e8 / 134217728 | — | +| Поочерёдная замена под нагрузкой | `python3 tests/load.py --duration 36 --concurrency 4 --output evidence/load-rolling.json` и `docker stop`/`start` каждой реплики внутри окна | 36.028 с, concurrency 4, успехов 7398, ошибок 0, successful RPS 205.34, p50 11.798 мс, p95 55.641 мс, p99 87.623 мс. Это closed-loop без retry, латентность только успешных | `evidence/load-rolling.json` | -TODO: добавить отдельную строку для каждого заявленного критерия. PASS без команды и наблюдения не является доказательством. Проверка инфраструктурного hook требует подтверждения, какие реальные процессы/хранилища перезапущены. +Период проверки Compose: interval 5 с, timeout 3 с. У Nginx обнаружение мёртвого peer — первый отказ соединения (connect timeout до 2 с) и `fail_timeout` 5 с. Наблюдаемое время от старта `stop-one.sh` до следующей успешной записи после возврата скрипта — около 3.1–3.4 с; в эти окна ошибок записи не было. Скрипт сам занимает ~3 с, потому что ждёт `docker stop -t 8`, а процесс ещё 2 с отдаёт ready=503. ## Эксперименты и отказы -TODO: гипотеза, hardware/лимиты, версии, объём данных, профиль нагрузки, concurrency/arrival rate, длительность/прогрев, повторы, успешные RPS, ошибки, p50/p95/p99, CPU/RAM. Сохранить raw summary без tokens и объяснить ограничения измерения. +Нагрузка — публичный `tests/load.py`, один прогон, не серия. Цифры ниже сняты на этом хосте 2026-10-23 и не являются пределом машины. -| Воздействие | Что ожидаем | Что наблюдали | Время восстановления / потеря данных | +| Воздействие | Что ожидали | Что наблюдали | Восстановление | | --- | --- | --- | --- | -| TODO | TODO | TODO | TODO | +| `stop-one.sh` для api-2, публичный failover, два раза | ≥2 реплики до отказа, запись ≤10 с, остановленная реплика не в хвосте ответов, без дублей | 2 реплики; ошибок 0; 128 успешных записей в каждом прогоне | 3.381 с и 3.369 с от старта hook | +| Тот же скрипт для hostname api-1 | то же | ошибок 0; 130 успешных; хвост только вторая реплика | 3.134 с | +| Поочерёдный stop/start обеих реплик во время load.py 36 с | краткие ошибки допустимы | ошибок 0; RPS 205.34; p50/p95/p99 11.798/55.641/87.623 мс | отдельный таймер восстановления внутри этого прогона не выделялся | +| SIGTERM одной реплики | ready перестаёт быть 200 до закрытия сокета | ready 503 при ещё живом live и сокете; выход 0 | процесс завершился примерно за 3 с | +| `restart.sh` db, cache, api, lb | прежний токен и сообщения, volumes на месте | `make test-persistence` PASS, все сервисы снова healthy | hook уложился в лимит теста (90 с) | + +## Трек 1. Цена масштабирования + +Гипотеза. При суммарном CPU API = 1.0 дополнительные реплики не поднимают RPS: каждая реплика упирается в свой кусок квоты. Пока квота PostgreSQL заполнена, лишний CPU базы поднимает RPS; когда квота API и Nginx уже полные, дальнейший CPU базы даёт меньше. Пул соединений и число процессов Nginx сами по себе не добавляют пропускную способность, пока у реплики 8 потоков обработки и те же CPU-квоты. + +Методика. Публичный `tests/load.py`, closed-loop `POST /messages`, `--duration 30 --concurrency 50`. Перед каждым зачётным окном отброшенный прогрев 10 с с теми же 50 воркерами. Каждый запуск создаёт свой чат. Ошибок записи во всех зачётных окнах ниже не было. `docker stats` снимался примерно раз в 3 с только во время 30 с; в выводе Docker 100% — это одно ядро. Лимиты после `up` проверены по `HostConfig.NanoCpus`. + +Фиксировано во всех точках серий A и B: `shared_buffers=256MB`, `synchronous_commit=off`, `max_connections=200`, память db 512 MiB, cache 0.5 CPU, Nginx `worker_processes 1` и квота lb 0.25 CPU, пул PostgreSQL 8, 8 потоков HTTP на реплику. Хост: Intel Core i5-12450H, 12 потоков, 14 GiB RAM. Скрипт прогона: `scripts/run_track1.py`. Сырые JSON лежат в `evidence/track1-*.json`. + +### Серия A. Реплики API, суммарный CPU = 1.0, CPU базы = 2.0 + +| Реплики | CPU на реплику | Успешный RPS | p50, мс | p95, мс | p99, мс | Ошибки | +| --- | --- | --- | --- | --- | --- | --- | +| 1 | 1.0 | 349.994 | 121.454 | 202.572 | 1115.09 | 0 | +| 2 | 0.5 | 327.611 | 131.433 | 289.233 | 404.102 | 0 | +| 4 | 0.25 | 320.002 | 151.294 | 295.941 | 407.03 | 0 | + +От 1 к 2 репликам RPS −6.4%, от 1 к 4 — −8.6%. Медиана стала хуже: 121 → 131 → 151 мс. На одной реплике API держал около 90–101% (квота 1 ядро), база — до 207% (квота 2 ядра), Nginx — до 26% (квота 0.25 ядра). На четырёх репликах максимум API по контейнеру был 27.5% при квоте 0.25 ядра. + +![Серия A: RPS и p99 от числа реплик](evidence/api_scaling.png) + +Рост числа реплик при том же суммарном CPU API не помогает. Запрос по-прежнему ограничен долей ядра на процесс, а дробление добавляет хвост задержки. p99 одной реплики (1115 мс) — один длинный хвост в том же окне, не отдельная серия. + +### Серия B. CPU PostgreSQL, API зафиксирован: 4 × 0.25 + +| CPU базы | Успешный RPS | p50, мс | p95, мс | p99, мс | Ошибки | Кто упёрся в квоту | +| --- | --- | --- | --- | --- | --- | --- | +| 1.0 | 165.641 | 297.372 | 499.711 | 598.3 | 0 | база, max 107% | +| 2.0 | 331.742 | 112.739 | 377.522 | 459.163 | 0 | база max 207%; API max 27.6%; lb max 26.0% | +| 4.0 | 417.528 | 99.961 | 288.263 | 371.702 | 0 | API max 27.4%; lb max 26.2%; база max 242% из 400% | + +Второе ядро базы относительно первого: 331.742 / 165.641 = **+100.3% RPS**. Это подтверждённое улучшение: при 1.0 CPU база была на квоте, API (max 14%) и Nginx (max 12%) — нет. Четвёртое ядро относительно двух: 417.528 / 331.742 − 1 = **+25.9%**. База при лимите 4.0 использовала максимум около 2.4 ядра, а API и Nginx уже стояли на своих квотах. Поэтому дальнейший CPU базы помогает меньше. + +![Серия B: RPS и p99 от CPU базы](evidence/db_scaling.png) + +Крестики и звёзды на графике — не точки этой серии. Это поздний парный прогон, он ниже исходных 417.528. См. следующий блок. + +### Тюнинг Nginx и пула + +Проверялось ровно то, что предлагалось как снятие узкого места: `worker_processes auto`, `worker_connections 4096`, пул `PgPool(..., 32)`. В первом таком прогоне потоков HTTP было 8, поэтому из 32 соединений реплика одновременно занимала не больше восьми. + +Сразу после серии B тот же тюнинг вместе с квотой lb 2.0 CPU дал 336.611 RPS. Повтор исходной точки серии B (пул 8, один процесс Nginx, lb 0.25, база 4.0 CPU), сделанный позже, дал уже не 417.528, а **344.846** RPS (p50 129.553, p95 307.781, p99 397.828). Абсолютные 417.528 в конце сессии не воспроизвелись: долгий прогон на одном ноутбуке смешал сравнение. Зачётный вывод по тюнингу — только парная пара, снятая подряд: + +| Конфигурация | RPS | p50 | p95 | p99 | +| --- | --- | --- | --- | --- | +| Повтор плато: пул 8, Nginx 1 процесс, 8 потоков HTTP, lb 0.25 CPU | 344.846 | 129.553 | 307.781 | 397.828 | +| Сразу после: пул 32, `worker_processes auto`, 8 потоков HTTP, lb 0.25 CPU | 350.038 | 120.943 | 334.087 | 396.982 | +| Та же квота, пул 32, Nginx `auto`, **32 потока HTTP** | 273.854 | 176.149 | 373.138 | 519.185 | + +Разница пула и Nginx при 8 потоках: (350.038 − 344.846) / 344.846 = **+1.5%**. p99 397.828 и 396.982. Это не прирост пропускной способности. Числа 384 RPS в этих прогонах не было; сравнивать тюнинг с ним нельзя. + +Снятие потолка потоков (`workers_n` 8 → 32) при том же пуле 32, Nginx `auto`, 4 × 0.25 CPU API и 4.0 CPU базы: (273.854 − 350.038) / 350.038 = **−21.8% RPS**. p50 120.943 → 176.149 мс, p99 396.982 → 519.185 мс, ошибок 0. База при этом занята меньше (среднее 110% и максимум 179% против 130% и 204% при 8 потоках), то есть лишние соединения пула не начали работать. Квота API по-прежнему выбрана: максимум 27.6% при лимите 0.25 ядра на реплику. 32 потока делят четверть ядра и добавляют переключения и ожидание на мьютексах, а CPU, которым можно было бы держать больше запросов к базе, не появляется. Ограничение в 8 потоков не было причиной простоя пула. + +Плато серии B снимается вторым ядром PostgreSQL (+100.3% от 165.641 до 331.742), а не пулом, не числом процессов Nginx и не числом потоков HTTP. Квота API в 1.0 CPU на все реплики при этом не менялась. ## Ограничения и следующие шаги -TODO: какие отказы выдерживаются и какие нет; что не реализовано; где учебное упрощение; какое улучшение подтверждено, а какое пока гипотеза. +Отказ одного процесса API выдерживается: запись продолжается через вторую реплику, подтверждённые сообщения остаются. Не выдерживается потеря этого Docker-хоста, единственной PostgreSQL, Valkey или Nginx. Несколько API не делают базу и балансировщик высокодоступными. + +Nginx OSS не опрашивает `/health/ready` сам. Готовность для LB — это 502/503/504 и обрыв соединения плюс `max_fails`. Окно drain (2 с) реплика ещё может ответить 201 со своим `X-Instance-Id`. + +`tests/load.py` — closed-loop, без прозрачных retry, процентили только успешных запросов. Серия трека 1 — отдельные окна по 30 с при concurrency 50; один ранний прогон на 36 с в таблице отказов к ней не относится. Поздний повтор точки «база 4.0 CPU» дал 344.846 RPS вместо 417.528, поэтому абсолютный уровень после долгой сессии плавает. + +Сессии живут в Valkey с `appendfsync everysec`: теоретически последняя секунда записи может не попасть на диск при жёстком kill cache. `restart.sh` шлёт обычный SIGTERM, persistence-тест с этим прошёл. + +Поле `attachment_ids` контракт lab3 запрещает (`additionalProperties: false`). Когда оно появится в lab4, хеш идемпотентности нужно расширить, не меняя смысл уже сохранённых ключей. diff --git a/compose.yaml b/compose.yaml new file mode 100644 index 0000000..9422f59 --- /dev/null +++ b/compose.yaml @@ -0,0 +1,99 @@ +services: + db: + image: postgres:16.15-alpine + command: postgres -c max_connections=200 -c shared_buffers=256MB -c synchronous_commit=off + environment: + POSTGRES_USER: ${POSTGRES_USER} + POSTGRES_PASSWORD: ${POSTGRES_PASSWORD} + POSTGRES_DB: ${POSTGRES_DB} + volumes: + - pgdata:/var/lib/postgresql/data + healthcheck: + test: ["CMD-SHELL", "pg_isready -U $$POSTGRES_USER -d $$POSTGRES_DB"] + interval: 5s + timeout: 3s + retries: 20 + start_period: 10s + cpus: ${DB_CPU_LIMIT:-1.0} + mem_limit: 512m + stop_grace_period: 20s + + cache: + image: valkey/valkey:8.1.10-alpine + command: ["valkey-server", "--appendonly", "yes", "--appendfsync", "everysec"] + volumes: + - valkeydata:/data + healthcheck: + test: ["CMD", "valkey-cli", "ping"] + interval: 5s + timeout: 3s + retries: 20 + start_period: 5s + cpus: "0.50" + mem_limit: 256m + stop_grace_period: 15s + + api: + build: . + image: mtusi2026lab3-api:local + depends_on: + db: + condition: service_healthy + cache: + condition: service_healthy + environment: + APP_HOST: 0.0.0.0 + APP_PORT: "8080" + SESSION_TTL_SECONDS: ${SESSION_TTL_SECONDS:-3600} + SESSION_STORE: ${SESSION_STORE:-redis} + DATABASE_URL_FILE: /run/secrets/database_url + CACHE_URL_FILE: /run/secrets/cache_url + IDEMPOTENCY_TTL_SECONDS: ${IDEMPOTENCY_TTL_SECONDS:-86400} + DRAIN_SECONDS: ${DRAIN_SECONDS:-2} + secrets: + - database_url + - cache_url + healthcheck: + test: ["CMD", "curl", "-fsS", "http://127.0.0.1:8080/health/ready"] + interval: 5s + timeout: 3s + retries: 12 + start_period: 20s + deploy: + replicas: ${API_REPLICAS:-2} + resources: + limits: + cpus: ${API_CPU_LIMIT:-0.50} + memory: ${API_MEM_LIMIT:-256M} + cpus: ${API_CPU_LIMIT:-0.50} # для совместимости с docker compose up + mem_limit: ${API_MEM_LIMIT:-256m} + stop_grace_period: 15s + + lb: + image: nginx:1.28.0-alpine + depends_on: + api: + condition: service_healthy + ports: + - "8080:8080" + volumes: + - ./lb/nginx.conf:/etc/nginx/nginx.conf:ro + healthcheck: + test: ["CMD", "wget", "-q", "-O", "/dev/null", "http://127.0.0.1:8080/health/ready"] + interval: 5s + timeout: 3s + retries: 12 + start_period: 10s + cpus: ${LB_CPU_LIMIT:-0.25} + mem_limit: 128m + stop_grace_period: 10s + +secrets: + database_url: + file: ./secrets/database_url + cache_url: + file: ./secrets/cache_url + +volumes: + pgdata: {} + valkeydata: {} diff --git a/evidence/api_scaling.png b/evidence/api_scaling.png new file mode 100644 index 0000000000000000000000000000000000000000..e64d327586d69e9f493c6403af113130fc9eae4b GIT binary patch literal 70563 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 literal 0 HcmV?d00001 diff --git a/evidence/db_scaling.png b/evidence/db_scaling.png new file mode 100644 index 0000000000000000000000000000000000000000..09ede135b9aa849048255d1b8140504d937d6126 GIT binary patch literal 79483 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�ZD-*>}d1oeGXpMOLkF1z` z0;lQAjg76p+}2Qp`D04_$_5}?{;%m*oPl9)AD0tR-J>pu>b^NN)-(t>Lx}}!d42V( zU3=;2@q8ZMtV`iC?ehy;65n6A=XFRXyI@~n9!X-vjI<{o^f!)CRgb%Pc{BcaH{!;t zurN_E?7;)Mq}lEXrIfZEl$S>x4+aU{cYRFxlV$U6(Sibnv}cUnA_B*RGJ@?Y+`nLx z!BC31KfEvGk}t244>QwivOFdtrFh-uXh20)LD9-33BR0OoX&2xoTUGYxXK!F+qM=N zP0oamQLK|vhQSSVm)4qm)5b<~-5R!|Z8sz;1VqGe0PFxhJvTxWy*+B}a+mCY(|_OE zE!wAh4|OyQ_SMC>r`%Hav*IS46$VVSGfGJR*X1un@KVATEmll#BU%!OQ)ty1qV~~~ zSWSXUBkg+Tvkk4)nW^;=@xNo*LG~XSE@uC8?Z~-|<#?W&u)tKHjnLNhAq+cR?S2Mq z$d@XdxfR*poX=qDcmMy_+nYe;*tTJ#cOq2COQAs}l%hF96Oslgq(QSLQJPDm22`3T zM1zV{6cy5_lq5|e8Z-||ljcN9{l}H}{r|n!+W%U6?e(wSTJOh~r>Fb5@9R3x<2=su zI*ysrO*@LE!keWJOmnLAHY@gpMd(q*#Us|lCdb~n-i(L?Z+S?PzO|7eb{ucR!lfkP zB5;4&93?zLq*tLdYs2hbquVoT=_qTjg>GSD_UbUq$TE6N?V9EkGT4x%`9S!U*Nm6v zkZasmbY;*Ots;jtLyO3U8EmNkvJ;f+W*Tmg)CcfjFq~5FP@vA8B@w?@3>jXXZMhOu zE80GMu&7U#Sv=#~vdQ%9`nB+OBbQgN2(2#l2Ejg8IcY$p6E>=`SN)MTfk-;n-CudB zx7E^A*8T#yvfZo0`r7}*{k${3+9&2Q1Lv{4m`B%iS;08UCqBmp41e*P7d@x)efdSL ztP5wXQ#N3T_XCD_{W0N?BKSYwCwolpSi1Awe~G0QtBsndbTbI%67NpFf#ucyyCQ>0ggC z%k5~gm&JSI+^*tc!)e#-Y%&TDJV4U6$GP3V!ztZIEllnK2JJ`HP)_h?-RD5RFNmxPr zSMwmEzBe-puJiX)Zvy}dkCr_^WJQgBhy0R|qQ)M7t=N;%dMw!A_-|3Q#V_jI)(jmI z)*nuf^5vA}c!@2-AJegPs|$7k-Df3a;x!b>WhJi(i;ABwWiv{r;Q3bSadY&ZQBK3Z z9%%~#$YkJ8NdNJUXCj*JT6Zw2xh=uMTY7E@N6Wpv@~R(r>q*-^rGnOMAVbgfY+2v* zaD|IeMfv?ZoBkSX-G%5r&rq=-7K4&*VMxNsbA(q+uN(ftfXs=W-`Bwb^8*jnnJpb; zQ_{)3SLNWsVaQ&8Wk={N&~*NuH;9@avy<6RPK2q4LS+cFOea<-(#`1|RRSR9*x`mfe)Ha+OK>m3@hc7BnBzRC#1QjJL*({5D>+>@&~_ zqTic0;6erz^7hfhBqbgV4KQL_TS!OFqTO@zFepgzw=|JW8CkqEHm+rUZ(FB&r02gl zuJ>_wru}u{+eSIsKmY1m2;S~)h4NrJ7a&%MLCn3ou3a2joQrctXu4Z<|C+p1u0&B1 zEz0r-HMS?ITk6WDtXzC!RxX4Z`;1*?<3cesW7AH31QuM(bpKc6LUa5722;k-j?p(* z%GW&E-g`4zj%2I_>{EL~%1dT7yKzTx)F- z6%`Gyy}Um1$!WL5j`+IuiwlD>42G5tILK)CJEH;9pJSsj%W-6TF+#t_zf|DuUAFP8N3iwQvc?&k6N#H{Vh-Rn~Mup_y9RNmH)1Nd(OQTKIHJ! zcSYOU#6>Hcx)0JU?f|6{>shKHdg|1&|BHsSOn#{M!$y3V%V_3x~!!4~&b3E1oeswIS7 z*8J(IzK#U!LFog?dmG2UFMrZRhCzK_?TixfcfarZ?~PZ>;1jq^SQt!eIgVyKSa}Xg zl(91hW6E37_ySq$Ota zm+w`cATj}E7~<0=LwtG|CA<9}ym&MCFu&(!vpjZ^#vPi8lG*)ZBRNGho!38h5RIa4tC0 zeDs9F1jG1`>7E-bt4>V}v26A*4KMsQQ+sHmNbVh9gTIQ}C=l!|J64k?Vwf3{@FWBi z&Dwh~3ubz4v;5gRRdzr47Q#Q8|6EyXo zXxE#NG7@YlPPywj>&0n%Y=U7vdaGG!XWU=ilI|B!b@koVyzWbaOq#7n^|JcVhprAyc0d=*CR$8DQ$$B&HY zby2n$|8gb(C051l@FP_^7!7<$T*iGr!uk8 zzJL0M-Vgrd?d}~g^!xka_8Lxy7m{g_TN{rZ)IE|^b6;T0;n@Iv0rk{;w3gn_#i#nN zXZDDIh0f~53%0DuFlKj~`FS-OLn!Jv^_BUy@jF$A((*|7{(bYSmtlp~R?dCr#Ga2o3oH-OUd*#7Ptt5% zw8exr zs+eo}+kf4fsZyf0T*xYHSu7XWPP9`_+N zExuCd;7a%RyQwtGT>pME-0}d;e=lYIKlsvOv&^RR3VXPd^!4@8$3xGVwQX_xUafP$ zQB;)2PqZG_rj;*zW_IQ6hAwM`nP`5f7|ub$X3fHhO?}x^VOrDFpR_#u`QLv{mJ>f4 z(dqd1?Ti!K#2%cWUf|>Br}rr>mA@<%9<18Y60O?N5v_th|NBq1!^nQCf$#s9TOiI* z`1fuqN!$|{BQO+S^*&H-U;M&%;n%kKrM?PFa2QuBU0)du z2Dtk0;<(|HF*i(5Jl0AhE=4%71TDWx^i1sRYy0FBnxC02hvYO5&JKdN4~UG6q~}ZW z3FGHBJTOQhasuIDVZ{(fC2}sf3W%%Zs4r;E<0S4A!@_7tJxaQaRO6k%QKnr=@Abq; zz%!G#^f)$oav;9S$ZKXB6cTp)%-U_;YzJEaqbC=VZr}zG2}i68I8t4P2(Cu|FBnYU z7Br}Y1uWD=dMgDo5JeTT!QhFz27)0@A_c(~B&^jTH&W8R#R$Is0h9H$p(<}}6H zt{zD_o{(7oR-Hdc>-?jG4yp-%M*Ola+%cGKGk^B-i@}WRz*z< z3k#pd?c|Se#_7+7B$W**4(P~#fh>dGqv=Euj0&8gqoWhGuIig?g2Hu#Ag_dkW|uRA zPf}7+R;Lb=8{{>j&R{#}e?@D#dNA0nVJK_dS_DIYoXuPzv zw0w@?i0tFm6_0%sI*mji9C^^qZ69QWuT@qa(Z`WYzsebyH85@15P+q_!^K5;%5p;4 zEZ22>3#2}oHg9e(VCGeoy!cz3oSubB0))`mL_|b{G}|FvW3F)Z`}gmLsYfSFphRYT z_AESI*PPPPIk@#7ZtQ2sK}13{5n?ySwzeH+`>^_9ET*Wcx~ia{pmT7L{{Hc+Zvxhs z!hhsxR@PheS#`TYuF6APEl%2PiI9*Gk$23`&sREnv=qLP#5=E~x|$KfG$->5*77Kn z$2yyun0&fhzx_y9NKNyXFR1O7fxRxn>0G<1{u7BwNygo!fw}fy>FVn0qIX)sY3^!J zkQ@kQVMs@uwX)(77hjL&d!&RF3slMVxuHpHaN=Eh0YtI_&65K7U>Zg($5ZwveI2ptRe!1_9blieW97rzPXo>^#uJ_me!Vz&% z2?>ehjEoP@Gc)tXpl;9rXGc1pq{KvVt3u_^YVoq~L;KmKUB{9XI}dL;;iw&6a1RH0 zpEWn@rU-{CmBN_q4fPZk#jgq5=mPv5?vYCTo@g>KQdnK*vL)B`;z<6pPoLDI#)yYi zX7nxYO}^gYR&g&vf`aHT41C%aHHND?V`Ec8J;m+YURCk_y}9(}>&^q84qMi}f*XO( zsZ+w#P7#r3`yQ*^vim)CE^1Wy*{N#u9yd|hkT^}M3=b);nq}v*wuNp(_3PKZux&_@ zULrITD}zp5%9xS&p9q@M7$veC8N8vrbeERb+g~#?uRneqOR7W|rc4=$S;WqrJ9F)L zcz8U~y`+5bF$?QNt_~_(V_zvC@Hji2?i|fJUNsDf`D<*9|L_hcq}NbKvxOacl*VR0t<$NmtIPdS zTlr$wxen-1T*LY^LGMYl<8>u=L_l;jD{{pS=6QI|-h-Eyl9JK^%x{U+-!3?EmR{yW zlv!p3WULNtufY>wDbmA3Aj7i6>FK>f8A8s2*)C9%OS@8&yi0VxfNLU&V(-x|rs z(EE>b)c$dC35hP4T;Kz@7PzfbQ&ZceZj>Oc*_?eJ7LO*-a^Vva3W$o@gng&c%y|7p z!Sm;$kY^-;|H!V3_eWc=ZNq-0psSv&4%y4I2=)h6R2Xo!{1PIR_3GyGLfKDl6gkLCeO*78xCVf_2|Ucn@;*CAF4&T+gMlxz_Oyap&>ieQl6E6*RHn^le!AacoQTU)nwc6 z`PLiN8f{ukLyVyg@bTlvVkAG!O6(59?`<#dc+~Vwj*ogTuytJg8LMuUraUPiAn*pB znkbA;96#;@UyxgO?wF#n^zrj&E7AQI`?77J$N<%1g>&b2z&ax=F76s68Q)Y@sU$hT z89OoVC*lo;z4#Xb6{Fvwn^^pH941nO8!C@=g;xvn9ubv9Hbz=n`t+GI{#Xm$ z=$S&^hls%1v=;;-=Heh3Xlyd{FtUo^Sfr-u3*VAdGi}n={1|{ZW%(k#pnx4t%G)72`^>RV4bF3qhWUR5&0_b77?&*7FLY-{8}`UC z7d%DsG1qJ~#kh>frOTI}VPw(fI<0wRR1~+E*hx#He<;X|9E1!NF|I_-jB?gCv#(#~QmX?)u-#jLJ5PrJ}2?^16x5KDtxaDEIR}g>-dcbgu+JtN-hwddF z>_>#*?UUXxb8yApPrCg`Q&aPGOA8wYJKjKZ#UGQDIh~ur5TFOgph;qk4yeOu|NWih zV+X#f2&{za4h@y-y&y}snw^i?Wnuneig@Bzdncz`D=`E01}mepukU9`&gQK`8Bd=w zwYRtDUYy;HE9>m)y6@EP-Voe0s&sdn=`$t;ZR@`d-Z!zz}3yI*2PAk1?mpzMn%`4jiqdmgA#;_ z3#}0{dc}@0ma*~i6Q{13wMkvwOodW&fUHCa=ogy5UV+DVsZ(q9m-foR4bmOq`Zd4)V-9HK&_%NJ3H@n8DV#o zj#FpT`Da49Sv~sE`MF=?$F;Q)N~IDTE)p*we9mP=J}6uBN4ZLQO${6-_n4Ig2M6bc z>YqIn+u$0uvjSa(&Wb4O9s~Y{&C}L(hI)Fz*qgLI)gyHiE0!)nY9bwP zfRXN!;GiHTc6LSz<_+qT8qs{)czG3#mtTaF4t2|_1^X5n$C}#_z3;wkBO5&(ztIF5 zZlc$rPs>1ce*YeVm2`-UNnGbPE_b7;s0x?YOz#G1_o)>~uW}eH(CZd2-+!0YG$hM; zo6^uenBwi>5ZJz*uA-tMa-ZY&ox66?P(Zj>Vq-b(c=c9BFa^IA{rS|hFV_-~I#?2p>^_7N<1M01-V}sh z4nnn@Nc9c-yTfD{P6Ti2>zOg<OA;PD5P@9}G3#b1^7tvp&dz=uKn;ixR(s5N2fYA~@$SQW zVOn457H)wjjEZaHm!_tQ;VbYJH-;}+>m=6j`Q{fZAw>0-ASAyv7*Cyj@DOggk5W<& zs;mE#Zdgc95kvH+W)(MB_H#}wVD9-^mQ^D%F)gO8fD#Ww;F=%`xJEocDg{1N=W#?j z;y_+_hFF;*Q42^{3@~`_;llu=jzfBSY^WK^tEz}T62vrHy4M@&Sk&D0MVh@E8*6N3 z#b9b`dh7P>Er|MZ_n9c7>hPKW zxdH`z$U551PFu6@_hLs_1VSl>RGQwbM)`gko{U=%Qx~D=IUy2w>qtgY(p&7Yqx%q5 zk8&}U_jrE|-2>3CV->sl+-WS?(ClH%Kqh{=4!c8|(+Ij>OCZVmmYsv6_nV7@gUKG- z_VdG^-Fsnn*vgCB@tS#G!`pANXg~g%886L*p0UAWz z5Lh=-+y4nnEP>!<<=otyStS&kEMQrf=6s~bd!)Uv3e0YAcABp*P0Oo`FOSB-e-7YQ zQZkyMs-{Nk)V0f(X^~-ct>ReDmBMXt6SW(zcTu?zz!RpvLo7TjFc@PjK%t`XRTJ$z zSNMWS#f89g2o7;2zu=e9O_V+37GQ#jy+v=kAMc8wT$r8QdeV5=UI zm%mctYGGkP3?n^Wc`tai7J6)ecZD!!z>mx#f^}i&pO25vCoXQYKjWr^DVx4TH#`pe z&t}Zeva=DQ#d7=Z2pY(tl)}UAv2oJY((-@wh)>${7ZYMo02W_JXlP8~Na8tE@dr_>G94@pK|Uf#Tp2$J9sG@hMr63rV&nMJBfL{j35K_tV}d4421!z7Xc zVZHqQ`@@iOKW%DynG|+~&M+a^NDvBK4{RD9Tsh7s4`suNiHVOm?Eo}fdH$4Avla@i z>5(=D{5FIXmA8nRjvk+t&dBVZ!qg@Y5G|MpVNuZ%RDfqEB`4G$(H>jDeT7L5|KmhW z&Oq2mvT_foh$!+gRs>;l4Jk9 zN@+Rr>3^?Eq`kLV`v1+ZnafV6xUanM2L(n9e?GWLZ)Rjc#=xL$_YjK9^RNVSucrszr9cmSK?w|WVf-8ZWzudFOJS>Ho9%94Zq5xu z;1Ch`u`%FhKQ=Vn_RwD`8@~oc6{6xnMa2My4T17k0|R|uy^;kxAo$Z2;ZPo`j;Mi+ zO-(>zbdfRgWG&euFrATuX}%kR8mEcCToui3n<4`_Xn8 zl;v;Q+c&$ryE}Y_WF->u0ULejn0EH`Bux6P0BrX$#4g99+#A9qXGnuN zTt=VjLnFAw3PD&esII+}@$74ZnnMBO~o*ryOr+ zdueE_S2=pr^Zo<^?-!UnvZ+o2$2(*U;mnO;|6T;T-gZTo(RR&9wWjIwk=Zivlob{e z5eZMt1a`0b@Ijk@0gtyS;c##y!~!)odCJDWj}i-rh={1@fmUn8tS-%I3~ECca(Fm@ zUGUrQxOfX$Sy}$YTV^J{#-rtj*2Mcp!(cmuxy-g`(g*wDlijgz;S$S~;XH zkV#wxU0v4i!^3*t_ok+%rM<?ssfpXld3 zuazE7l8LY%Y28PRJ^(3+e_-|d_u;p0T_H>mJ`;$q&T-e!+u^7mAs&1A-Pij-4P-~c zXABN8{xTlZTvAeOB(38bj~YT@^U-6KjJxcjW>-J`u)W?G3r678%r`b9_AcC^(3)nh zD`DOtgbreo)4goAR2KM;e-3AMj;gALo;!Q?Dc+eyY91$_Hc_{4-)=B@=eia+f{_|R z0k;mY!yenu80CUFFzX`OVMd)o<*Vc5^g=@)euoS&BB4$pC42!tme?I*Dy}i1%gW07 z9Jf{!z8B03Qv)YiV0!_e+|Y0T)8&(xIeDTv85*48`vm&ne8?ZM z@B9~GI-fN7b2A9=^P6D(Fj6gr9xgY{;b@iF*?C&)_;D`g&77PcoSd9CQc*fAH`e~T z6Kh^)nDG+j6rsT|rTRm?PZ1G#nYD=`7BP18D%=#NK>6~DimsBO!ND**YZwS8CMPGn zdSz(5DMX|dX$GeiP(2(pH&4=-L){-95wVQg>oHAqO5x$`i}PbCPQaae9ltTw#P7cj zKuUdR$bhz)k4RaPii!%-@=^dh8VZ^4;Q8}AL0j@@wj;sW&rF!3Lfs-GW01g9#BlE&e~ zJ$-$qU~I6&_S$zZO;(HL7i)f$l;j8aXbLtn^mbBmvOk!TjetjdJ9naHKb+Z+1=>;s zJZVoHjzr?aK*$#tKW&(6M+46q*WXhq8tp)-U(tQQkre+^J8hoNfdfJp>A+5w2RNAO zu>jb0568o5-IEg&xlm7I*Jwqa0U3quQVOm62uYX27e-oFZoVFXGg#2agj1B*`Q@sPpkGhv>hc>DwYKW(7r4T+fkmCC1{=Ip0u}lvvwhjw*{5Ed z4X>VG03LwLYCLbt_sM~QD_dT=WE{;y^8ikcUZO*TP%6GS-BYm+{3^h*L!<9+ zXvg->;TT2h3RWul;lp=whYsb{ih(vwirr(onYK7xKd%Jj;QL;kEK6q75E1+fX<>M5+HC89@Qt%{A=l=)EOSJky*XdnLY zYZ&2|v^jHTdyfC9t^Z^-vAW_dDPi9O#j81GtEYba$h&~o^Qu5^^T&@L@Nkti#op9! zMf>Fo>Sk7%Z*PM)FsJ*qpYFNE>dRbx^({a<>f~W z3}V?1tK!Y5FVODnP1Z){RcVRLc=bDo<}^9Im6esHZja?)f$&saSs652eYTQ_C{xp* zLn=z^8yZBdt*ujZXocjSdl!Q)Nh;YE&y9Fu3hvab??b#rZ*MPuL|c2tOHg?t)ORp3 z>M34Vm_DtoWp$M+7a(rJ!s6nDHAPl`hT>fV6b!OD6oBQFlvcF65AC83K%U$9+_^x= z9FrQ~*Vp%BU0o?0A}MJ$5u{m3aE``j&d}kGBZPF~-~o|&hfFh_n3x!;eNc#(S5{sM z2w09fU`c0_S{p@bRnzhAx0DYkmDjDU>?p70PM<#gKuTj_$Y?B)CiOzP_%lT?;IFNK1=_q(Riz#8yaU=<8QnU=(6Dy=>XCu^&JDf`b`w8kHg~ zAXCF4FAgeN-%1ink^MtMIFYgja-jghG0#=&_$tPc@s0Sr5jK1*hTL$`;~fk08>r6S z-es~y!$to9YzRAkJGzmL%@l4VxkzoudBPWeJK<232`=VoPEJ60_*y7U+YL8M5UQu> z&vZA8a71mh^ig+HU-wZPMPGrFlV+Ufd%NJ~T)lQe10p5^=HDGSsm3^oSc zJX%Cg_&MHD?^QnYQz`wWzqq(K+F!mcIksOBnM9@X1iqrj2cdj&hkoWwNF!p}u&f3n zkHZ**+@PhsyuHeHv@sU{URPglkA4BEH-ro}1NT~4|5>vHf6^U(`H}WC>etrvfg5Wd z03|wDNt0{@9dz2_-#E_^;f5-h&S%-urAleb(*WC0z!;tuY;qI7Hk(rs9)#ooGvLIDSMAc4X0q(|mt`viQXD6pf zxbcDwx_LwjkA}{NL)!IeMPq^Y!aSo-olUop)RK(KaW?fAY`ZDACcQ4aW-YU1jZd0> z-i?;nm)Y63-8?)T#iUrX6@iKHRHQ!F)`sg`-#Hp7^qdahrG~z-2uJ7QK|?4H$BrfN zj3L09#!5QhXb$Mc5nglZ3z$8#PXaA*t3JQF3Uyi$s=A{iK6bDDrE^wRSVLmBBO;R2 z_Yp>zw)nkAdVDtqGDpk*4BiK8{?7DQji#4yT_*W01&5-h1C=6GB}8@iE1lF zJ0%#cpZkvfB$v-w3*ozpg|M3a)YTZ*|1)!JgZKw?dVzF2;#FBVyCK z7tIb%*Qx%s_`fk(g7x+Fk5W@_NO>f@c(ER5J4?U=n@y`7uSajv4!zr`3#5+-Ep}fh z_IKeZc0^3hzLt}5KsC5$r$O+8=B|Lb4QSbbm`p2mRm8TA!v}l9zWq%SXfwR#ox4E1b_ssX((T- zs(tPNp-vU!y_1162QH(vXXhO)laVrgelf=)MB! zv**sG)ZM>0_e-Sg8b>g8J(iEsuF$h*u_{E3Yiepv0lwn+uRZ!t+oi@hy7E7N`XmP| z0!FMyaDf{boxa%*M8W(+q&JfJA=`5E4y zmv!S%fcc2{16J&C-f6C^aBl%7kv3O~_6-aUlHMJ%-;Jg}1^}KMRHA}-Ox5Ji0j=HX z+xiCvd_VL(NKBO9J_7m+&A)dzGDjLSBlZ|ppo-xv9ROMKPC%8=%@0yj>ETnmghHTJ zNPR-Sk90!C{TXjyL4OBQ0joe1!19$D6qX26!-!=2M0M& zxIh6tYAa>E=cP$eMq0+8efjH)cA!yWcj1Bp42rQr9y}dEIY@6IC~l5cA4uZYfFfqy zoA-N#z>2|fK=L0%kqAj6^gH_7Ugoqm*1majXe9m+N)yTlvoI)!i@$uytuv#S5OrXQ zir=p%rKV`K9GI|$&uA^f4QV-&cmT38th$yWg%GlFs4+uPQ8n!%QV(Y*&mqJhesZEch{SE9w*?WyZJmtbd86S&LnQ)~mSkNe74h?>IT85=dd>E?k2)zU4iN3`@ zyq!D8)CjvM!-O&M!l-1nqdbK2;Ou?RWBSpSQNo z+pkV`KU#O-V81jsmz0;U$ji(7l4Hw>@83s<@7_Hw41vlRxu8)2_IYe#sa^NIZdS?J! zPhy{(HZ(L0`Ov3Qf8sgA#Wxdd`555IeE$4~o)Dhmbo|0xfQkn!B~xb6EhdIeFCBV= zszn5iUR9%u)%#5ZZRK1&XVaJJw8!1=OyMpEH?_0~>mF(I&V5V<2M-+9T z4W*gXR-#$BW^NK)rA-tIJNwRcId)wj@Y)L8GAm5eb+e9q(~r(yGl!Unu@(TqWVM?j z$<2aO$XA4(iNZ$#X!0Atkh`D)fy@dq@Fr{6e;#`i1 zhi20oRE6P)F7UxYu|axo_`P=|Zvz0}u7#jN=0I_G$l7|BOVJsuCDN5ZOi;webd}yr zJd*LKi8Ct5zVOtq;H9`h#!1Y60Fpk0Sq}&#g@uKYe7F()ZM3Jb9d1USk;F9+X0Eoj zHrM?J|7K}dAIwCN7y%ddNaA1-nuY9VH~CGKUB-PqJ^~isJKzkvAA_1$A#dKjQ?zMA zB_4`?;||Y19E5n1i5~%Ixf&Y!7A=+B+4Da^YVY2?o4j3Jxx>kK7uyLE0h~u?`2gSg zgydv87!DALl9fhAMiC7UuK(o? z@|WkUBf}|{Et4~zq=W=xvk@F%>#wjdCYWN<;5MDi*GJkQZ8xM~Im|a;D$v;6+|T>Z zkdcGS#GQf-TOW)TXa3AFQ*=4ZdhNK>zJ1&%Gs%#Rr6oT|rTY&bE=L0daPdLKw6~#0 z;RqBE){qJr7Boqd04>*)LPeNeOwfh+^kkzcpMbz+l-e4|8@VOyJ@i&_0dd`Su+jgu*ph9QDkEeM!^wiF>8{1U4*3%=|F~XGiW!htT zLv@gpc&-6C9bPdlQodo+-LThqjbY2M@NjPD0CZet9wzLV!e=N$@yN{*+-q|+>uhbp z>d$V=<6^7er`nv)nz#v0fU8LEf-#1rl@)?iQ-kJ~rPOg9oj^>A;GX+Rjshmrg`$z8 zBy}7R6%Al+^f6FDqPs?5(m8GO#qLeX{r_v{hOa18@V`EeTr=bU(caJhPc5eZqrYa3 Zv+K>CZ8y%&X;Ju6KCC96E_eFU{{a1%aWDV? literal 0 HcmV?d00001 diff --git a/evidence/load-rolling.json b/evidence/load-rolling.json new file mode 100644 index 0000000..f7a9991 --- /dev/null +++ b/evidence/load-rolling.json @@ -0,0 +1,17 @@ +{ + "lab": 3, + "workload": "closed-loop POST messages; no automatic retries", + "requested_duration_seconds": 36.0, + "elapsed_seconds": 36.028, + "concurrency": 4, + "successful_requests": 7398, + "failed_requests": 0, + "error_ratio": 0.0, + "successful_rps": 205.34, + "successful_latency_ms": { + "p50": 11.798, + "p95": 55.641, + "p99": 87.623 + }, + "note": "Latency percentiles cover successes only. Timeouts/errors are counted separately; closed-loop has coordinated omission and client overhead." +} diff --git a/evidence/track1-A-r1-apicpu1.0-dbcpu2.0.json b/evidence/track1-A-r1-apicpu1.0-dbcpu2.0.json new file mode 100644 index 0000000..fc142e7 --- /dev/null +++ b/evidence/track1-A-r1-apicpu1.0-dbcpu2.0.json @@ -0,0 +1,54 @@ +{ + "series": "A", + "api_replicas": 1, + "api_cpu_limit": 1.0, + "db_cpu_limit": 2.0, + "pg_pool": 8, + "nginx_worker_processes": "1", + "warmup_seconds": 10, + "inspect": [ + "/mtusi2026lab3-api-1 1000000000 map[com.docker.compose.config-hash:a0d0bfc74956001c4529e42788007cb2de76144eda4a10a4ef7be0ff88f426f0 com.docker.compose.container-number:1 com.docker.compose.depends_on: com.docker.compose.image:sha256:a1ec572a54fa12c0ab467a444062c9a59e7bc804b20247d743295cee651b6fdc com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.replace:api-1 com.docker.compose.service:api com.docker.compose.version:5.5.1 org.opencontainers.image.version:25.10]", + "/mtusi2026lab3-cache-1 500000000 map[com.docker.compose.config-hash:a7d737a55154622d18c1f35f33d3767c8335e00fb23f230f1afca917e900252d com.docker.compose.container-number:1 com.docker.compose.depends_on: com.docker.compose.image:sha256:32627109abf6f741121096b45c732f758876803efd7b2e1018ebc0350d117119 com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.service:cache com.docker.compose.version:5.5.1 org.opencontainers.image.source:https://github.com/valkey-io/valkey]", + "/mtusi2026lab3-db-1 2000000000 map[com.docker.compose.config-hash:e1447a13d70e0172bc8c2b2b96bd30e491dd7eddbc4f79f3412bd6e987477e84 com.docker.compose.container-number:1 com.docker.compose.depends_on: com.docker.compose.image:sha256:cbf42f0edc946c0bc1b8eeed62403734e1f25dc67a3491455d07a92fdb558b28 com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.replace:db-1 com.docker.compose.service:db com.docker.compose.version:5.5.1]", + "/mtusi2026lab3-lb-1 250000000 map[com.docker.compose.config-hash:8afd1a6fe04af86c6e4c4bc0c6be3e01db2e2c692a325086cc477df1a110aebb com.docker.compose.container-number:1 com.docker.compose.depends_on:api:service_healthy:false com.docker.compose.image:sha256:09ab424a8c788f8d0fe3a64429f6d19dfa526885c8609b748d0943a75dcb9f8c com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.service:lb com.docker.compose.version:5.5.1 maintainer:NGINX Docker Maintainers ]" + ], + "cpu": { + "api": { + "samples": 6, + "mean_cpu_percent": 90.41, + "max_cpu_percent": 100.84 + }, + "db": { + "samples": 6, + "mean_cpu_percent": 186.35, + "max_cpu_percent": 207.04 + }, + "lb": { + "samples": 6, + "mean_cpu_percent": 25.69, + "max_cpu_percent": 26.41 + }, + "cache": { + "samples": 6, + "mean_cpu_percent": 7.52, + "max_cpu_percent": 8.86 + } + }, + "load": { + "lab": 3, + "workload": "closed-loop POST messages; no automatic retries", + "requested_duration_seconds": 30.0, + "elapsed_seconds": 30.758, + "concurrency": 50, + "successful_requests": 10765, + "failed_requests": 0, + "error_ratio": 0.0, + "successful_rps": 349.994, + "successful_latency_ms": { + "p50": 121.454, + "p95": 202.572, + "p99": 1115.09 + }, + "note": "Latency percentiles cover successes only. Timeouts/errors are counted separately; closed-loop has coordinated omission and client overhead." + } +} diff --git a/evidence/track1-A-r1-apicpu1.0-dbcpu2.0.load.json b/evidence/track1-A-r1-apicpu1.0-dbcpu2.0.load.json new file mode 100644 index 0000000..255252e --- /dev/null +++ b/evidence/track1-A-r1-apicpu1.0-dbcpu2.0.load.json @@ -0,0 +1,17 @@ +{ + "lab": 3, + "workload": "closed-loop POST messages; no automatic retries", + "requested_duration_seconds": 30.0, + "elapsed_seconds": 30.758, + "concurrency": 50, + "successful_requests": 10765, + "failed_requests": 0, + "error_ratio": 0.0, + "successful_rps": 349.994, + "successful_latency_ms": { + "p50": 121.454, + "p95": 202.572, + "p99": 1115.09 + }, + "note": "Latency percentiles cover successes only. Timeouts/errors are counted separately; closed-loop has coordinated omission and client overhead." +} diff --git a/evidence/track1-A-r2-apicpu0.5-dbcpu2.0.json b/evidence/track1-A-r2-apicpu0.5-dbcpu2.0.json new file mode 100644 index 0000000..3ddca7e --- /dev/null +++ b/evidence/track1-A-r2-apicpu0.5-dbcpu2.0.json @@ -0,0 +1,55 @@ +{ + "series": "A", + "api_replicas": 2, + "api_cpu_limit": 0.5, + "db_cpu_limit": 2.0, + "pg_pool": 8, + "nginx_worker_processes": "1", + "warmup_seconds": 10, + "inspect": [ + "/mtusi2026lab3-api-1 500000000 map[com.docker.compose.config-hash:9ba43bae4b038b5ebe586704e952ebccfab2ccc1d385ed1b26af3b79f702ddbd com.docker.compose.container-number:1 com.docker.compose.depends_on: com.docker.compose.image:sha256:a1ec572a54fa12c0ab467a444062c9a59e7bc804b20247d743295cee651b6fdc com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.replace:api-1 com.docker.compose.service:api com.docker.compose.version:5.5.1 org.opencontainers.image.version:25.10]", + "/mtusi2026lab3-api-2 500000000 map[com.docker.compose.config-hash:9ba43bae4b038b5ebe586704e952ebccfab2ccc1d385ed1b26af3b79f702ddbd com.docker.compose.container-number:2 com.docker.compose.depends_on: com.docker.compose.image:sha256:a1ec572a54fa12c0ab467a444062c9a59e7bc804b20247d743295cee651b6fdc com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.service:api com.docker.compose.version:5.5.1 org.opencontainers.image.version:25.10]", + "/mtusi2026lab3-cache-1 500000000 map[com.docker.compose.config-hash:a7d737a55154622d18c1f35f33d3767c8335e00fb23f230f1afca917e900252d com.docker.compose.container-number:1 com.docker.compose.depends_on: com.docker.compose.image:sha256:32627109abf6f741121096b45c732f758876803efd7b2e1018ebc0350d117119 com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.service:cache com.docker.compose.version:5.5.1 org.opencontainers.image.source:https://github.com/valkey-io/valkey]", + "/mtusi2026lab3-db-1 2000000000 map[com.docker.compose.config-hash:e1447a13d70e0172bc8c2b2b96bd30e491dd7eddbc4f79f3412bd6e987477e84 com.docker.compose.container-number:1 com.docker.compose.depends_on: com.docker.compose.image:sha256:cbf42f0edc946c0bc1b8eeed62403734e1f25dc67a3491455d07a92fdb558b28 com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.replace:db-1 com.docker.compose.service:db com.docker.compose.version:5.5.1]", + "/mtusi2026lab3-lb-1 250000000 map[com.docker.compose.config-hash:8afd1a6fe04af86c6e4c4bc0c6be3e01db2e2c692a325086cc477df1a110aebb com.docker.compose.container-number:1 com.docker.compose.depends_on:api:service_healthy:false com.docker.compose.image:sha256:09ab424a8c788f8d0fe3a64429f6d19dfa526885c8609b748d0943a75dcb9f8c com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.service:lb com.docker.compose.version:5.5.1 maintainer:NGINX Docker Maintainers ]" + ], + "cpu": { + "api": { + "samples": 12, + "mean_cpu_percent": 47.38, + "max_cpu_percent": 55.02 + }, + "db": { + "samples": 6, + "mean_cpu_percent": 166.57, + "max_cpu_percent": 204.93 + }, + "lb": { + "samples": 6, + "mean_cpu_percent": 19.7, + "max_cpu_percent": 24.94 + }, + "cache": { + "samples": 6, + "mean_cpu_percent": 8.12, + "max_cpu_percent": 15.09 + } + }, + "load": { + "lab": 3, + "workload": "closed-loop POST messages; no automatic retries", + "requested_duration_seconds": 30.0, + "elapsed_seconds": 30.161, + "concurrency": 50, + "successful_requests": 9881, + "failed_requests": 0, + "error_ratio": 0.0, + "successful_rps": 327.611, + "successful_latency_ms": { + "p50": 131.433, + "p95": 289.233, + "p99": 404.102 + }, + "note": "Latency percentiles cover successes only. Timeouts/errors are counted separately; closed-loop has coordinated omission and client overhead." + } +} diff --git a/evidence/track1-A-r2-apicpu0.5-dbcpu2.0.load.json b/evidence/track1-A-r2-apicpu0.5-dbcpu2.0.load.json new file mode 100644 index 0000000..a68b429 --- /dev/null +++ b/evidence/track1-A-r2-apicpu0.5-dbcpu2.0.load.json @@ -0,0 +1,17 @@ +{ + "lab": 3, + "workload": "closed-loop POST messages; no automatic retries", + "requested_duration_seconds": 30.0, + "elapsed_seconds": 30.161, + "concurrency": 50, + "successful_requests": 9881, + "failed_requests": 0, + "error_ratio": 0.0, + "successful_rps": 327.611, + "successful_latency_ms": { + "p50": 131.433, + "p95": 289.233, + "p99": 404.102 + }, + "note": "Latency percentiles cover successes only. Timeouts/errors are counted separately; closed-loop has coordinated omission and client overhead." +} diff --git a/evidence/track1-A-r4-apicpu0.25-dbcpu2.0.json b/evidence/track1-A-r4-apicpu0.25-dbcpu2.0.json new file mode 100644 index 0000000..cc4d42e --- /dev/null +++ b/evidence/track1-A-r4-apicpu0.25-dbcpu2.0.json @@ -0,0 +1,57 @@ +{ + "series": "A", + "api_replicas": 4, + "api_cpu_limit": 0.25, + "db_cpu_limit": 2.0, + "pg_pool": 8, + "nginx_worker_processes": "1", + "warmup_seconds": 10, + "inspect": [ + "/mtusi2026lab3-api-1 250000000 map[com.docker.compose.config-hash:baa6c518a5d0d2ce1a2d38ddcfa206234dfa8023729d82b99b3f7264efaf99b4 com.docker.compose.container-number:1 com.docker.compose.depends_on: com.docker.compose.image:sha256:a1ec572a54fa12c0ab467a444062c9a59e7bc804b20247d743295cee651b6fdc com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.replace:api-1 com.docker.compose.service:api com.docker.compose.version:5.5.1 org.opencontainers.image.version:25.10]", + "/mtusi2026lab3-api-2 250000000 map[com.docker.compose.config-hash:baa6c518a5d0d2ce1a2d38ddcfa206234dfa8023729d82b99b3f7264efaf99b4 com.docker.compose.container-number:2 com.docker.compose.depends_on: com.docker.compose.image:sha256:a1ec572a54fa12c0ab467a444062c9a59e7bc804b20247d743295cee651b6fdc com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.replace:api-2 com.docker.compose.service:api com.docker.compose.version:5.5.1 org.opencontainers.image.version:25.10]", + "/mtusi2026lab3-api-3 250000000 map[com.docker.compose.config-hash:baa6c518a5d0d2ce1a2d38ddcfa206234dfa8023729d82b99b3f7264efaf99b4 com.docker.compose.container-number:3 com.docker.compose.depends_on: com.docker.compose.image:sha256:a1ec572a54fa12c0ab467a444062c9a59e7bc804b20247d743295cee651b6fdc com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.service:api com.docker.compose.version:5.5.1 org.opencontainers.image.version:25.10]", + "/mtusi2026lab3-api-4 250000000 map[com.docker.compose.config-hash:baa6c518a5d0d2ce1a2d38ddcfa206234dfa8023729d82b99b3f7264efaf99b4 com.docker.compose.container-number:4 com.docker.compose.depends_on: com.docker.compose.image:sha256:a1ec572a54fa12c0ab467a444062c9a59e7bc804b20247d743295cee651b6fdc com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.service:api com.docker.compose.version:5.5.1 org.opencontainers.image.version:25.10]", + "/mtusi2026lab3-cache-1 500000000 map[com.docker.compose.config-hash:a7d737a55154622d18c1f35f33d3767c8335e00fb23f230f1afca917e900252d com.docker.compose.container-number:1 com.docker.compose.depends_on: com.docker.compose.image:sha256:32627109abf6f741121096b45c732f758876803efd7b2e1018ebc0350d117119 com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.service:cache com.docker.compose.version:5.5.1 org.opencontainers.image.source:https://github.com/valkey-io/valkey]", + "/mtusi2026lab3-db-1 2000000000 map[com.docker.compose.config-hash:e1447a13d70e0172bc8c2b2b96bd30e491dd7eddbc4f79f3412bd6e987477e84 com.docker.compose.container-number:1 com.docker.compose.depends_on: com.docker.compose.image:sha256:cbf42f0edc946c0bc1b8eeed62403734e1f25dc67a3491455d07a92fdb558b28 com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.replace:db-1 com.docker.compose.service:db com.docker.compose.version:5.5.1]", + "/mtusi2026lab3-lb-1 250000000 map[com.docker.compose.config-hash:8afd1a6fe04af86c6e4c4bc0c6be3e01db2e2c692a325086cc477df1a110aebb com.docker.compose.container-number:1 com.docker.compose.depends_on:api:service_healthy:false com.docker.compose.image:sha256:09ab424a8c788f8d0fe3a64429f6d19dfa526885c8609b748d0943a75dcb9f8c com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.service:lb com.docker.compose.version:5.5.1 maintainer:NGINX Docker Maintainers ]" + ], + "cpu": { + "api": { + "samples": 28, + "mean_cpu_percent": 18.64, + "max_cpu_percent": 27.51 + }, + "db": { + "samples": 7, + "mean_cpu_percent": 124.05, + "max_cpu_percent": 189.16 + }, + "lb": { + "samples": 7, + "mean_cpu_percent": 19.08, + "max_cpu_percent": 26.16 + }, + "cache": { + "samples": 7, + "mean_cpu_percent": 9.49, + "max_cpu_percent": 14.99 + } + }, + "load": { + "lab": 3, + "workload": "closed-loop POST messages; no automatic retries", + "requested_duration_seconds": 30.0, + "elapsed_seconds": 30.347, + "concurrency": 50, + "successful_requests": 9711, + "failed_requests": 0, + "error_ratio": 0.0, + "successful_rps": 320.002, + "successful_latency_ms": { + "p50": 151.294, + "p95": 295.941, + "p99": 407.03 + }, + "note": "Latency percentiles cover successes only. Timeouts/errors are counted separately; closed-loop has coordinated omission and client overhead." + } +} diff --git a/evidence/track1-A-r4-apicpu0.25-dbcpu2.0.load.json b/evidence/track1-A-r4-apicpu0.25-dbcpu2.0.load.json new file mode 100644 index 0000000..c4e6310 --- /dev/null +++ b/evidence/track1-A-r4-apicpu0.25-dbcpu2.0.load.json @@ -0,0 +1,17 @@ +{ + "lab": 3, + "workload": "closed-loop POST messages; no automatic retries", + "requested_duration_seconds": 30.0, + "elapsed_seconds": 30.347, + "concurrency": 50, + "successful_requests": 9711, + "failed_requests": 0, + "error_ratio": 0.0, + "successful_rps": 320.002, + "successful_latency_ms": { + "p50": 151.294, + "p95": 295.941, + "p99": 407.03 + }, + "note": "Latency percentiles cover successes only. Timeouts/errors are counted separately; closed-loop has coordinated omission and client overhead." +} diff --git a/evidence/track1-B-r4-apicpu0.25-dbcpu1.0.json b/evidence/track1-B-r4-apicpu0.25-dbcpu1.0.json new file mode 100644 index 0000000..bf5293e --- /dev/null +++ b/evidence/track1-B-r4-apicpu0.25-dbcpu1.0.json @@ -0,0 +1,57 @@ +{ + "series": "B", + "api_replicas": 4, + "api_cpu_limit": 0.25, + "db_cpu_limit": 1.0, + "pg_pool": 8, + "nginx_worker_processes": "1", + "warmup_seconds": 10, + "inspect": [ + "/mtusi2026lab3-api-1 250000000 map[com.docker.compose.config-hash:baa6c518a5d0d2ce1a2d38ddcfa206234dfa8023729d82b99b3f7264efaf99b4 com.docker.compose.container-number:1 com.docker.compose.depends_on: com.docker.compose.image:sha256:a1ec572a54fa12c0ab467a444062c9a59e7bc804b20247d743295cee651b6fdc com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.replace:api-1 com.docker.compose.service:api com.docker.compose.version:5.5.1 org.opencontainers.image.version:25.10]", + "/mtusi2026lab3-api-2 250000000 map[com.docker.compose.config-hash:baa6c518a5d0d2ce1a2d38ddcfa206234dfa8023729d82b99b3f7264efaf99b4 com.docker.compose.container-number:2 com.docker.compose.depends_on: com.docker.compose.image:sha256:a1ec572a54fa12c0ab467a444062c9a59e7bc804b20247d743295cee651b6fdc com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.replace:api-2 com.docker.compose.service:api com.docker.compose.version:5.5.1 org.opencontainers.image.version:25.10]", + "/mtusi2026lab3-api-3 250000000 map[com.docker.compose.config-hash:baa6c518a5d0d2ce1a2d38ddcfa206234dfa8023729d82b99b3f7264efaf99b4 com.docker.compose.container-number:3 com.docker.compose.depends_on: com.docker.compose.image:sha256:a1ec572a54fa12c0ab467a444062c9a59e7bc804b20247d743295cee651b6fdc com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.replace:api-3 com.docker.compose.service:api com.docker.compose.version:5.5.1 org.opencontainers.image.version:25.10]", + "/mtusi2026lab3-api-4 250000000 map[com.docker.compose.config-hash:baa6c518a5d0d2ce1a2d38ddcfa206234dfa8023729d82b99b3f7264efaf99b4 com.docker.compose.container-number:4 com.docker.compose.depends_on: com.docker.compose.image:sha256:a1ec572a54fa12c0ab467a444062c9a59e7bc804b20247d743295cee651b6fdc com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.replace:api-4 com.docker.compose.service:api com.docker.compose.version:5.5.1 org.opencontainers.image.version:25.10]", + "/mtusi2026lab3-cache-1 500000000 map[com.docker.compose.config-hash:a7d737a55154622d18c1f35f33d3767c8335e00fb23f230f1afca917e900252d com.docker.compose.container-number:1 com.docker.compose.depends_on: com.docker.compose.image:sha256:32627109abf6f741121096b45c732f758876803efd7b2e1018ebc0350d117119 com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.service:cache com.docker.compose.version:5.5.1 org.opencontainers.image.source:https://github.com/valkey-io/valkey]", + "/mtusi2026lab3-db-1 1000000000 map[com.docker.compose.config-hash:5a9910bcb7033eb32e9c8f69ff91ca585ca4927069203321b91d33cdf049f2d2 com.docker.compose.container-number:1 com.docker.compose.depends_on: com.docker.compose.image:sha256:cbf42f0edc946c0bc1b8eeed62403734e1f25dc67a3491455d07a92fdb558b28 com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.replace:db-1 com.docker.compose.service:db com.docker.compose.version:5.5.1]", + "/mtusi2026lab3-lb-1 250000000 map[com.docker.compose.config-hash:8afd1a6fe04af86c6e4c4bc0c6be3e01db2e2c692a325086cc477df1a110aebb com.docker.compose.container-number:1 com.docker.compose.depends_on:api:service_healthy:false com.docker.compose.image:sha256:09ab424a8c788f8d0fe3a64429f6d19dfa526885c8609b748d0943a75dcb9f8c com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.service:lb com.docker.compose.version:5.5.1 maintainer:NGINX Docker Maintainers ]" + ], + "cpu": { + "api": { + "samples": 28, + "mean_cpu_percent": 9.62, + "max_cpu_percent": 14.31 + }, + "db": { + "samples": 7, + "mean_cpu_percent": 73.45, + "max_cpu_percent": 107.26 + }, + "lb": { + "samples": 7, + "mean_cpu_percent": 7.77, + "max_cpu_percent": 11.61 + }, + "cache": { + "samples": 7, + "mean_cpu_percent": 6.37, + "max_cpu_percent": 10.33 + } + }, + "load": { + "lab": 3, + "workload": "closed-loop POST messages; no automatic retries", + "requested_duration_seconds": 30.0, + "elapsed_seconds": 30.313, + "concurrency": 50, + "successful_requests": 5021, + "failed_requests": 0, + "error_ratio": 0.0, + "successful_rps": 165.641, + "successful_latency_ms": { + "p50": 297.372, + "p95": 499.711, + "p99": 598.3 + }, + "note": "Latency percentiles cover successes only. Timeouts/errors are counted separately; closed-loop has coordinated omission and client overhead." + } +} diff --git a/evidence/track1-B-r4-apicpu0.25-dbcpu1.0.load.json b/evidence/track1-B-r4-apicpu0.25-dbcpu1.0.load.json new file mode 100644 index 0000000..0718116 --- /dev/null +++ b/evidence/track1-B-r4-apicpu0.25-dbcpu1.0.load.json @@ -0,0 +1,17 @@ +{ + "lab": 3, + "workload": "closed-loop POST messages; no automatic retries", + "requested_duration_seconds": 30.0, + "elapsed_seconds": 30.313, + "concurrency": 50, + "successful_requests": 5021, + "failed_requests": 0, + "error_ratio": 0.0, + "successful_rps": 165.641, + "successful_latency_ms": { + "p50": 297.372, + "p95": 499.711, + "p99": 598.3 + }, + "note": "Latency percentiles cover successes only. Timeouts/errors are counted separately; closed-loop has coordinated omission and client overhead." +} diff --git a/evidence/track1-B-r4-apicpu0.25-dbcpu2.0.json b/evidence/track1-B-r4-apicpu0.25-dbcpu2.0.json new file mode 100644 index 0000000..751a39d --- /dev/null +++ b/evidence/track1-B-r4-apicpu0.25-dbcpu2.0.json @@ -0,0 +1,57 @@ +{ + "series": "B", + "api_replicas": 4, + "api_cpu_limit": 0.25, + "db_cpu_limit": 2.0, + "pg_pool": 8, + "nginx_worker_processes": "1", + "warmup_seconds": 10, + "inspect": [ + "/mtusi2026lab3-api-1 250000000 map[com.docker.compose.config-hash:baa6c518a5d0d2ce1a2d38ddcfa206234dfa8023729d82b99b3f7264efaf99b4 com.docker.compose.container-number:1 com.docker.compose.depends_on: com.docker.compose.image:sha256:a1ec572a54fa12c0ab467a444062c9a59e7bc804b20247d743295cee651b6fdc com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.replace:api-1 com.docker.compose.service:api com.docker.compose.version:5.5.1 org.opencontainers.image.version:25.10]", + "/mtusi2026lab3-api-2 250000000 map[com.docker.compose.config-hash:baa6c518a5d0d2ce1a2d38ddcfa206234dfa8023729d82b99b3f7264efaf99b4 com.docker.compose.container-number:2 com.docker.compose.depends_on: com.docker.compose.image:sha256:a1ec572a54fa12c0ab467a444062c9a59e7bc804b20247d743295cee651b6fdc com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.replace:api-2 com.docker.compose.service:api com.docker.compose.version:5.5.1 org.opencontainers.image.version:25.10]", + "/mtusi2026lab3-api-3 250000000 map[com.docker.compose.config-hash:baa6c518a5d0d2ce1a2d38ddcfa206234dfa8023729d82b99b3f7264efaf99b4 com.docker.compose.container-number:3 com.docker.compose.depends_on: com.docker.compose.image:sha256:a1ec572a54fa12c0ab467a444062c9a59e7bc804b20247d743295cee651b6fdc com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.replace:api-3 com.docker.compose.service:api com.docker.compose.version:5.5.1 org.opencontainers.image.version:25.10]", + "/mtusi2026lab3-api-4 250000000 map[com.docker.compose.config-hash:baa6c518a5d0d2ce1a2d38ddcfa206234dfa8023729d82b99b3f7264efaf99b4 com.docker.compose.container-number:4 com.docker.compose.depends_on: com.docker.compose.image:sha256:a1ec572a54fa12c0ab467a444062c9a59e7bc804b20247d743295cee651b6fdc com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.replace:api-4 com.docker.compose.service:api com.docker.compose.version:5.5.1 org.opencontainers.image.version:25.10]", + "/mtusi2026lab3-cache-1 500000000 map[com.docker.compose.config-hash:a7d737a55154622d18c1f35f33d3767c8335e00fb23f230f1afca917e900252d com.docker.compose.container-number:1 com.docker.compose.depends_on: com.docker.compose.image:sha256:32627109abf6f741121096b45c732f758876803efd7b2e1018ebc0350d117119 com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.service:cache com.docker.compose.version:5.5.1 org.opencontainers.image.source:https://github.com/valkey-io/valkey]", + "/mtusi2026lab3-db-1 2000000000 map[com.docker.compose.config-hash:e1447a13d70e0172bc8c2b2b96bd30e491dd7eddbc4f79f3412bd6e987477e84 com.docker.compose.container-number:1 com.docker.compose.depends_on: com.docker.compose.image:sha256:cbf42f0edc946c0bc1b8eeed62403734e1f25dc67a3491455d07a92fdb558b28 com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.replace:db-1 com.docker.compose.service:db com.docker.compose.version:5.5.1]", + "/mtusi2026lab3-lb-1 250000000 map[com.docker.compose.config-hash:8afd1a6fe04af86c6e4c4bc0c6be3e01db2e2c692a325086cc477df1a110aebb com.docker.compose.container-number:1 com.docker.compose.depends_on:api:service_healthy:false com.docker.compose.image:sha256:09ab424a8c788f8d0fe3a64429f6d19dfa526885c8609b748d0943a75dcb9f8c com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.service:lb com.docker.compose.version:5.5.1 maintainer:NGINX Docker Maintainers ]" + ], + "cpu": { + "api": { + "samples": 28, + "mean_cpu_percent": 19.77, + "max_cpu_percent": 27.63 + }, + "db": { + "samples": 7, + "mean_cpu_percent": 136.68, + "max_cpu_percent": 206.58 + }, + "lb": { + "samples": 7, + "mean_cpu_percent": 16.56, + "max_cpu_percent": 25.95 + }, + "cache": { + "samples": 7, + "mean_cpu_percent": 5.61, + "max_cpu_percent": 7.95 + } + }, + "load": { + "lab": 3, + "workload": "closed-loop POST messages; no automatic retries", + "requested_duration_seconds": 30.0, + "elapsed_seconds": 30.391, + "concurrency": 50, + "successful_requests": 10082, + "failed_requests": 0, + "error_ratio": 0.0, + "successful_rps": 331.742, + "successful_latency_ms": { + "p50": 112.739, + "p95": 377.522, + "p99": 459.163 + }, + "note": "Latency percentiles cover successes only. Timeouts/errors are counted separately; closed-loop has coordinated omission and client overhead." + } +} diff --git a/evidence/track1-B-r4-apicpu0.25-dbcpu2.0.load.json b/evidence/track1-B-r4-apicpu0.25-dbcpu2.0.load.json new file mode 100644 index 0000000..ac0ef77 --- /dev/null +++ b/evidence/track1-B-r4-apicpu0.25-dbcpu2.0.load.json @@ -0,0 +1,17 @@ +{ + "lab": 3, + "workload": "closed-loop POST messages; no automatic retries", + "requested_duration_seconds": 30.0, + "elapsed_seconds": 30.391, + "concurrency": 50, + "successful_requests": 10082, + "failed_requests": 0, + "error_ratio": 0.0, + "successful_rps": 331.742, + "successful_latency_ms": { + "p50": 112.739, + "p95": 377.522, + "p99": 459.163 + }, + "note": "Latency percentiles cover successes only. Timeouts/errors are counted separately; closed-loop has coordinated omission and client overhead." +} diff --git a/evidence/track1-B-r4-apicpu0.25-dbcpu4.0.json b/evidence/track1-B-r4-apicpu0.25-dbcpu4.0.json new file mode 100644 index 0000000..226f15a --- /dev/null +++ b/evidence/track1-B-r4-apicpu0.25-dbcpu4.0.json @@ -0,0 +1,57 @@ +{ + "series": "B", + "api_replicas": 4, + "api_cpu_limit": 0.25, + "db_cpu_limit": 4.0, + "pg_pool": 8, + "nginx_worker_processes": "1", + "warmup_seconds": 10, + "inspect": [ + "/mtusi2026lab3-api-1 250000000 map[com.docker.compose.config-hash:baa6c518a5d0d2ce1a2d38ddcfa206234dfa8023729d82b99b3f7264efaf99b4 com.docker.compose.container-number:1 com.docker.compose.depends_on: com.docker.compose.image:sha256:a1ec572a54fa12c0ab467a444062c9a59e7bc804b20247d743295cee651b6fdc com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.replace:api-1 com.docker.compose.service:api com.docker.compose.version:5.5.1 org.opencontainers.image.version:25.10]", + "/mtusi2026lab3-api-2 250000000 map[com.docker.compose.config-hash:baa6c518a5d0d2ce1a2d38ddcfa206234dfa8023729d82b99b3f7264efaf99b4 com.docker.compose.container-number:2 com.docker.compose.depends_on: com.docker.compose.image:sha256:a1ec572a54fa12c0ab467a444062c9a59e7bc804b20247d743295cee651b6fdc com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.replace:api-2 com.docker.compose.service:api com.docker.compose.version:5.5.1 org.opencontainers.image.version:25.10]", + "/mtusi2026lab3-api-3 250000000 map[com.docker.compose.config-hash:baa6c518a5d0d2ce1a2d38ddcfa206234dfa8023729d82b99b3f7264efaf99b4 com.docker.compose.container-number:3 com.docker.compose.depends_on: com.docker.compose.image:sha256:a1ec572a54fa12c0ab467a444062c9a59e7bc804b20247d743295cee651b6fdc com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.replace:api-3 com.docker.compose.service:api com.docker.compose.version:5.5.1 org.opencontainers.image.version:25.10]", + "/mtusi2026lab3-api-4 250000000 map[com.docker.compose.config-hash:baa6c518a5d0d2ce1a2d38ddcfa206234dfa8023729d82b99b3f7264efaf99b4 com.docker.compose.container-number:4 com.docker.compose.depends_on: com.docker.compose.image:sha256:a1ec572a54fa12c0ab467a444062c9a59e7bc804b20247d743295cee651b6fdc com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.replace:api-4 com.docker.compose.service:api com.docker.compose.version:5.5.1 org.opencontainers.image.version:25.10]", + "/mtusi2026lab3-cache-1 500000000 map[com.docker.compose.config-hash:a7d737a55154622d18c1f35f33d3767c8335e00fb23f230f1afca917e900252d com.docker.compose.container-number:1 com.docker.compose.depends_on: com.docker.compose.image:sha256:32627109abf6f741121096b45c732f758876803efd7b2e1018ebc0350d117119 com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.service:cache com.docker.compose.version:5.5.1 org.opencontainers.image.source:https://github.com/valkey-io/valkey]", + "/mtusi2026lab3-db-1 4000000000 map[com.docker.compose.config-hash:00262326412a2d2388e383afd1f1c5d3453baeebf2e459788f9a579b8340f994 com.docker.compose.container-number:1 com.docker.compose.depends_on: com.docker.compose.image:sha256:cbf42f0edc946c0bc1b8eeed62403734e1f25dc67a3491455d07a92fdb558b28 com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.replace:db-1 com.docker.compose.service:db com.docker.compose.version:5.5.1]", + "/mtusi2026lab3-lb-1 250000000 map[com.docker.compose.config-hash:8afd1a6fe04af86c6e4c4bc0c6be3e01db2e2c692a325086cc477df1a110aebb com.docker.compose.container-number:1 com.docker.compose.depends_on:api:service_healthy:false com.docker.compose.image:sha256:09ab424a8c788f8d0fe3a64429f6d19dfa526885c8609b748d0943a75dcb9f8c com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.service:lb com.docker.compose.version:5.5.1 maintainer:NGINX Docker Maintainers ]" + ], + "cpu": { + "api": { + "samples": 28, + "mean_cpu_percent": 19.49, + "max_cpu_percent": 27.41 + }, + "db": { + "samples": 7, + "mean_cpu_percent": 141.25, + "max_cpu_percent": 241.9 + }, + "lb": { + "samples": 7, + "mean_cpu_percent": 16.49, + "max_cpu_percent": 26.16 + }, + "cache": { + "samples": 7, + "mean_cpu_percent": 6.55, + "max_cpu_percent": 8.51 + } + }, + "load": { + "lab": 3, + "workload": "closed-loop POST messages; no automatic retries", + "requested_duration_seconds": 30.0, + "elapsed_seconds": 30.223, + "concurrency": 50, + "successful_requests": 12619, + "failed_requests": 0, + "error_ratio": 0.0, + "successful_rps": 417.528, + "successful_latency_ms": { + "p50": 99.961, + "p95": 288.263, + "p99": 371.702 + }, + "note": "Latency percentiles cover successes only. Timeouts/errors are counted separately; closed-loop has coordinated omission and client overhead." + } +} diff --git a/evidence/track1-B-r4-apicpu0.25-dbcpu4.0.load.json b/evidence/track1-B-r4-apicpu0.25-dbcpu4.0.load.json new file mode 100644 index 0000000..821c5a9 --- /dev/null +++ b/evidence/track1-B-r4-apicpu0.25-dbcpu4.0.load.json @@ -0,0 +1,17 @@ +{ + "lab": 3, + "workload": "closed-loop POST messages; no automatic retries", + "requested_duration_seconds": 30.0, + "elapsed_seconds": 30.223, + "concurrency": 50, + "successful_requests": 12619, + "failed_requests": 0, + "error_ratio": 0.0, + "successful_rps": 417.528, + "successful_latency_ms": { + "p50": 99.961, + "p95": 288.263, + "p99": 371.702 + }, + "note": "Latency percentiles cover successes only. Timeouts/errors are counted separately; closed-loop has coordinated omission and client overhead." +} diff --git a/evidence/track1-C-r4-apicpu0.25-dbcpu4.0.json b/evidence/track1-C-r4-apicpu0.25-dbcpu4.0.json new file mode 100644 index 0000000..458173f --- /dev/null +++ b/evidence/track1-C-r4-apicpu0.25-dbcpu4.0.json @@ -0,0 +1,57 @@ +{ + "series": "C", + "api_replicas": 4, + "api_cpu_limit": 0.25, + "db_cpu_limit": 4.0, + "pg_pool": 32, + "nginx_worker_processes": "auto", + "warmup_seconds": 10, + "inspect": [ + "/mtusi2026lab3-api-1 250000000 map[com.docker.compose.config-hash:baa6c518a5d0d2ce1a2d38ddcfa206234dfa8023729d82b99b3f7264efaf99b4 com.docker.compose.container-number:1 com.docker.compose.depends_on: com.docker.compose.image:sha256:4f45fcaea2d11a10950043c988f2a695fd303df9eb5fb23b59b4c1a0649d3e01 com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.replace:api-1 com.docker.compose.service:api com.docker.compose.version:5.5.1 org.opencontainers.image.version:25.10]", + "/mtusi2026lab3-api-2 250000000 map[com.docker.compose.config-hash:baa6c518a5d0d2ce1a2d38ddcfa206234dfa8023729d82b99b3f7264efaf99b4 com.docker.compose.container-number:2 com.docker.compose.depends_on: com.docker.compose.image:sha256:4f45fcaea2d11a10950043c988f2a695fd303df9eb5fb23b59b4c1a0649d3e01 com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.replace:api-2 com.docker.compose.service:api com.docker.compose.version:5.5.1 org.opencontainers.image.version:25.10]", + "/mtusi2026lab3-api-3 250000000 map[com.docker.compose.config-hash:baa6c518a5d0d2ce1a2d38ddcfa206234dfa8023729d82b99b3f7264efaf99b4 com.docker.compose.container-number:3 com.docker.compose.depends_on: com.docker.compose.image:sha256:4f45fcaea2d11a10950043c988f2a695fd303df9eb5fb23b59b4c1a0649d3e01 com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.replace:api-3 com.docker.compose.service:api com.docker.compose.version:5.5.1 org.opencontainers.image.version:25.10]", + "/mtusi2026lab3-api-4 250000000 map[com.docker.compose.config-hash:baa6c518a5d0d2ce1a2d38ddcfa206234dfa8023729d82b99b3f7264efaf99b4 com.docker.compose.container-number:4 com.docker.compose.depends_on: com.docker.compose.image:sha256:4f45fcaea2d11a10950043c988f2a695fd303df9eb5fb23b59b4c1a0649d3e01 com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.replace:api-4 com.docker.compose.service:api com.docker.compose.version:5.5.1 org.opencontainers.image.version:25.10]", + "/mtusi2026lab3-cache-1 500000000 map[com.docker.compose.config-hash:a7d737a55154622d18c1f35f33d3767c8335e00fb23f230f1afca917e900252d com.docker.compose.container-number:1 com.docker.compose.depends_on: com.docker.compose.image:sha256:32627109abf6f741121096b45c732f758876803efd7b2e1018ebc0350d117119 com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.service:cache com.docker.compose.version:5.5.1 org.opencontainers.image.source:https://github.com/valkey-io/valkey]", + "/mtusi2026lab3-db-1 4000000000 map[com.docker.compose.config-hash:00262326412a2d2388e383afd1f1c5d3453baeebf2e459788f9a579b8340f994 com.docker.compose.container-number:1 com.docker.compose.depends_on: com.docker.compose.image:sha256:cbf42f0edc946c0bc1b8eeed62403734e1f25dc67a3491455d07a92fdb558b28 com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.replace:db-1 com.docker.compose.service:db com.docker.compose.version:5.5.1]", + "/mtusi2026lab3-lb-1 2000000000 map[com.docker.compose.config-hash:ee74ad04250c4d0cecb5a9de33f8114c96c67a0f78b3ffe89a116b43dcd81889 com.docker.compose.container-number:1 com.docker.compose.depends_on: com.docker.compose.image:sha256:09ab424a8c788f8d0fe3a64429f6d19dfa526885c8609b748d0943a75dcb9f8c com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.replace:lb-1 com.docker.compose.service:lb com.docker.compose.version:5.5.1 maintainer:NGINX Docker Maintainers ]" + ], + "cpu": { + "lb": { + "samples": 7, + "mean_cpu_percent": 20.96, + "max_cpu_percent": 31.95 + }, + "api": { + "samples": 28, + "mean_cpu_percent": 18.62, + "max_cpu_percent": 28.28 + }, + "db": { + "samples": 7, + "mean_cpu_percent": 126.42, + "max_cpu_percent": 194.27 + }, + "cache": { + "samples": 7, + "mean_cpu_percent": 7.12, + "max_cpu_percent": 14.51 + } + }, + "load": { + "lab": 3, + "workload": "closed-loop POST messages; no automatic retries", + "requested_duration_seconds": 30.0, + "elapsed_seconds": 30.67, + "concurrency": 50, + "successful_requests": 10324, + "failed_requests": 0, + "error_ratio": 0.0, + "successful_rps": 336.611, + "successful_latency_ms": { + "p50": 63.068, + "p95": 484.84, + "p99": 646.969 + }, + "note": "Latency percentiles cover successes only. Timeouts/errors are counted separately; closed-loop has coordinated omission and client overhead." + } +} diff --git a/evidence/track1-C-r4-apicpu0.25-dbcpu4.0.load.json b/evidence/track1-C-r4-apicpu0.25-dbcpu4.0.load.json new file mode 100644 index 0000000..7ca51b4 --- /dev/null +++ b/evidence/track1-C-r4-apicpu0.25-dbcpu4.0.load.json @@ -0,0 +1,17 @@ +{ + "lab": 3, + "workload": "closed-loop POST messages; no automatic retries", + "requested_duration_seconds": 30.0, + "elapsed_seconds": 30.67, + "concurrency": 50, + "successful_requests": 10324, + "failed_requests": 0, + "error_ratio": 0.0, + "successful_rps": 336.611, + "successful_latency_ms": { + "p50": 63.068, + "p95": 484.84, + "p99": 646.969 + }, + "note": "Latency percentiles cover successes only. Timeouts/errors are counted separately; closed-loop has coordinated omission and client overhead." +} diff --git a/evidence/track1-L-r4-apicpu0.25-dbcpu4.0.json b/evidence/track1-L-r4-apicpu0.25-dbcpu4.0.json new file mode 100644 index 0000000..11164f3 --- /dev/null +++ b/evidence/track1-L-r4-apicpu0.25-dbcpu4.0.json @@ -0,0 +1,57 @@ +{ + "series": "L", + "api_replicas": 4, + "api_cpu_limit": 0.25, + "db_cpu_limit": 4.0, + "pg_pool": 32, + "nginx_worker_processes": "1", + "warmup_seconds": 10, + "inspect": [ + "/mtusi2026lab3-api-1 250000000 map[com.docker.compose.config-hash:baa6c518a5d0d2ce1a2d38ddcfa206234dfa8023729d82b99b3f7264efaf99b4 com.docker.compose.container-number:1 com.docker.compose.depends_on: com.docker.compose.image:sha256:4f45fcaea2d11a10950043c988f2a695fd303df9eb5fb23b59b4c1a0649d3e01 com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.replace:api-1 com.docker.compose.service:api com.docker.compose.version:5.5.1 org.opencontainers.image.version:25.10]", + "/mtusi2026lab3-api-2 250000000 map[com.docker.compose.config-hash:baa6c518a5d0d2ce1a2d38ddcfa206234dfa8023729d82b99b3f7264efaf99b4 com.docker.compose.container-number:2 com.docker.compose.depends_on: com.docker.compose.image:sha256:4f45fcaea2d11a10950043c988f2a695fd303df9eb5fb23b59b4c1a0649d3e01 com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.replace:api-2 com.docker.compose.service:api com.docker.compose.version:5.5.1 org.opencontainers.image.version:25.10]", + "/mtusi2026lab3-api-3 250000000 map[com.docker.compose.config-hash:baa6c518a5d0d2ce1a2d38ddcfa206234dfa8023729d82b99b3f7264efaf99b4 com.docker.compose.container-number:3 com.docker.compose.depends_on: com.docker.compose.image:sha256:4f45fcaea2d11a10950043c988f2a695fd303df9eb5fb23b59b4c1a0649d3e01 com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.replace:api-3 com.docker.compose.service:api com.docker.compose.version:5.5.1 org.opencontainers.image.version:25.10]", + "/mtusi2026lab3-api-4 250000000 map[com.docker.compose.config-hash:baa6c518a5d0d2ce1a2d38ddcfa206234dfa8023729d82b99b3f7264efaf99b4 com.docker.compose.container-number:4 com.docker.compose.depends_on: com.docker.compose.image:sha256:4f45fcaea2d11a10950043c988f2a695fd303df9eb5fb23b59b4c1a0649d3e01 com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.replace:api-4 com.docker.compose.service:api com.docker.compose.version:5.5.1 org.opencontainers.image.version:25.10]", + "/mtusi2026lab3-cache-1 500000000 map[com.docker.compose.config-hash:a7d737a55154622d18c1f35f33d3767c8335e00fb23f230f1afca917e900252d com.docker.compose.container-number:1 com.docker.compose.depends_on: com.docker.compose.image:sha256:32627109abf6f741121096b45c732f758876803efd7b2e1018ebc0350d117119 com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.service:cache com.docker.compose.version:5.5.1 org.opencontainers.image.source:https://github.com/valkey-io/valkey]", + "/mtusi2026lab3-db-1 4000000000 map[com.docker.compose.config-hash:00262326412a2d2388e383afd1f1c5d3453baeebf2e459788f9a579b8340f994 com.docker.compose.container-number:1 com.docker.compose.depends_on: com.docker.compose.image:sha256:cbf42f0edc946c0bc1b8eeed62403734e1f25dc67a3491455d07a92fdb558b28 com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.replace:db-1 com.docker.compose.service:db com.docker.compose.version:5.5.1]", + "/mtusi2026lab3-lb-1 2000000000 map[com.docker.compose.config-hash:ee74ad04250c4d0cecb5a9de33f8114c96c67a0f78b3ffe89a116b43dcd81889 com.docker.compose.container-number:1 com.docker.compose.depends_on: com.docker.compose.image:sha256:09ab424a8c788f8d0fe3a64429f6d19dfa526885c8609b748d0943a75dcb9f8c com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.replace:lb-1 com.docker.compose.service:lb com.docker.compose.version:5.5.1 maintainer:NGINX Docker Maintainers ]" + ], + "cpu": { + "api": { + "samples": 28, + "mean_cpu_percent": 20.7, + "max_cpu_percent": 28.12 + }, + "db": { + "samples": 7, + "mean_cpu_percent": 144.54, + "max_cpu_percent": 213.13 + }, + "lb": { + "samples": 7, + "mean_cpu_percent": 20.99, + "max_cpu_percent": 32.27 + }, + "cache": { + "samples": 7, + "mean_cpu_percent": 10.94, + "max_cpu_percent": 15.58 + } + }, + "load": { + "lab": 3, + "workload": "closed-loop POST messages; no automatic retries", + "requested_duration_seconds": 30.0, + "elapsed_seconds": 30.397, + "concurrency": 50, + "successful_requests": 10394, + "failed_requests": 0, + "error_ratio": 0.0, + "successful_rps": 341.943, + "successful_latency_ms": { + "p50": 102.179, + "p95": 395.06, + "p99": 469.992 + }, + "note": "Latency percentiles cover successes only. Timeouts/errors are counted separately; closed-loop has coordinated omission and client overhead." + } +} diff --git a/evidence/track1-L-r4-apicpu0.25-dbcpu4.0.load.json b/evidence/track1-L-r4-apicpu0.25-dbcpu4.0.load.json new file mode 100644 index 0000000..80428de --- /dev/null +++ b/evidence/track1-L-r4-apicpu0.25-dbcpu4.0.load.json @@ -0,0 +1,17 @@ +{ + "lab": 3, + "workload": "closed-loop POST messages; no automatic retries", + "requested_duration_seconds": 30.0, + "elapsed_seconds": 30.397, + "concurrency": 50, + "successful_requests": 10394, + "failed_requests": 0, + "error_ratio": 0.0, + "successful_rps": 341.943, + "successful_latency_ms": { + "p50": 102.179, + "p95": 395.06, + "p99": 469.992 + }, + "note": "Latency percentiles cover successes only. Timeouts/errors are counted separately; closed-loop has coordinated omission and client overhead." +} diff --git a/evidence/track1-M-r4-apicpu0.25-dbcpu4.0.json b/evidence/track1-M-r4-apicpu0.25-dbcpu4.0.json new file mode 100644 index 0000000..1fab218 --- /dev/null +++ b/evidence/track1-M-r4-apicpu0.25-dbcpu4.0.json @@ -0,0 +1,57 @@ +{ + "series": "M", + "api_replicas": 4, + "api_cpu_limit": 0.25, + "db_cpu_limit": 4.0, + "pg_pool": 8, + "nginx_worker_processes": "1", + "warmup_seconds": 10, + "inspect": [ + "/mtusi2026lab3-api-1 250000000 map[com.docker.compose.config-hash:baa6c518a5d0d2ce1a2d38ddcfa206234dfa8023729d82b99b3f7264efaf99b4 com.docker.compose.container-number:1 com.docker.compose.depends_on: com.docker.compose.image:sha256:a1ec572a54fa12c0ab467a444062c9a59e7bc804b20247d743295cee651b6fdc com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.replace:api-1 com.docker.compose.service:api com.docker.compose.version:5.5.1 org.opencontainers.image.version:25.10]", + "/mtusi2026lab3-api-2 250000000 map[com.docker.compose.config-hash:baa6c518a5d0d2ce1a2d38ddcfa206234dfa8023729d82b99b3f7264efaf99b4 com.docker.compose.container-number:2 com.docker.compose.depends_on: com.docker.compose.image:sha256:a1ec572a54fa12c0ab467a444062c9a59e7bc804b20247d743295cee651b6fdc com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.replace:api-2 com.docker.compose.service:api com.docker.compose.version:5.5.1 org.opencontainers.image.version:25.10]", + "/mtusi2026lab3-api-3 250000000 map[com.docker.compose.config-hash:baa6c518a5d0d2ce1a2d38ddcfa206234dfa8023729d82b99b3f7264efaf99b4 com.docker.compose.container-number:3 com.docker.compose.depends_on: com.docker.compose.image:sha256:a1ec572a54fa12c0ab467a444062c9a59e7bc804b20247d743295cee651b6fdc com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.replace:api-3 com.docker.compose.service:api com.docker.compose.version:5.5.1 org.opencontainers.image.version:25.10]", + "/mtusi2026lab3-api-4 250000000 map[com.docker.compose.config-hash:baa6c518a5d0d2ce1a2d38ddcfa206234dfa8023729d82b99b3f7264efaf99b4 com.docker.compose.container-number:4 com.docker.compose.depends_on: com.docker.compose.image:sha256:a1ec572a54fa12c0ab467a444062c9a59e7bc804b20247d743295cee651b6fdc com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.replace:api-4 com.docker.compose.service:api com.docker.compose.version:5.5.1 org.opencontainers.image.version:25.10]", + "/mtusi2026lab3-cache-1 500000000 map[com.docker.compose.config-hash:a7d737a55154622d18c1f35f33d3767c8335e00fb23f230f1afca917e900252d com.docker.compose.container-number:1 com.docker.compose.depends_on: com.docker.compose.image:sha256:32627109abf6f741121096b45c732f758876803efd7b2e1018ebc0350d117119 com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.service:cache com.docker.compose.version:5.5.1 org.opencontainers.image.source:https://github.com/valkey-io/valkey]", + "/mtusi2026lab3-db-1 4000000000 map[com.docker.compose.config-hash:00262326412a2d2388e383afd1f1c5d3453baeebf2e459788f9a579b8340f994 com.docker.compose.container-number:1 com.docker.compose.depends_on: com.docker.compose.image:sha256:cbf42f0edc946c0bc1b8eeed62403734e1f25dc67a3491455d07a92fdb558b28 com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.replace:db-1 com.docker.compose.service:db com.docker.compose.version:5.5.1]", + "/mtusi2026lab3-lb-1 2000000000 map[com.docker.compose.config-hash:ee74ad04250c4d0cecb5a9de33f8114c96c67a0f78b3ffe89a116b43dcd81889 com.docker.compose.container-number:1 com.docker.compose.depends_on: com.docker.compose.image:sha256:09ab424a8c788f8d0fe3a64429f6d19dfa526885c8609b748d0943a75dcb9f8c com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.replace:lb-1 com.docker.compose.service:lb com.docker.compose.version:5.5.1 maintainer:NGINX Docker Maintainers ]" + ], + "cpu": { + "api": { + "samples": 28, + "mean_cpu_percent": 18.97, + "max_cpu_percent": 26.66 + }, + "db": { + "samples": 7, + "mean_cpu_percent": 122.03, + "max_cpu_percent": 207.51 + }, + "lb": { + "samples": 7, + "mean_cpu_percent": 23.57, + "max_cpu_percent": 37.27 + }, + "cache": { + "samples": 7, + "mean_cpu_percent": 7.21, + "max_cpu_percent": 8.48 + } + }, + "load": { + "lab": 3, + "workload": "closed-loop POST messages; no automatic retries", + "requested_duration_seconds": 30.0, + "elapsed_seconds": 30.564, + "concurrency": 50, + "successful_requests": 10770, + "failed_requests": 0, + "error_ratio": 0.0, + "successful_rps": 352.371, + "successful_latency_ms": { + "p50": 61.017, + "p95": 464.208, + "p99": 548.228 + }, + "note": "Latency percentiles cover successes only. Timeouts/errors are counted separately; closed-loop has coordinated omission and client overhead." + } +} diff --git a/evidence/track1-M-r4-apicpu0.25-dbcpu4.0.load.json b/evidence/track1-M-r4-apicpu0.25-dbcpu4.0.load.json new file mode 100644 index 0000000..6dc5e40 --- /dev/null +++ b/evidence/track1-M-r4-apicpu0.25-dbcpu4.0.load.json @@ -0,0 +1,17 @@ +{ + "lab": 3, + "workload": "closed-loop POST messages; no automatic retries", + "requested_duration_seconds": 30.0, + "elapsed_seconds": 30.564, + "concurrency": 50, + "successful_requests": 10770, + "failed_requests": 0, + "error_ratio": 0.0, + "successful_rps": 352.371, + "successful_latency_ms": { + "p50": 61.017, + "p95": 464.208, + "p99": 548.228 + }, + "note": "Latency percentiles cover successes only. Timeouts/errors are counted separately; closed-loop has coordinated omission and client overhead." +} diff --git a/evidence/track1-P-r4-apicpu0.25-dbcpu4.0.json b/evidence/track1-P-r4-apicpu0.25-dbcpu4.0.json new file mode 100644 index 0000000..d0f397b --- /dev/null +++ b/evidence/track1-P-r4-apicpu0.25-dbcpu4.0.json @@ -0,0 +1,57 @@ +{ + "series": "P", + "api_replicas": 4, + "api_cpu_limit": 0.25, + "db_cpu_limit": 4.0, + "pg_pool": 32, + "nginx_worker_processes": "auto", + "warmup_seconds": 10, + "inspect": [ + "/mtusi2026lab3-api-1 250000000 map[com.docker.compose.config-hash:baa6c518a5d0d2ce1a2d38ddcfa206234dfa8023729d82b99b3f7264efaf99b4 com.docker.compose.container-number:1 com.docker.compose.depends_on: com.docker.compose.image:sha256:4f45fcaea2d11a10950043c988f2a695fd303df9eb5fb23b59b4c1a0649d3e01 com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.replace:api-1 com.docker.compose.service:api com.docker.compose.version:5.5.1 org.opencontainers.image.version:25.10]", + "/mtusi2026lab3-api-2 250000000 map[com.docker.compose.config-hash:baa6c518a5d0d2ce1a2d38ddcfa206234dfa8023729d82b99b3f7264efaf99b4 com.docker.compose.container-number:2 com.docker.compose.depends_on: com.docker.compose.image:sha256:4f45fcaea2d11a10950043c988f2a695fd303df9eb5fb23b59b4c1a0649d3e01 com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.replace:api-2 com.docker.compose.service:api com.docker.compose.version:5.5.1 org.opencontainers.image.version:25.10]", + "/mtusi2026lab3-api-3 250000000 map[com.docker.compose.config-hash:baa6c518a5d0d2ce1a2d38ddcfa206234dfa8023729d82b99b3f7264efaf99b4 com.docker.compose.container-number:3 com.docker.compose.depends_on: com.docker.compose.image:sha256:4f45fcaea2d11a10950043c988f2a695fd303df9eb5fb23b59b4c1a0649d3e01 com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.replace:api-3 com.docker.compose.service:api com.docker.compose.version:5.5.1 org.opencontainers.image.version:25.10]", + "/mtusi2026lab3-api-4 250000000 map[com.docker.compose.config-hash:baa6c518a5d0d2ce1a2d38ddcfa206234dfa8023729d82b99b3f7264efaf99b4 com.docker.compose.container-number:4 com.docker.compose.depends_on: com.docker.compose.image:sha256:4f45fcaea2d11a10950043c988f2a695fd303df9eb5fb23b59b4c1a0649d3e01 com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.replace:api-4 com.docker.compose.service:api com.docker.compose.version:5.5.1 org.opencontainers.image.version:25.10]", + "/mtusi2026lab3-cache-1 500000000 map[com.docker.compose.config-hash:a7d737a55154622d18c1f35f33d3767c8335e00fb23f230f1afca917e900252d com.docker.compose.container-number:1 com.docker.compose.depends_on: com.docker.compose.image:sha256:32627109abf6f741121096b45c732f758876803efd7b2e1018ebc0350d117119 com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.service:cache com.docker.compose.version:5.5.1 org.opencontainers.image.source:https://github.com/valkey-io/valkey]", + "/mtusi2026lab3-db-1 4000000000 map[com.docker.compose.config-hash:00262326412a2d2388e383afd1f1c5d3453baeebf2e459788f9a579b8340f994 com.docker.compose.container-number:1 com.docker.compose.depends_on: com.docker.compose.image:sha256:cbf42f0edc946c0bc1b8eeed62403734e1f25dc67a3491455d07a92fdb558b28 com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.replace:db-1 com.docker.compose.service:db com.docker.compose.version:5.5.1]", + "/mtusi2026lab3-lb-1 250000000 map[com.docker.compose.config-hash:8afd1a6fe04af86c6e4c4bc0c6be3e01db2e2c692a325086cc477df1a110aebb com.docker.compose.container-number:1 com.docker.compose.depends_on: com.docker.compose.image:sha256:09ab424a8c788f8d0fe3a64429f6d19dfa526885c8609b748d0943a75dcb9f8c com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.replace:lb-1 com.docker.compose.service:lb com.docker.compose.version:5.5.1 maintainer:NGINX Docker Maintainers ]" + ], + "cpu": { + "api": { + "samples": 28, + "mean_cpu_percent": 19.25, + "max_cpu_percent": 28.2 + }, + "db": { + "samples": 7, + "mean_cpu_percent": 130.03, + "max_cpu_percent": 203.72 + }, + "lb": { + "samples": 7, + "mean_cpu_percent": 16.92, + "max_cpu_percent": 26.19 + }, + "cache": { + "samples": 7, + "mean_cpu_percent": 10.12, + "max_cpu_percent": 16.62 + } + }, + "load": { + "lab": 3, + "workload": "closed-loop POST messages; no automatic retries", + "requested_duration_seconds": 30.0, + "elapsed_seconds": 30.254, + "concurrency": 50, + "successful_requests": 10590, + "failed_requests": 0, + "error_ratio": 0.0, + "successful_rps": 350.038, + "successful_latency_ms": { + "p50": 120.943, + "p95": 334.087, + "p99": 396.982 + }, + "note": "Latency percentiles cover successes only. Timeouts/errors are counted separately; closed-loop has coordinated omission and client overhead." + } +} diff --git a/evidence/track1-P-r4-apicpu0.25-dbcpu4.0.load.json b/evidence/track1-P-r4-apicpu0.25-dbcpu4.0.load.json new file mode 100644 index 0000000..bcebbd6 --- /dev/null +++ b/evidence/track1-P-r4-apicpu0.25-dbcpu4.0.load.json @@ -0,0 +1,17 @@ +{ + "lab": 3, + "workload": "closed-loop POST messages; no automatic retries", + "requested_duration_seconds": 30.0, + "elapsed_seconds": 30.254, + "concurrency": 50, + "successful_requests": 10590, + "failed_requests": 0, + "error_ratio": 0.0, + "successful_rps": 350.038, + "successful_latency_ms": { + "p50": 120.943, + "p95": 334.087, + "p99": 396.982 + }, + "note": "Latency percentiles cover successes only. Timeouts/errors are counted separately; closed-loop has coordinated omission and client overhead." +} diff --git a/evidence/track1-R-r4-apicpu0.25-dbcpu4.0.json b/evidence/track1-R-r4-apicpu0.25-dbcpu4.0.json new file mode 100644 index 0000000..9d9ddf4 --- /dev/null +++ b/evidence/track1-R-r4-apicpu0.25-dbcpu4.0.json @@ -0,0 +1,57 @@ +{ + "series": "R", + "api_replicas": 4, + "api_cpu_limit": 0.25, + "db_cpu_limit": 4.0, + "pg_pool": 8, + "nginx_worker_processes": "1", + "warmup_seconds": 10, + "inspect": [ + "/mtusi2026lab3-api-1 250000000 map[com.docker.compose.config-hash:baa6c518a5d0d2ce1a2d38ddcfa206234dfa8023729d82b99b3f7264efaf99b4 com.docker.compose.container-number:1 com.docker.compose.depends_on: com.docker.compose.image:sha256:a1ec572a54fa12c0ab467a444062c9a59e7bc804b20247d743295cee651b6fdc com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.replace:api-1 com.docker.compose.service:api com.docker.compose.version:5.5.1 org.opencontainers.image.version:25.10]", + "/mtusi2026lab3-api-2 250000000 map[com.docker.compose.config-hash:baa6c518a5d0d2ce1a2d38ddcfa206234dfa8023729d82b99b3f7264efaf99b4 com.docker.compose.container-number:2 com.docker.compose.depends_on: com.docker.compose.image:sha256:a1ec572a54fa12c0ab467a444062c9a59e7bc804b20247d743295cee651b6fdc com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.replace:api-2 com.docker.compose.service:api com.docker.compose.version:5.5.1 org.opencontainers.image.version:25.10]", + "/mtusi2026lab3-api-3 250000000 map[com.docker.compose.config-hash:baa6c518a5d0d2ce1a2d38ddcfa206234dfa8023729d82b99b3f7264efaf99b4 com.docker.compose.container-number:3 com.docker.compose.depends_on: com.docker.compose.image:sha256:a1ec572a54fa12c0ab467a444062c9a59e7bc804b20247d743295cee651b6fdc com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.replace:api-3 com.docker.compose.service:api com.docker.compose.version:5.5.1 org.opencontainers.image.version:25.10]", + "/mtusi2026lab3-api-4 250000000 map[com.docker.compose.config-hash:baa6c518a5d0d2ce1a2d38ddcfa206234dfa8023729d82b99b3f7264efaf99b4 com.docker.compose.container-number:4 com.docker.compose.depends_on: com.docker.compose.image:sha256:a1ec572a54fa12c0ab467a444062c9a59e7bc804b20247d743295cee651b6fdc com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.replace:api-4 com.docker.compose.service:api com.docker.compose.version:5.5.1 org.opencontainers.image.version:25.10]", + "/mtusi2026lab3-cache-1 500000000 map[com.docker.compose.config-hash:a7d737a55154622d18c1f35f33d3767c8335e00fb23f230f1afca917e900252d com.docker.compose.container-number:1 com.docker.compose.depends_on: com.docker.compose.image:sha256:32627109abf6f741121096b45c732f758876803efd7b2e1018ebc0350d117119 com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.service:cache com.docker.compose.version:5.5.1 org.opencontainers.image.source:https://github.com/valkey-io/valkey]", + "/mtusi2026lab3-db-1 4000000000 map[com.docker.compose.config-hash:00262326412a2d2388e383afd1f1c5d3453baeebf2e459788f9a579b8340f994 com.docker.compose.container-number:1 com.docker.compose.depends_on: com.docker.compose.image:sha256:cbf42f0edc946c0bc1b8eeed62403734e1f25dc67a3491455d07a92fdb558b28 com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.replace:db-1 com.docker.compose.service:db com.docker.compose.version:5.5.1]", + "/mtusi2026lab3-lb-1 250000000 map[com.docker.compose.config-hash:8afd1a6fe04af86c6e4c4bc0c6be3e01db2e2c692a325086cc477df1a110aebb com.docker.compose.container-number:1 com.docker.compose.depends_on: com.docker.compose.image:sha256:09ab424a8c788f8d0fe3a64429f6d19dfa526885c8609b748d0943a75dcb9f8c com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.replace:lb-1 com.docker.compose.service:lb com.docker.compose.version:5.5.1 maintainer:NGINX Docker Maintainers ]" + ], + "cpu": { + "lb": { + "samples": 7, + "mean_cpu_percent": 16.95, + "max_cpu_percent": 25.67 + }, + "api": { + "samples": 28, + "mean_cpu_percent": 19.34, + "max_cpu_percent": 28.21 + }, + "db": { + "samples": 7, + "mean_cpu_percent": 131.5, + "max_cpu_percent": 199.27 + }, + "cache": { + "samples": 7, + "mean_cpu_percent": 6.82, + "max_cpu_percent": 8.9 + } + }, + "load": { + "lab": 3, + "workload": "closed-loop POST messages; no automatic retries", + "requested_duration_seconds": 30.0, + "elapsed_seconds": 30.382, + "concurrency": 50, + "successful_requests": 10477, + "failed_requests": 0, + "error_ratio": 0.0, + "successful_rps": 344.846, + "successful_latency_ms": { + "p50": 129.553, + "p95": 307.781, + "p99": 397.828 + }, + "note": "Latency percentiles cover successes only. Timeouts/errors are counted separately; closed-loop has coordinated omission and client overhead." + } +} diff --git a/evidence/track1-R-r4-apicpu0.25-dbcpu4.0.load.json b/evidence/track1-R-r4-apicpu0.25-dbcpu4.0.load.json new file mode 100644 index 0000000..4c4b126 --- /dev/null +++ b/evidence/track1-R-r4-apicpu0.25-dbcpu4.0.load.json @@ -0,0 +1,17 @@ +{ + "lab": 3, + "workload": "closed-loop POST messages; no automatic retries", + "requested_duration_seconds": 30.0, + "elapsed_seconds": 30.382, + "concurrency": 50, + "successful_requests": 10477, + "failed_requests": 0, + "error_ratio": 0.0, + "successful_rps": 344.846, + "successful_latency_ms": { + "p50": 129.553, + "p95": 307.781, + "p99": 397.828 + }, + "note": "Latency percentiles cover successes only. Timeouts/errors are counted separately; closed-loop has coordinated omission and client overhead." +} diff --git a/evidence/track1-W-r4-apicpu0.25-dbcpu4.0.json b/evidence/track1-W-r4-apicpu0.25-dbcpu4.0.json new file mode 100644 index 0000000..9c3d5a9 --- /dev/null +++ b/evidence/track1-W-r4-apicpu0.25-dbcpu4.0.json @@ -0,0 +1,57 @@ +{ + "series": "W", + "api_replicas": 4, + "api_cpu_limit": 0.25, + "db_cpu_limit": 4.0, + "pg_pool": 32, + "nginx_worker_processes": "auto", + "warmup_seconds": 10, + "inspect": [ + "/mtusi2026lab3-api-1 250000000 map[com.docker.compose.config-hash:baa6c518a5d0d2ce1a2d38ddcfa206234dfa8023729d82b99b3f7264efaf99b4 com.docker.compose.container-number:1 com.docker.compose.depends_on: com.docker.compose.image:sha256:d988ea1050459c3d472f843911e369dfc75cd07559a35c5dad61ec255718dfec com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.replace:api-1 com.docker.compose.service:api com.docker.compose.version:5.5.1 org.opencontainers.image.version:25.10]", + "/mtusi2026lab3-api-2 250000000 map[com.docker.compose.config-hash:baa6c518a5d0d2ce1a2d38ddcfa206234dfa8023729d82b99b3f7264efaf99b4 com.docker.compose.container-number:2 com.docker.compose.depends_on: com.docker.compose.image:sha256:d988ea1050459c3d472f843911e369dfc75cd07559a35c5dad61ec255718dfec com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.replace:api-2 com.docker.compose.service:api com.docker.compose.version:5.5.1 org.opencontainers.image.version:25.10]", + "/mtusi2026lab3-api-3 250000000 map[com.docker.compose.config-hash:baa6c518a5d0d2ce1a2d38ddcfa206234dfa8023729d82b99b3f7264efaf99b4 com.docker.compose.container-number:3 com.docker.compose.depends_on: com.docker.compose.image:sha256:d988ea1050459c3d472f843911e369dfc75cd07559a35c5dad61ec255718dfec com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.service:api com.docker.compose.version:5.5.1 org.opencontainers.image.version:25.10]", + "/mtusi2026lab3-api-4 250000000 map[com.docker.compose.config-hash:baa6c518a5d0d2ce1a2d38ddcfa206234dfa8023729d82b99b3f7264efaf99b4 com.docker.compose.container-number:4 com.docker.compose.depends_on: com.docker.compose.image:sha256:d988ea1050459c3d472f843911e369dfc75cd07559a35c5dad61ec255718dfec com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.service:api com.docker.compose.version:5.5.1 org.opencontainers.image.version:25.10]", + "/mtusi2026lab3-cache-1 500000000 map[com.docker.compose.config-hash:a7d737a55154622d18c1f35f33d3767c8335e00fb23f230f1afca917e900252d com.docker.compose.container-number:1 com.docker.compose.depends_on: com.docker.compose.image:sha256:32627109abf6f741121096b45c732f758876803efd7b2e1018ebc0350d117119 com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.service:cache com.docker.compose.version:5.5.1 org.opencontainers.image.source:https://github.com/valkey-io/valkey]", + "/mtusi2026lab3-db-1 4000000000 map[com.docker.compose.config-hash:00262326412a2d2388e383afd1f1c5d3453baeebf2e459788f9a579b8340f994 com.docker.compose.container-number:1 com.docker.compose.depends_on: com.docker.compose.image:sha256:cbf42f0edc946c0bc1b8eeed62403734e1f25dc67a3491455d07a92fdb558b28 com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.replace:db-1 com.docker.compose.service:db com.docker.compose.version:5.5.1]", + "/mtusi2026lab3-lb-1 250000000 map[com.docker.compose.config-hash:8afd1a6fe04af86c6e4c4bc0c6be3e01db2e2c692a325086cc477df1a110aebb com.docker.compose.container-number:1 com.docker.compose.depends_on:api:service_healthy:false com.docker.compose.image:sha256:09ab424a8c788f8d0fe3a64429f6d19dfa526885c8609b748d0943a75dcb9f8c com.docker.compose.oneoff:False com.docker.compose.project:mtusi2026lab3 com.docker.compose.project.config_files:/home/andrey/mtusi2026lab3/compose.yaml com.docker.compose.project.environment_file:/home/andrey/mtusi2026lab3/.env com.docker.compose.project.working_dir:/home/andrey/mtusi2026lab3 com.docker.compose.replace:lb-1 com.docker.compose.service:lb com.docker.compose.version:5.5.1 maintainer:NGINX Docker Maintainers ]" + ], + "cpu": { + "api": { + "samples": 28, + "mean_cpu_percent": 17.31, + "max_cpu_percent": 27.56 + }, + "db": { + "samples": 7, + "mean_cpu_percent": 110.05, + "max_cpu_percent": 178.78 + }, + "lb": { + "samples": 7, + "mean_cpu_percent": 19.02, + "max_cpu_percent": 26.49 + }, + "cache": { + "samples": 7, + "mean_cpu_percent": 5.58, + "max_cpu_percent": 12.24 + } + }, + "load": { + "lab": 3, + "workload": "closed-loop POST messages; no automatic retries", + "requested_duration_seconds": 30.0, + "elapsed_seconds": 30.301, + "concurrency": 50, + "successful_requests": 8298, + "failed_requests": 0, + "error_ratio": 0.0, + "successful_rps": 273.854, + "successful_latency_ms": { + "p50": 176.149, + "p95": 373.138, + "p99": 519.185 + }, + "note": "Latency percentiles cover successes only. Timeouts/errors are counted separately; closed-loop has coordinated omission and client overhead." + } +} diff --git a/evidence/track1-W-r4-apicpu0.25-dbcpu4.0.load.json b/evidence/track1-W-r4-apicpu0.25-dbcpu4.0.load.json new file mode 100644 index 0000000..17a1b96 --- /dev/null +++ b/evidence/track1-W-r4-apicpu0.25-dbcpu4.0.load.json @@ -0,0 +1,17 @@ +{ + "lab": 3, + "workload": "closed-loop POST messages; no automatic retries", + "requested_duration_seconds": 30.0, + "elapsed_seconds": 30.301, + "concurrency": 50, + "successful_requests": 8298, + "failed_requests": 0, + "error_ratio": 0.0, + "successful_rps": 273.854, + "successful_latency_ms": { + "p50": 176.149, + "p95": 373.138, + "p99": 519.185 + }, + "note": "Latency percentiles cover successes only. Timeouts/errors are counted separately; closed-loop has coordinated omission and client overhead." +} diff --git a/lb/nginx.conf b/lb/nginx.conf new file mode 100644 index 0000000..db5a272 --- /dev/null +++ b/lb/nginx.conf @@ -0,0 +1,39 @@ +worker_processes auto; +error_log /dev/stderr warn; +pid /tmp/nginx.pid; + +events { + worker_connections 4096; +} + +http { + access_log off; + resolver 127.0.0.11 valid=2s ipv6=off; + resolver_timeout 2s; + + upstream api_upstream { + zone api_upstream 64k; + server api:8080 resolve max_fails=1 fail_timeout=5s; + keepalive 32; + } + + server { + listen 8080; + + location / { + proxy_pass http://api_upstream; + proxy_http_version 1.1; + proxy_set_header Connection ""; + proxy_set_header Host $host; + proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; + proxy_set_header X-Forwarded-Proto $scheme; + proxy_set_header X-Forwarded-Host $host; + proxy_next_upstream error timeout http_502 http_503 http_504; + proxy_next_upstream_tries 2; + proxy_next_upstream_timeout 10s; + proxy_connect_timeout 2s; + proxy_read_timeout 10s; + proxy_send_timeout 10s; + } + } +} diff --git a/migrations/001_init.sql b/migrations/001_init.sql new file mode 100644 index 0000000..6c67477 --- /dev/null +++ b/migrations/001_init.sql @@ -0,0 +1,33 @@ +CREATE TABLE users ( + id uuid PRIMARY KEY, + username text NOT NULL UNIQUE + CHECK (username ~ '^[a-z0-9_]{3,32}$'), + display_name text NOT NULL, + password_hash text NOT NULL, + created_at timestamptz NOT NULL +); + +CREATE TABLE chats ( + id uuid PRIMARY KEY, + title text NOT NULL, + created_at timestamptz NOT NULL +); + +CREATE TABLE chat_members ( + chat_id uuid NOT NULL REFERENCES chats(id) ON DELETE CASCADE, + user_id uuid NOT NULL REFERENCES users(id) ON DELETE CASCADE, + PRIMARY KEY (chat_id, user_id) +); + +CREATE INDEX chat_members_user_idx ON chat_members(user_id); + +CREATE TABLE messages ( + id uuid PRIMARY KEY, + chat_id uuid NOT NULL REFERENCES chats(id) ON DELETE CASCADE, + sender_id uuid NOT NULL REFERENCES users(id), + text text NOT NULL, + created_at timestamptz NOT NULL +); + +CREATE INDEX messages_chat_keyset_idx + ON messages (chat_id, created_at, id); \ No newline at end of file diff --git a/migrations/002_sessions.sql b/migrations/002_sessions.sql new file mode 100644 index 0000000..2ee4985 --- /dev/null +++ b/migrations/002_sessions.sql @@ -0,0 +1,6 @@ +CREATE TABLE sessions ( + token text PRIMARY KEY, + user_id uuid NOT NULL REFERENCES users(id) ON DELETE CASCADE, + expires_at timestamptz NOT NULL +); +CREATE INDEX sessions_expires_at_idx ON sessions (expires_at); \ No newline at end of file diff --git a/migrations/003_idempotency.sql b/migrations/003_idempotency.sql new file mode 100644 index 0000000..2c84707 --- /dev/null +++ b/migrations/003_idempotency.sql @@ -0,0 +1,11 @@ +CREATE TABLE idempotency_keys ( + user_id uuid NOT NULL REFERENCES users(id) ON DELETE CASCADE, + chat_id uuid NOT NULL REFERENCES chats(id) ON DELETE CASCADE, + key text NOT NULL CHECK (key ~ '^[A-Za-z0-9._:-]{1,128}$'), + request_hash text NOT NULL, + message_id uuid NOT NULL REFERENCES messages(id) ON DELETE CASCADE, + created_at timestamptz NOT NULL DEFAULT now(), + PRIMARY KEY (user_id, chat_id, key) +); + +CREATE INDEX idempotency_keys_created_at_idx ON idempotency_keys (created_at); \ No newline at end of file diff --git a/requirements-dev.txt b/requirements-dev.txt index 6b103dd..e22616c 100644 --- a/requirements-dev.txt +++ b/requirements-dev.txt @@ -1,2 +1,3 @@ # Only for full OpenAPI/JSON Schema validation; HTTP tests use stdlib. openapi-spec-validator==0.7.2 +matplotlib==3.11.2 diff --git a/scripts/plot_graphs.py b/scripts/plot_graphs.py new file mode 100644 index 0000000..a0283fc --- /dev/null +++ b/scripts/plot_graphs.py @@ -0,0 +1,100 @@ +#!/usr/bin/env python3 +"""Plot track-1 JSON files written by scripts/run_track1.py.""" +import json +from pathlib import Path + +import matplotlib + +matplotlib.use("Agg") +import matplotlib.pyplot as plt + +ROOT = Path(__file__).resolve().parents[1] +EVIDENCE = ROOT / "evidence" + + +def load_series(letter): + rows = [] + for path in sorted(EVIDENCE.glob("track1-*.json")): + if path.name.endswith(".load.json"): + continue + data = json.loads(path.read_text()) + if data.get("series") != letter: + continue + load = data["load"] + lat = load["successful_latency_ms"] + rows.append( + { + "replicas": data["api_replicas"], + "db_cpu": data["db_cpu_limit"], + "pool": data["pg_pool"], + "nginx": str(data["nginx_worker_processes"]), + "rps": load["successful_rps"], + "p50": lat["p50"], + "p95": lat["p95"], + "p99": lat["p99"], + "errors": load["failed_requests"], + } + ) + return rows + + +def dual_axis(ax, xs, rps, p99, xlabel, title): + ax.plot(xs, rps, marker="o", color="#1f4e79", label="successful RPS") + ax.set_xlabel(xlabel) + ax.set_ylabel("successful RPS") + ax.set_title(title) + twin = ax.twinx() + twin.plot(xs, p99, marker="s", color="#b85c38", label="p99, ms") + twin.set_ylabel("p99, ms") + lines = ax.get_lines() + twin.get_lines() + ax.legend(lines, [line.get_label() for line in lines], loc="best") + ax.grid(True, axis="y", alpha=0.3) + return twin + + +def main(): + series_a = sorted(load_series("A"), key=lambda row: row["replicas"]) + series_b = sorted(load_series("B"), key=lambda row: row["db_cpu"]) + repeat = load_series("R") + tuned = load_series("P") + if not series_a or not series_b: + raise SystemExit("need series A and B JSON in evidence/") + + fig, ax = plt.subplots(figsize=(7.2, 4.4)) + dual_axis( + ax, + [row["replicas"] for row in series_a], + [row["rps"] for row in series_a], + [row["p99"] for row in series_a], + "API replicas (total CPU = 1.0, DB CPU = 2.0)", + "Серия A: реплики API при фиксированном суммарном CPU", + ) + fig.tight_layout() + fig.savefig(EVIDENCE / "api_scaling.png", dpi=140) + plt.close(fig) + + fig, ax = plt.subplots(figsize=(7.2, 4.4)) + twin = dual_axis( + ax, + [row["db_cpu"] for row in series_b], + [row["rps"] for row in series_b], + [row["p99"] for row in series_b], + "PostgreSQL CPU limit (4 API × 0.25 CPU)", + "Серия B: CPU базы и парный прогон тюнинга", + ) + if repeat and tuned: + base, point = repeat[-1], tuned[-1] + ax.scatter([base["db_cpu"]], [base["rps"]], marker="x", s=80, color="#1f4e79", zorder=5, label="repeat baseline RPS") + ax.scatter([point["db_cpu"] + 0.08], [point["rps"]], marker="*", s=160, color="#1f4e79", zorder=5, label="tuned RPS") + twin.scatter([base["db_cpu"]], [base["p99"]], marker="x", s=80, color="#b85c38", zorder=5, label="repeat baseline p99") + twin.scatter([point["db_cpu"] + 0.08], [point["p99"]], marker="*", s=160, color="#b85c38", zorder=5, label="tuned p99") + handles = ax.get_lines() + twin.get_lines() + list(ax.collections) + list(twin.collections) + ax.legend(handles, [h.get_label() for h in handles], loc="best", fontsize=8) + fig.tight_layout() + fig.savefig(EVIDENCE / "db_scaling.png", dpi=140) + plt.close(fig) + print("wrote evidence/api_scaling.png evidence/db_scaling.png") + + +if __name__ == "__main__": + main() diff --git a/scripts/restart.sh b/scripts/restart.sh new file mode 100755 index 0000000..784aa58 --- /dev/null +++ b/scripts/restart.sh @@ -0,0 +1,38 @@ +#!/bin/sh +set -eu + +cd "$(dirname "$0")/.." + +compose() { + docker compose --env-file .env "$@" +} + +deadline=$(( $(date +%s) + 70 )) + +wait_healthy() { + svc=$1 + want=1 + if [ "$svc" = "api" ]; then + want=${API_REPLICAS:-2} + fi + while [ "$(date +%s)" -lt "$deadline" ]; do + states=$(compose ps "$svc" --format '{{.Health}}' || true) + n=$(printf '%s\n' "$states" | grep -cx healthy || true) + if [ "$n" -ge "$want" ]; then + return 0 + fi + sleep 1 + done + echo "timed out waiting for $svc" >&2 + return 1 +} + +compose restart db cache +wait_healthy db +wait_healthy cache +compose start api +compose restart api +wait_healthy api +compose restart lb +wait_healthy lb +exit 0 diff --git a/scripts/run_track1.py b/scripts/run_track1.py new file mode 100755 index 0000000..bc5bc88 --- /dev/null +++ b/scripts/run_track1.py @@ -0,0 +1,234 @@ +#!/usr/bin/env python3 +"""One measured load.py run under explicit Compose CPU limits. Prints nothing secret.""" +import json +import os +import subprocess +import sys +import threading +import time +import urllib.error +import urllib.request +from pathlib import Path + +ROOT = Path(__file__).resolve().parents[1] + + +def env_for(api_replicas, api_cpu, db_cpu): + env = os.environ.copy() + env["API_REPLICAS"] = str(api_replicas) + env["API_CPU_LIMIT"] = str(api_cpu) + env["DB_CPU_LIMIT"] = str(db_cpu) + return env + + +def compose(args, env): + result = subprocess.run( + ["docker", "compose", "--env-file", str(ROOT / ".env"), *args], + cwd=ROOT, + env=env, + check=False, + text=True, + capture_output=True, + ) + if result.returncode != 0: + sys.stderr.write(result.stderr or result.stdout) + return result + + +def wait_stack(env, replicas, timeout=180): + deadline = time.monotonic() + timeout + last = "" + while time.monotonic() < deadline: + ps = compose(["ps", "api", "--format", "{{.Health}}"], env) + health = [line.strip() for line in ps.stdout.splitlines() if line.strip()] + ready = False + try: + with urllib.request.urlopen("http://127.0.0.1:8080/health/ready", timeout=2) as resp: + ready = resp.status == 200 + except (urllib.error.URLError, TimeoutError, OSError): + ready = False + last = f"api_health={health} ready={ready}" + if len(health) == replicas and all(item == "healthy" for item in health) and ready: + return + time.sleep(2) + raise SystemExit("stack did not become ready: " + last) + + +def observed_nanos(env): + ids = compose(["ps", "-q"], env).stdout.split() + found = [] + for cid in ids: + info = subprocess.check_output( + ["docker", "inspect", "-f", "{{.Name}} {{.HostConfig.NanoCpus}} {{.Config.Labels}}", cid], + text=True, + ).strip() + found.append(info) + return found + + +def sample_stats(stop, bucket): + while not stop.is_set(): + proc = subprocess.run( + ["docker", "stats", "--no-stream", "--format", "{{.Name}}\t{{.CPUPerc}}\t{{.MemUsage}}"], + text=True, + capture_output=True, + check=False, + ) + stamp = time.time() + rows = [] + for line in proc.stdout.splitlines(): + parts = line.split("\t") + if len(parts) != 3: + continue + name, cpu, mem = parts + cpu_val = cpu.strip().rstrip("%") + try: + cpu_num = float(cpu_val) + except ValueError: + continue + rows.append({"name": name, "cpu_percent": cpu_num, "mem": mem.strip()}) + if rows: + bucket.append({"t": stamp, "rows": rows}) + stop.wait(3) + + +def summarize_cpu(samples): + acc = {} + for sample in samples: + for row in sample["rows"]: + name = row["name"].lstrip("/") + service = "other" + for prefix in ("api", "db", "cache", "lb"): + if f"-{prefix}-" in name or name.endswith(prefix): + service = prefix + break + acc.setdefault(service, []).append(row["cpu_percent"]) + out = {} + for service, values in acc.items(): + out[service] = { + "samples": len(values), + "mean_cpu_percent": round(sum(values) / len(values), 2), + "max_cpu_percent": round(max(values), 2), + } + return out + + +def main(): + if len(sys.argv) != 7: + raise SystemExit( + "usage: run_track1.py SERIES REPLICAS API_CPU DB_CPU POOL NGINX_WORKERS" + ) + series, replicas, api_cpu, db_cpu, pool, nginx_workers = sys.argv[1:] + replicas = int(replicas) + env = env_for(replicas, api_cpu, db_cpu) + label = f"track1-{series}-r{replicas}-apicpu{api_cpu}-dbcpu{db_cpu}" + raw = ROOT / "evidence" / f"{label}.load.json" + dest = ROOT / "evidence" / f"{label}.json" + + up_db = None + for _ in range(3): + up_db = compose( + ["up", "-d", "--no-deps", "--force-recreate", "db"], + env, + ) + if up_db.returncode == 0: + break + time.sleep(2) + if up_db.returncode != 0: + sys.stderr.write(up_db.stderr) + raise SystemExit(up_db.returncode) + up_api = compose( + ["up", "-d", "--no-deps", "--force-recreate", "--scale", f"api={replicas}", "api"], + env, + ) + if up_api.returncode != 0: + sys.stderr.write(up_api.stderr) + raise SystemExit(up_api.returncode) + up_lb = compose(["up", "-d", "--no-deps", "lb"], env) + if up_lb.returncode != 0: + sys.stderr.write(up_lb.stderr) + raise SystemExit(up_lb.returncode) + wait_stack(env, replicas) + limits = observed_nanos(env) + + warmup = subprocess.run( + [ + sys.executable, + str(ROOT / "tests" / "load.py"), + "--duration", + "10", + "--concurrency", + "50", + "--output", + f"/tmp/{label}-warmup.json", + ], + cwd=ROOT, + text=True, + capture_output=True, + ) + if warmup.returncode != 0: + sys.stderr.write(warmup.stdout) + sys.stderr.write(warmup.stderr) + raise SystemExit("warmup failed") + + samples = [] + stop = threading.Event() + thread = threading.Thread(target=sample_stats, args=(stop, samples)) + thread.start() + try: + measured = subprocess.run( + [ + sys.executable, + str(ROOT / "tests" / "load.py"), + "--duration", + "30", + "--concurrency", + "50", + "--output", + str(raw), + ], + cwd=ROOT, + text=True, + capture_output=True, + ) + finally: + stop.set() + thread.join() + if measured.returncode != 0: + sys.stderr.write(measured.stdout) + sys.stderr.write(measured.stderr) + raise SystemExit("measured run failed") + load = json.loads(raw.read_text()) + report = { + "series": series, + "api_replicas": replicas, + "api_cpu_limit": float(api_cpu), + "db_cpu_limit": float(db_cpu), + "pg_pool": int(pool), + "nginx_worker_processes": nginx_workers, + "warmup_seconds": 10, + "inspect": limits, + "cpu": summarize_cpu(samples), + "load": load, + } + dest.write_text(json.dumps(report, ensure_ascii=False, indent=2) + "\n") + lat = load["successful_latency_ms"] + print( + json.dumps( + { + "file": str(dest.relative_to(ROOT)), + "rps": load["successful_rps"], + "p50": lat["p50"], + "p95": lat["p95"], + "p99": lat["p99"], + "errors": load["failed_requests"], + "error_ratio": load["error_ratio"], + "cpu": report["cpu"], + }, + ensure_ascii=False, + ) + ) + + +if __name__ == "__main__": + main() diff --git a/scripts/run_track1.sh b/scripts/run_track1.sh new file mode 100755 index 0000000..4990981 --- /dev/null +++ b/scripts/run_track1.sh @@ -0,0 +1,53 @@ +#!/bin/bash +set -e + +# Переходим в корень проекта +cd "$(dirname "$0")/.." + +# Проверяем, что .env существует +if [ ! -f .env ]; then + echo "Ошибка: .env не найден" + exit 1 +fi + +mkdir -p evidence + +# Функция для запуска одного теста +run_test() { + local replicas=$1 + local cpu_limit=$2 + + echo "==================================================" + echo "ТЕСТ: $replicas реплик (лимит CPU на реплику: $cpu_limit, суммарно 1.0)" + echo "==================================================" + + # Меняем переменные окружения для compose + export API_REPLICAS=$replicas + export API_CPU_LIMIT=$cpu_limit + + # Перезапускаем стек + echo "Перезапуск стека..." + docker compose --env-file .env down + docker compose --env-file .env up -d --build + + echo "Ожидание готовности LB (10 секунд)..." + sleep 10 + + # Запускаем нагрузку + echo "Запуск нагрузки (30 секунд, 20 воркеров)..." + python3 tests/load.py --duration 30 --concurrency 20 --output "evidence/load_${replicas}rep.json" + + # Снимаем метрики CPU контейнеров + echo "Сбор метрик CPU..." + docker stats --no-stream --format "table {{.Name}}\t{{.CPUPerc}}\t{{.MemUsage}}" > "evidence/docker_stats_${replicas}rep.txt" + + echo "Тест завершен." + echo "" +} + +# Запускаем 3 конфигурации +run_test 1 "1.0" +run_test 2 "0.5" +run_test 4 "0.25" + +echo "Все тесты завершены! Результаты в папке evidence/" \ No newline at end of file diff --git a/scripts/run_track1_improvement.sh b/scripts/run_track1_improvement.sh new file mode 100755 index 0000000..01657f9 --- /dev/null +++ b/scripts/run_track1_improvement.sh @@ -0,0 +1,15 @@ +#!/bin/bash +set -e +cd "$(dirname "$0")/.." +mkdir -p evidence + +export API_REPLICAS=4 +export API_CPU_LIMIT=0.25 +export DB_CPU_LIMIT=1.0 + +echo "ТЕСТ: 4 реплики API, БД 1.0 CPU + УВЕЛИЧЕННЫЕ ЛИМИТЫ (tuning)" +docker compose --env-file .env down +docker compose --env-file .env up -d --build +sleep 10 + +python3 tests/load.py --duration 30 --concurrency 50 --output "evidence/load_improved.json" \ No newline at end of file diff --git a/scripts/run_track1_scaling.sh b/scripts/run_track1_scaling.sh new file mode 100755 index 0000000..a531997 --- /dev/null +++ b/scripts/run_track1_scaling.sh @@ -0,0 +1,29 @@ +#!/bin/bash +set -e +cd "$(dirname "$0")/.." +mkdir -p evidence + +export API_REPLICAS=4 +export API_CPU_LIMIT=0.25 + +run_db_test() { + local db_cpu=$1 + echo "==================================================" + echo "ТЕСТ: 4 реплики API, лимит CPU для БД: $db_cpu" + echo "==================================================" + + export DB_CPU_LIMIT=$db_cpu + docker compose --env-file .env down + docker compose --env-file .env up -d --build + sleep 10 + + echo "Нагрузка: 50 воркеров, 30 секунд..." + python3 tests/load.py --duration 30 --concurrency 50 --output "evidence/load_db_${db_cpu}cpu.json" + echo "" +} + +run_db_test "1.0" +run_db_test "2.0" +run_db_test "4.0" + +echo "Готово! Результаты в evidence/" \ No newline at end of file diff --git a/scripts/stop-one.sh b/scripts/stop-one.sh new file mode 100755 index 0000000..52592c6 --- /dev/null +++ b/scripts/stop-one.sh @@ -0,0 +1,24 @@ +#!/bin/sh +set -eu + +: "${TARGET_INSTANCE_ID:?TARGET_INSTANCE_ID is required}" + +cd "$(dirname "$0")/.." + +found="" +ids=$(docker compose --env-file .env ps -q api) +for id in $ids; do + host=$(docker inspect -f '{{.Config.Hostname}}' "$id") + if [ "$host" = "$TARGET_INSTANCE_ID" ]; then + found=$id + break + fi +done + +if [ -z "$found" ]; then + echo "api replica not found" >&2 + exit 1 +fi + +docker stop -t 8 "$found" >/dev/null +exit 0 diff --git a/src/auth.cpp b/src/auth.cpp new file mode 100644 index 0000000..d6d8cf9 --- /dev/null +++ b/src/auth.cpp @@ -0,0 +1,39 @@ +#include "auth.hpp" + +#include +#include + + +namespace { +struct SodiumInit { + SodiumInit() { + if (sodium_init() < 0) { + throw std::runtime_error("sodium_init failed"); + } + } +}; + +const SodiumInit g_sodium_init; +} + + +std::string hash_password(const std::string& plain) { + char hashed[crypto_pwhash_STRBYTES]; + if (crypto_pwhash_str( + hashed, + plain.data(), plain.size(), + crypto_pwhash_OPSLIMIT_INTERACTIVE, + crypto_pwhash_MEMLIMIT_INTERACTIVE) != 0) { + throw std::runtime_error("crypto_pwhash_str failed (out of memory?)"); + } + return std::string(hashed); +} + +bool verify_password(const std::string& plain, const std::string& hash) { + if (hash.empty() || hash.size() >= crypto_pwhash_STRBYTES) { + return false; + } + return crypto_pwhash_str_verify( + hash.c_str(), + plain.data(), plain.size()) == 0; +} \ No newline at end of file diff --git a/src/auth.hpp b/src/auth.hpp new file mode 100644 index 0000000..639b033 --- /dev/null +++ b/src/auth.hpp @@ -0,0 +1,7 @@ +#pragma once + +#include + +std::string hash_password(const std::string& plain); + +bool verify_password(const std::string& plain, const std::string& hash); \ No newline at end of file diff --git a/src/chat_repo.cpp b/src/chat_repo.cpp new file mode 100644 index 0000000..580fc71 --- /dev/null +++ b/src/chat_repo.cpp @@ -0,0 +1,186 @@ +#include "chat_repo.hpp" +#include "cursor.hpp" + +#include + +#include +#include +#include +#include +#include +#include + +namespace { + +std::string make_uuid() { + static std::mt19937_64 rng{std::random_device{}()}; + std::uniform_int_distribution d16(0, 0xffff); + std::uniform_int_distribution d32(0, 0xffffffffu); + std::ostringstream out; + out << std::hex << std::setfill('0'); + out << std::setw(8) << d32(rng); + out << '-' << std::setw(4) << d16(rng); + out << '-' << std::setw(4) << ((d16(rng) & 0x0fff) | 0x4000); + out << '-' << std::setw(4) << ((d16(rng) & 0x3fff) | 0x8000); + out << '-' << std::setw(4) << d16(rng) << std::setw(8) << d32(rng); + return out.str(); +} + +std::string epoch_to_rfc3339(long long epoch) { + const std::time_t t = static_cast(epoch); + std::tm tm{}; + gmtime_r(&t, &tm); + std::ostringstream out; + out << std::put_time(&tm, "%Y-%m-%dT%H:%M:%SZ"); + return out.str(); +} + +std::string now_epoch_str() { + const auto now = std::chrono::system_clock::now(); + const auto secs = std::chrono::duration_cast( + now.time_since_epoch()).count(); + return std::to_string(secs); +} + +Chat row_to_chat(const pqxx::row& r) { + Chat c; + c.id = r["id"].as(); + c.title = r["title"].as(); + c.created_at = epoch_to_rfc3339(r["created_at_epoch"].as()); + return c; +} + +std::vector load_member_ids(pqxx::work& tx, + const std::string& chat_id) { + std::vector ids; + auto r = tx.exec( + "SELECT user_id FROM chat_members WHERE chat_id = $1 ORDER BY user_id", + pqxx::params{chat_id}); + ids.reserve(r.size()); + for (const auto& row : r) { + ids.push_back(row["user_id"].as()); + } + return ids; +} + +constexpr const char* kChatSelect = + "id, title, " + "EXTRACT(EPOCH FROM created_at)::bigint AS created_at_epoch"; + +} + +std::optional ChatRepo::create(const std::string& title, + const std::vector& member_ids) { + auto lease = pool_.acquire(); + pqxx::work tx(*lease); + + const std::string chat_id = make_uuid(); + const std::string created = now_epoch_str(); + + try { + tx.exec( + "INSERT INTO chats (id, title, created_at) " + "VALUES ($1, $2, to_timestamp($3::bigint))", + pqxx::params{chat_id, title, created}); + + for (const auto& uid : member_ids) { + tx.exec( + "INSERT INTO chat_members (chat_id, user_id) VALUES ($1, $2)", + pqxx::params{chat_id, uid}); + } + } catch (const pqxx::foreign_key_violation&) { + tx.abort(); + return std::nullopt; + } catch (const pqxx::unique_violation&) { + tx.abort(); + return std::nullopt; + } + + auto r = tx.exec( + "SELECT " + std::string(kChatSelect) + " FROM chats WHERE id = $1", + pqxx::params{chat_id}); + Chat c = row_to_chat(r[0]); + c.member_ids = load_member_ids(tx, chat_id); + tx.commit(); + return c; +} + +std::optional ChatRepo::find_by_id(const std::string& id) { + auto lease = pool_.acquire(); + pqxx::work tx(*lease); + auto r = tx.exec( + "SELECT " + std::string(kChatSelect) + " FROM chats WHERE id = $1", + pqxx::params{id}); + if (r.empty()) { + tx.commit(); + return std::nullopt; + } + Chat c = row_to_chat(r[0]); + c.member_ids = load_member_ids(tx, id); + tx.commit(); + return c; +} + + +std::optional ChatRepo::list_for_user( + const std::string& user_id, + int limit, + const std::optional& cursor) { + + std::optional cur; + if (cursor) { + cur = parse_cursor(*cursor); + if (!cur) { + return std::nullopt; + } + } + + auto lease = pool_.acquire(); + pqxx::work tx(*lease); + + if (cur) { + auto owner_check = tx.exec( + "SELECT 1 FROM chats WHERE id = $1 AND id IN " + "(SELECT chat_id FROM chat_members WHERE user_id = $2)", + pqxx::params{cur->id, user_id}); + if (owner_check.empty()) { + tx.commit(); + return std::nullopt; + } + } + + std::string sql = + "SELECT " + std::string(kChatSelect) + ", " + kCreatedUsSql + " " + "FROM chats " + "WHERE id IN (SELECT chat_id FROM chat_members WHERE user_id = $1) "; + if (cur) { + sql += "AND (created_at, id) > (" + std::string(kCursorTimestampSql) + ", $4::uuid) "; + } + sql += "ORDER BY created_at ASC, id ASC LIMIT $2"; + + pqxx::result r; + if (cur) { + r = tx.exec(sql, pqxx::params{user_id, limit + 1, cur->created_us, cur->id}); + } else { + r = tx.exec(sql, pqxx::params{user_id, limit + 1}); + } + + ChatPage page; + const bool has_more = (static_cast(r.size()) > limit); + const int take = has_more ? limit : static_cast(r.size()); + page.items.reserve(take); + for (int i = 0; i < take; ++i) { + Chat c = row_to_chat(r[static_cast(i)]); + c.member_ids = load_member_ids(tx, c.id); + page.items.push_back(std::move(c)); + } + + if (has_more && take > 0) { + const auto& last = r[static_cast(take - 1)]; + page.next_cursor = make_cursor(last["created_us"].as(), + last["id"].as()); + } + + tx.commit(); + return page; +} \ No newline at end of file diff --git a/src/chat_repo.hpp b/src/chat_repo.hpp new file mode 100644 index 0000000..279e266 --- /dev/null +++ b/src/chat_repo.hpp @@ -0,0 +1,23 @@ +#pragma once + +#include "db.hpp" +#include "models.hpp" + +#include +#include +#include + +class ChatRepo { +public: + explicit ChatRepo(PgPool& pool) : pool_(pool) {} + + std::optional create(const std::string& title, + const std::vector& member_ids); + + std::optional find_by_id(const std::string& id); + + std::optional list_for_user(const std::string& user_id, int limit, const std::optional& cursor); + +private: + PgPool& pool_; +}; \ No newline at end of file diff --git a/src/cursor.hpp b/src/cursor.hpp new file mode 100644 index 0000000..08f0850 --- /dev/null +++ b/src/cursor.hpp @@ -0,0 +1,47 @@ +#pragma once + +#include +#include +#include +#include +#include + +// Непрозрачный для клиента курсор keyset-пагинации: "|". +// Микросекунды сохраняют точный created_at строки, даже если в JSON время округлено до секунд. +struct Cursor { + std::string created_us; + std::string id; +}; + +// Выражение SQL, восстанавливающее timestamptz из created_us без потери точности. +constexpr const char* kCursorTimestampSql = + "(timestamptz 'epoch' + $3::bigint * interval '1 microsecond')"; + +constexpr const char* kCreatedUsSql = + "(EXTRACT(EPOCH FROM created_at) * 1000000)::bigint AS created_us"; + +inline bool is_uuid(const std::string& s) { + static const std::regex re( + "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-" + "[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"); + return std::regex_match(s, re); +} + +inline std::optional parse_cursor(const std::string& raw) { + const auto bar = raw.find('|'); + if (bar == std::string::npos) { + return std::nullopt; + } + Cursor c{raw.substr(0, bar), raw.substr(bar + 1)}; + const bool digits = !c.created_us.empty() && c.created_us.size() <= 18 && + std::all_of(c.created_us.begin(), c.created_us.end(), + [](unsigned char ch) { return std::isdigit(ch); }); + if (!digits || !is_uuid(c.id)) { + return std::nullopt; + } + return c; +} + +inline std::string make_cursor(const std::string& created_us, const std::string& id) { + return created_us + "|" + id; +} diff --git a/src/db.cpp b/src/db.cpp new file mode 100644 index 0000000..97312c4 --- /dev/null +++ b/src/db.cpp @@ -0,0 +1,360 @@ +#include "db.hpp" +#include "errors.hpp" + +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include + +namespace fs = std::filesystem; + + +namespace { + +constexpr int kConnectTimeoutSeconds = 2; +constexpr int kTcpUserTimeoutMs = 5000; +constexpr int kStatementTimeoutMs = 5000; +constexpr int kClientIoTimeoutSeconds = 5; +constexpr auto kAcquireTimeout = std::chrono::seconds(3); + +std::string add_conn_param(std::string conninfo, const std::string& key, + const std::string& value) { + if (conninfo.find(key + "=") != std::string::npos) { + return conninfo; + } + const bool is_url = conninfo.rfind("postgres://", 0) == 0 || + conninfo.rfind("postgresql://", 0) == 0; + if (is_url) { + conninfo += (conninfo.find('?') == std::string::npos ? "?" : "&"); + } else { + conninfo += " "; + } + return conninfo + key + "=" + value; +} + +bool is_alive(pqxx::connection* conn) { + std::promise done; + auto fut = done.get_future(); + std::thread th([conn, &done]() { + try { + pqxx::nontransaction tx(*conn); + tx.exec("SELECT 1"); + done.set_value(); + } catch (...) { + done.set_exception(std::current_exception()); + } + }); + if (fut.wait_for(std::chrono::seconds(kClientIoTimeoutSeconds)) != + std::future_status::ready) { + const int fd = conn->sock(); + if (fd >= 0) { + ::shutdown(fd, SHUT_RDWR); + } + th.join(); + return false; + } + th.join(); + try { + fut.get(); + return true; + } catch (...) { + return false; + } +} + +struct Migration { + int version; + std::string path; +}; + +constexpr int kMigrationsAdvisoryLockKey = 0x6d747573; + + +Migration parse_migration_name(const fs::path& p) { + const std::string name = p.filename().string(); + const auto dot = name.find('.'); + + if (dot == std::string::npos || name.substr(dot) != ".sql") { + throw std::runtime_error("migration file must end with .sql: " + name); + } + + const auto us = name.find('_'); + if (us == std::string::npos || us == 0) { + throw std::runtime_error( + "migration file must be named NNN_name.sql: " + name); + } + + const std::string num = name.substr(0, us); + if (!std::all_of(num.begin(), num.end(), + [](unsigned char c){ return std::isdigit(c); })) { + throw std::runtime_error( + "migration file prefix must be digits: " + name); + } + + Migration m; + m.version = std::stoi(num); + m.path = p.string(); + return m; +}} + + +void apply_migrations(pqxx::connection& conn, const std::string& dir) { + { + pqxx::work tx(conn); + tx.exec("SELECT pg_advisory_lock($1)", + pqxx::params{kMigrationsAdvisoryLockKey}); + tx.commit(); + } + std::clog << "migration advisory lock acquired\n"; + struct Unlock { + pqxx::connection& c; + ~Unlock() { + try { + pqxx::work tx(c); + tx.exec("SELECT pg_advisory_unlock($1)", + pqxx::params{kMigrationsAdvisoryLockKey}); + tx.commit(); + } catch (...) {} + } + } unlock_guard{conn}; + + { + pqxx::work tx(conn); + tx.exec( + "CREATE TABLE IF NOT EXISTS schema_migrations (" + " version int PRIMARY KEY," + " applied_at timestamptz NOT NULL DEFAULT now()" + ")"); + tx.commit(); + } + + if (!fs::exists(dir) || !fs::is_directory(dir)) { + throw std::runtime_error("migrations dir not found: " + dir); + } + std::vector files; + for (const auto& entry : fs::directory_iterator(dir)) { + if (entry.is_regular_file()) { + files.push_back(parse_migration_name(entry.path())); + } + } + std::sort(files.begin(), files.end(), + [](const Migration& a, const Migration& b){ + return a.version < b.version; + }); + + for (std::size_t i = 1; i < files.size(); ++i) { + if (files[i].version == files[i-1].version) { + throw std::runtime_error( + "duplicate migration version: " + std::to_string(files[i].version)); + } + } + + std::set applied; + { + pqxx::work tx(conn); + for (const auto& row : tx.exec("SELECT version FROM schema_migrations")) { + applied.insert(row[0].as()); + } + tx.commit(); + } + + for (const auto& m : files) { + if (applied.count(m.version)) { + continue; + } + + std::ifstream f(m.path, std::ios::binary); + if (!f) { + throw std::runtime_error("cannot open migration: " + m.path); + } + std::stringstream buf; + buf << f.rdbuf(); + const std::string sql = buf.str(); + + pqxx::work tx(conn); + tx.exec(sql); + tx.exec("INSERT INTO schema_migrations(version) VALUES ($1)", + m.version); + tx.commit(); + + std::clog << "applied migration " << m.version + << " (" << m.path << ")\n"; + } +} + + +std::string read_secret_file(const char* env_name) { + const char* path = std::getenv(env_name); + + if (path == nullptr || *path == '\0') { + throw std::runtime_error( + std::string("environment variable not set: ") + env_name); + } + + std::ifstream f(path, std::ios::binary); + if (!f) { + throw std::runtime_error( + std::string("cannot open secret file: ") + path); + } + + std::string s; + std::getline(f, s); + if (!s.empty() && s.back() == '\r') { + s.pop_back(); + } + + if (s.empty()) { + throw std::runtime_error( + std::string("secret file is empty: ") + path); + } + + return s; +} + + +bool is_dependency_failure(const std::exception& e) { + if (dynamic_cast(&e) != nullptr || + dynamic_cast(&e) != nullptr || + dynamic_cast(&e) != nullptr) { + return true; + } + if (const auto* sql = dynamic_cast(&e)) { + // 08xxx — ошибки соединения, 57xxx — отмена (statement_timeout) и остановка сервера. + const std::string& state = sql->sqlstate(); + return state.rfind("08", 0) == 0 || state.rfind("57", 0) == 0; + } + return false; +} + + +std::unique_ptr open_pg_connection(const std::string& conninfo, + bool statement_timeout) { + std::string full = add_conn_param(conninfo, "connect_timeout", + std::to_string(kConnectTimeoutSeconds)); + full = add_conn_param(full, "tcp_user_timeout", std::to_string(kTcpUserTimeoutMs)); + auto conn = std::make_unique(full); + const int fd = conn->sock(); + if (fd >= 0) { + timeval tv{}; + tv.tv_sec = kClientIoTimeoutSeconds; + tv.tv_usec = 0; + ::setsockopt(fd, SOL_SOCKET, SO_RCVTIMEO, &tv, sizeof(tv)); + ::setsockopt(fd, SOL_SOCKET, SO_SNDTIMEO, &tv, sizeof(tv)); + } + if (statement_timeout) { + pqxx::nontransaction tx(*conn); + tx.exec("SET statement_timeout = " + std::to_string(kStatementTimeoutMs)); + } + return conn; +} + + +PgPool::PgPool(std::string conninfo, std::size_t n) + : conninfo_(std::move(conninfo)) { + if (n == 0) { + throw std::runtime_error("PgPool: n must be > 0"); + } + all_.reserve(n); + idle_.reserve(n); + for (std::size_t i = 0; i < n; ++i) { + auto conn = open_pg_connection(conninfo_, true); + idle_.push_back(conn.get()); + all_.push_back(std::move(conn)); + } +} + + +PgPool::~PgPool() { + { + std::lock_guard lk(mu_); + shutting_down_ = true; + } + cv_.notify_all(); +} + + +pqxx::connection* PgPool::take() { + std::unique_lock lk(mu_); + if (!cv_.wait_for(lk, kAcquireTimeout, + [&]() { return shutting_down_ || !idle_.empty(); })) { + throw DependencyUnavailable("postgres pool: acquire timeout"); + } + if (shutting_down_) { + throw DependencyUnavailable("postgres pool is shutting down"); + } + pqxx::connection* conn = idle_.back(); + idle_.pop_back(); + lk.unlock(); + + if (is_alive(conn)) { + return conn; + } + + std::unique_ptr fresh; + try { + fresh = open_pg_connection(conninfo_, true); + } catch (const std::exception& e) { + // Мёртвое соединение возвращается в пул: следующий take() снова + // попробует переподключиться, и пул не теряет слот. + give_back(conn); + throw DependencyUnavailable(std::string("postgres reconnect failed: ") + e.what()); + } + + std::lock_guard lk2(mu_); + for (auto& up : all_) { + if (up.get() == conn) { + up = std::move(fresh); + return up.get(); + } + } + throw std::logic_error("PgPool: connection not owned by pool"); +} + + +void PgPool::give_back(pqxx::connection* conn) { + { + std::lock_guard lk(mu_); + idle_.push_back(conn); + } + cv_.notify_one(); +} + + +PgPool::Lease::Lease(PgPool& pool) : pool_(&pool), conn_(pool.take()) {} + +PgPool::Lease::~Lease() { + if (pool_ != nullptr && conn_ != nullptr) { + pool_->give_back(conn_); + } +} + +PgPool::Lease::Lease(Lease&& other) noexcept + : pool_(other.pool_), conn_(other.conn_) { + other.pool_ = nullptr; + other.conn_ = nullptr; +} + +PgPool::Lease PgPool::acquire() { + return Lease(*this); +} + +bool PgPool::ping() { + try { + auto lease = acquire(); + pqxx::work tx(*lease); + tx.exec("SELECT 1"); + tx.commit(); + return true; + } catch (...) { + return false; + } +} \ No newline at end of file diff --git a/src/db.hpp b/src/db.hpp new file mode 100644 index 0000000..bacfa92 --- /dev/null +++ b/src/db.hpp @@ -0,0 +1,62 @@ +#pragma once +#include + +#include + +#include +#include +#include +#include +#include + + +std::string read_secret_file(const char* env_name); + +std::unique_ptr open_pg_connection(const std::string& conninfo, + bool statement_timeout); + + +void apply_migrations(pqxx::connection& conn, const std::string& dir); + + +class PgPool { +public: + bool ping(); + PgPool(std::string conninfo, std::size_t n); + ~PgPool(); + + PgPool(const PgPool&) = delete; + PgPool& operator=(const PgPool&) = delete; + + class Lease { + public: + explicit Lease(PgPool& pool); + ~Lease(); + Lease(Lease&& other) noexcept; + Lease& operator=(Lease&&) = delete; + Lease(const Lease&) = delete; + Lease& operator=(const Lease&) = delete; + + pqxx::connection& operator*() const { return *conn_; } + pqxx::connection* operator->() const { return conn_; } + + private: + PgPool* pool_; + pqxx::connection* conn_; + }; + + Lease acquire(); + +private: + friend class Lease; + + pqxx::connection* take(); + void give_back(pqxx::connection* conn); + + std::string conninfo_; + std::vector> all_; + std::vector idle_; + std::mutex mu_; + std::condition_variable cv_; + bool shutting_down_ = false; +}; \ No newline at end of file diff --git a/src/errors.hpp b/src/errors.hpp new file mode 100644 index 0000000..4f9f3c5 --- /dev/null +++ b/src/errors.hpp @@ -0,0 +1,11 @@ +#pragma once + +#include +#include + +// PostgreSQL или Valkey недоступны либо не ответили вовремя: клиент получает 503. +struct DependencyUnavailable : std::runtime_error { + using std::runtime_error::runtime_error; +}; + +bool is_dependency_failure(const std::exception& e); diff --git a/src/main.cpp b/src/main.cpp new file mode 100644 index 0000000..0ad0a2b --- /dev/null +++ b/src/main.cpp @@ -0,0 +1,1379 @@ +#include "models.hpp" +#include "db.hpp" +#include "auth.hpp" +#include "user_repo.hpp" +#include "chat_repo.hpp" +#include "message_repo.hpp" +#include "redis_pool.hpp" +#include "session_repo.hpp" +#include "pg_session_repo.hpp" +#include "session_repo_base.hpp" +#include "errors.hpp" + + +#include +#include +#include +#include + +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include + +static std::string g_instance_id; + +static std::string make_instance_id() { + const char* env = std::getenv("INSTANCE_ID"); + if (env && *env) { + return std::string(env); + } + const char* host = std::getenv("HOSTNAME"); + if (host && *host) { + return std::string(host); + } + static const char hex[] = "0123456789abcdef"; + std::random_device rd; + std::string s(8, '0'); + for (auto& c : s) c = hex[rd() & 0xf]; + return s; +} + + +static void send_all(int fd, const std::string& data) { + size_t sent = 0; + while (sent < data.size()) { + const ssize_t n = ::write(fd, data.data() + sent, data.size() - sent); + if (n <= 0) { + return; + } + sent += static_cast(n); + } +} + + +static std::string http_response(int status, const char* reason, + const std::string& request_id, + const std::string& body) { + std::string out; + out += "HTTP/1.1 " + std::to_string(status) + " " + reason + "\r\n"; + out += "Content-Type: application/json\r\n"; + out += "X-Request-Id: " + request_id + "\r\n"; + out += "X-Instance-Id: " + g_instance_id + "\r\n"; + out += "Content-Length: " + std::to_string(body.size()) + "\r\n"; + out += "Connection: close\r\n"; + out += "\r\n"; + out += body; + return out; +} + +static std::string http_no_content(const std::string& request_id) { + std::string out; + out += "HTTP/1.1 204 No Content\r\n"; + out += "X-Request-Id: " + request_id + "\r\n"; + out += "X-Instance-Id: " + g_instance_id + "\r\n"; + out += "Content-Length: 0\r\n"; + out += "Connection: close\r\n"; + out += "\r\n"; + return out; +} + + +static const char* status_reason(int status) { + switch (status) { + case 400: return "Bad Request"; + case 401: return "Unauthorized"; + case 404: return "Not Found"; + case 409: return "Conflict"; + case 413: return "Payload Too Large"; + case 415: return "Unsupported Media Type"; + case 500: return "Internal Server Error"; + case 503: return "Service Unavailable"; + default: return "Error"; + } +} + + +static std::string error_response(int status, + const std::string& code, + const std::string& message, + const std::string& request_id, + const std::string& www_authenticate = "") { + nlohmann::json j; + j["error"]["code"] = code; + j["error"]["message"] = message; + j["error"]["request_id"] = request_id; + const std::string body = j.dump(); + + std::string head = + "HTTP/1.1 " + std::to_string(status) + " " + + status_reason(status) + "\r\n" + "Content-Type: application/json\r\n" + "X-Request-Id: " + request_id + "\r\n" + + "X-Instance-Id: " + g_instance_id + "\r\n"; + if (status == 401 && !www_authenticate.empty()) { + head += "WWW-Authenticate: " + www_authenticate + "\r\n"; + } + head += "Content-Length: " + std::to_string(body.size()) + "\r\n"; + head += "Connection: close\r\n\r\n"; + return head + body; +} + + +static std::string failure_response(const std::exception& e, const char* what, + const std::string& request_id) { + std::clog << what << " failed: " << e.what() << "\n"; + if (is_dependency_failure(e)) { + return error_response(503, "unavailable", "service unavailable", request_id); + } + return error_response(500, "internal_error", "internal error", request_id); +} + + +static std::optional parse_json_object(const std::string& body) { + nlohmann::json j; + try { + j = nlohmann::json::parse(body); + } catch (const nlohmann::json::exception&) { + return std::nullopt; + } + + if (!j.is_object()) { + return std::nullopt; + } + return j; +} + + +static std::optional find_unexpected_key( + const nlohmann::json& j, + std::initializer_list allowed) { + for (const auto& [key, value] : j.items()) { + bool ok = false; + for (const char* a : allowed) { + if (key == a) { ok = true; break; } + } + + if (!ok) { + return key; + } + } + return std::nullopt; +} + + +static std::optional get_string_field( + const nlohmann::json& j, const char* key) { + auto it = j.find(key); + if (it == j.end() || !it->is_string()) { + return std::nullopt; + } + return it->get(); +} + + +static std::optional> get_string_array( + const nlohmann::json& j, const char* key) { + auto it = j.find(key); + if (it == j.end() || !it->is_array()) { + return std::nullopt; + } + std::vector out; + out.reserve(it->size()); + for (const auto& item : *it) { + if (!item.is_string()) { + return std::nullopt; + } + out.push_back(item.get()); + } + return out; +} + +static bool parse_request_line(const std::string& first_line, + std::string& method, + std::string& path, + std::string& query) { + query.clear(); + const auto sp1 = first_line.find(' '); + if (sp1 == std::string::npos) { + return false; + } + + const auto sp2 = first_line.find(' ', sp1 + 1); + if (sp2 == std::string::npos) { + return false; + } + + method = first_line.substr(0, sp1); + path = first_line.substr(sp1 + 1, sp2 - sp1 - 1); + const auto q = path.find('?'); + if (q != std::string::npos) { + query = path.substr(q + 1); + path.resize(q); + } + return !method.empty() && !path.empty() && path[0] == '/'; +} + +static bool match_id_path(const std::string& path, + const std::string& prefix, + std::string& id) { + if (path.compare(0, prefix.size(), prefix) != 0) { + return false; + } + id = path.substr(prefix.size()); + return !id.empty() && id.find('/') == std::string::npos; +} + + +static bool match_chat_messages(const std::string& path, std::string& chat_id) { + const std::string prefix = "/api/v1/chats/"; + const std::string suffix = "/messages"; + if (path.size() <= prefix.size() + suffix.size()) { + return false; + } + if (path.compare(0, prefix.size(), prefix) != 0) { + return false; + } + if (path.compare(path.size() - suffix.size(), suffix.size(), suffix) != 0) { + return false; + } + chat_id = path.substr(prefix.size(), + path.size() - prefix.size() - suffix.size()); + return !chat_id.empty() && chat_id.find('/') == std::string::npos; +} + + +static std::string to_lower(std::string s) { + for (char& c : s) { + c = static_cast(std::tolower(static_cast(c))); + } + return s; +} + + +static std::optional utf8_cps(const std::string& s) { + size_t i = 0; + size_t n = 0; + while (i < s.size()) { + const unsigned char c = static_cast(s[i]); + size_t w = 1; + if (c >= 0x80) { + if ((c & 0xE0) == 0xC0) w = 2; + else if ((c & 0xF0) == 0xE0) w = 3; + else if ((c & 0xF8) == 0xF0) w = 4; + else return std::nullopt; + if (i + w > s.size()) return std::nullopt; + for (size_t k = 1; k < w; ++k) { + if ((static_cast(s[i + k]) & 0xC0) != 0x80) { + return std::nullopt; + } + } + } + ++n; + i += w; + } + return n; +} + + +static bool cps_in_range(const std::string& s, size_t lo, size_t hi) { + const auto n = utf8_cps(s); + return n && *n >= lo && *n <= hi; +} + + +static std::unordered_map parse_headers( + const std::string& request, std::string::size_type after_first_line) { + std::unordered_map headers; + auto pos = after_first_line; + if (pos < request.size() && request.compare(pos, 2, "\r\n") == 0) { + pos += 2; + } + for (;;) { + const auto eol = request.find("\r\n", pos); + if (eol == std::string::npos || eol == pos) { + break; + } + const std::string line = request.substr(pos, eol - pos); + pos = eol + 2; + const auto colon = line.find(':'); + if (colon == std::string::npos) { + continue; + } + std::string name = to_lower(line.substr(0, colon)); + std::string value = line.substr(colon + 1); + while (!value.empty() && (value[0] == ' ' || value[0] == '\t')) { + value.erase(0, 1); + } + headers[name] = value; + } + return headers; +} + + +static std::string user_json(const User& user) { + nlohmann::json j; + j["id"] = user.id; + j["username"] = user.username; + j["display_name"] = user.display_name; + j["created_at"] = user.created_at; + return j.dump(); +} + + +static std::string message_json(const Message& msg) { + nlohmann::json j; + j["id"] = msg.id; + j["chat_id"] = msg.chat_id; + j["sender_id"] = msg.sender_id; + j["text"] = msg.text; + j["created_at"] = msg.created_at; + return j.dump(); +} + + +static std::string chat_json(const Chat& chat) { + nlohmann::json j; + j["id"] = chat.id; + j["title"] = chat.title; + j["member_ids"] = chat.member_ids; + j["created_at"] = chat.created_at; + return j.dump(); +} + + +static std::string messages_page_json(const MessagePage& msgs) { + nlohmann::json j; + j["items"] = nlohmann::json::array(); + for (const auto& m : msgs.items) { + j["items"].push_back(nlohmann::json::parse(message_json(m))); + } + if (msgs.next_cursor) { + j["next_cursor"] = *msgs.next_cursor; + } else { + j["next_cursor"] = nullptr; + } + return j.dump(); +} + + +static std::string chats_page_json(const ChatPage& page) { + nlohmann::json j; + j["items"] = nlohmann::json::array(); + for (const auto& c : page.items) { + j["items"].push_back(nlohmann::json::parse(chat_json(c))); + } + if (page.next_cursor) { + j["next_cursor"] = *page.next_cursor; + } else { + j["next_cursor"] = nullptr; + } + return j.dump(); +} + + +static bool is_json_content_type(const std::string& raw) { + std::string s = to_lower(raw); + const auto sc = s.find(';'); + if (sc != std::string::npos) { + s.resize(sc); + } + while (!s.empty() && (s.back() == ' ' || s.back() == '\t')) { + s.pop_back(); + } + size_t a = 0; + while (a < s.size() && (s[a] == ' ' || s[a] == '\t')) { + ++a; + } + return s.substr(a) == "application/json"; +} + + +static int hex_val(char c) { + if (c >= '0' && c <= '9') return c - '0'; + if (c >= 'a' && c <= 'f') return c - 'a' + 10; + if (c >= 'A' && c <= 'F') return c - 'A' + 10; + return -1; +} + + +static bool json_content_type_ok( + const std::unordered_map& headers) { + const auto it = headers.find("content-type"); + return it != headers.end() && is_json_content_type(it->second); +} + + +static bool contains_nul(const std::string& s) { + return s.find('\0') != std::string::npos; +} + +static bool is_unicode_space(uint32_t cp) { + if (cp <= 0x7F) { + return std::isspace(static_cast(cp)) != 0; + } + if (cp >= 0x2000 && cp <= 0x200A) { + return true; + } + switch (cp) { + case 0x00A0: + case 0x1680: + case 0x2028: + case 0x2029: + case 0x202F: + case 0x205F: + case 0x3000: + case 0xFEFF: + return true; + default: + return false; + } +} + +static bool is_blank(const std::string& s) { + size_t i = 0; + while (i < s.size()) { + const unsigned char c = static_cast(s[i]); + uint32_t cp = c; + size_t w = 1; + if (c >= 0x80) { + if ((c & 0xE0) == 0xC0 && i + 1 < s.size()) { + w = 2; + cp = (static_cast(c & 0x1F) << 6) + | (static_cast(s[i + 1]) & 0x3F); + } else if ((c & 0xF0) == 0xE0 && i + 2 < s.size()) { + w = 3; + cp = (static_cast(c & 0x0F) << 12) + | ((static_cast(s[i + 1]) & 0x3F) << 6) + | (static_cast(s[i + 2]) & 0x3F); + } else if ((c & 0xF8) == 0xF0 && i + 3 < s.size()) { + w = 4; + cp = (static_cast(c & 0x07) << 18) + | ((static_cast(s[i + 1]) & 0x3F) << 12) + | ((static_cast(s[i + 2]) & 0x3F) << 6) + | (static_cast(s[i + 3]) & 0x3F); + } else { + return false; + } + } + if (!is_unicode_space(cp)) { + return false; + } + i += w; + } + return true; +} + + +static bool valid_username(const std::string& s) { + static const std::regex re("^[a-z0-9_]{3,32}$"); + return std::regex_match(s, re); +} + + +static bool valid_uuid(const std::string& s) { + static const std::regex re( + "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-" + "[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"); + return std::regex_match(s, re); +} + +static bool valid_idempotency_key(const std::string& s) { + static const std::regex re("^[A-Za-z0-9._:-]{1,128}$"); + return std::regex_match(s, re); +} + + +static bool has_duplicate_ids(const std::vector& ids) { + std::unordered_set seen; + for (const auto& id : ids) { + if (!seen.insert(to_lower(id)).second) { + return true; + } + } + return false; +} + + +static std::string url_decode(const std::string& s) { + std::string out; + for (size_t i = 0; i < s.size(); ++i) { + if (s[i] == '%' && i + 2 < s.size()) { + const int hi = hex_val(s[i + 1]); + const int lo = hex_val(s[i + 2]); + if (hi >= 0 && lo >= 0) { + out.push_back(static_cast((hi << 4) | lo)); + i += 2; + continue; + } + } + out.push_back(s[i] == '+' ? ' ' : s[i]); + } + return out; +} + + +static std::unordered_map parse_query( + const std::string& query) { + std::unordered_map out; + size_t pos = 0; + while (pos < query.size()) { + auto amp = query.find('&', pos); + if (amp == std::string::npos) { + amp = query.size(); + } + const auto pair = query.substr(pos, amp - pos); + const auto eq = pair.find('='); + if (eq != std::string::npos) { + out[url_decode(pair.substr(0, eq))] = + url_decode(pair.substr(eq + 1)); + } + pos = amp + 1; + } + return out; +} + + +static std::atomic g_listen{-1}; +static std::atomic g_stop{false}; +static std::atomic g_draining{false}; +static std::mutex g_live_mu; +static std::unordered_set g_live; + +static void set_timeouts(int fd) { + timeval tv{}; + tv.tv_sec = 2; + tv.tv_usec = 0; + ::setsockopt(fd, SOL_SOCKET, SO_RCVTIMEO, &tv, sizeof(tv)); + ::setsockopt(fd, SOL_SOCKET, SO_SNDTIMEO, &tv, sizeof(tv)); +} + +static void live_add(int fd) { + std::lock_guard lk(g_live_mu); + g_live.insert(fd); +} + +static void live_del(int fd) { + std::lock_guard lk(g_live_mu); + g_live.erase(fd); +} + +static std::string read_request(int client, bool& too_large) { + too_large = false; + std::string request; + char buf[4096]; + constexpr std::size_t kMaxBody = 1048576; + for (;;) { + const ssize_t n = ::read(client, buf, sizeof(buf)); + if (n < 0) { + if (errno == EINTR) { + continue; + } + return {}; + } + if (n == 0) { + return request; + } + request.append(buf, static_cast(n)); + const auto hdr = request.find("\r\n\r\n"); + if (hdr == std::string::npos) { + continue; + } + std::size_t content_length = 0; + const auto cl = to_lower(request).find("content-length:"); + if (cl != std::string::npos && cl < hdr) { + const auto line_end = request.find("\r\n", cl); + const auto colon = request.find(':', cl); + if (line_end != std::string::npos && colon < line_end) { + content_length = static_cast( + std::atoi(request.c_str() + colon + 1)); + } + } + if (content_length > kMaxBody) { + too_large = true; + request.resize(hdr + 4); + return request; + } + const auto need = hdr + 4 + content_length; + if (request.size() >= need) { + request.resize(need); + return request; + } + } +} + +static std::optional> parse_basic_auth( + const std::string& header_value) { + + static const std::string prefix = "Basic "; + if (header_value.size() <= prefix.size() || + header_value.compare(0, prefix.size(), prefix) != 0) { + return std::nullopt; + } + const std::string b64 = header_value.substr(prefix.size()); + + auto b64_val = [](char c) -> int { + if (c >= 'A' && c <= 'Z') return c - 'A'; + if (c >= 'a' && c <= 'z') return c - 'a' + 26; + if (c >= '0' && c <= '9') return c - '0' + 52; + if (c == '+') return 62; + if (c == '/') return 63; + return -1; + }; + + std::string decoded; + int buf = 0, bits = 0; + for (char c : b64) { + if (c == '=') break; + const int v = b64_val(c); + if (v < 0) return std::nullopt; + buf = (buf << 6) | v; + bits += 6; + if (bits >= 8) { + bits -= 8; + decoded.push_back(static_cast((buf >> bits) & 0xFF)); + } + } + + const auto colon = decoded.find(':'); + if (colon == std::string::npos) { + return std::nullopt; + } + return std::make_pair(decoded.substr(0, colon), + decoded.substr(colon + 1)); +} + +static void handle_client(int client, + std::atomic& request_n, + UserRepo& users, + ChatRepo& chats, + MessageRepo& messages, + ISessionRepo& sessions, + PgPool& pg, + RedisPool* redis) { + bool too_large = false; + const std::string request = read_request(client, too_large); + const unsigned nreq = ++request_n; + const std::string request_id = std::to_string(nreq); + + if (too_large) { + send_all(client, error_response(413, "payload_too_large", + "payload too large", request_id)); + live_del(client); + ::close(client); + return; + } + if (request.empty()) { + live_del(client); + ::close(client); + return; + } + + const auto line_end = request.find("\r\n"); + const std::string first_line = request.substr(0, line_end); + std::string method; + std::string path; + std::string query; + if (!parse_request_line(first_line, method, path, query)) { + send_all(client, error_response(400, "invalid_request", + "bad request line", request_id)); + live_del(client); + ::close(client); + return; + } + + const auto headers = parse_headers(request, line_end); + std::string user_id; + std::string bearer_token; + bool auth_backend_error = false; + { + auto it = headers.find("authorization"); + if (it != headers.end()) { + static const std::string prefix = "Bearer "; + const std::string& auth = it->second; + if (auth.size() > prefix.size() && + auth.compare(0, prefix.size(), prefix) == 0) { + bearer_token = auth.substr(prefix.size()); + } + } + if (!bearer_token.empty()) { + try { + auto found = sessions.lookup(bearer_token); + if (found) { + user_id = *found; + } + } catch (const std::exception& e) { + std::clog << "session lookup failed: " << e.what() << "\n"; + auth_backend_error = true; + } + } + } + auto send_auth_error = [&]() -> bool { + if (auth_backend_error) { + send_all(client, error_response(503, "unavailable", + "service unavailable", request_id)); + return true; + } + if (user_id.empty()) { + send_all(client, error_response(401, "unauthorized", + "unauthorized", request_id, + "Bearer realm=\"messenger\"")); + return true; + } + return false; + }; + // Сессия может пережить пользователя; недоступная БД — это 503, а не 401. + auto send_user_error = [&]() -> bool { + try { + if (users.find_by_id(user_id)) { + return false; + } + send_all(client, error_response(401, "unauthorized", + "unauthorized", request_id, + "Bearer realm=\"messenger\"")); + } catch (const std::exception& e) { + send_all(client, failure_response(e, "find_user", request_id)); + } + return true; + }; + + std::string chat_id; + + if (method == "GET" && path == "/health/live") { + send_all(client, http_response(200, "OK", request_id, "{\"status\":\"ok\"}")); + } + else if (method == "GET" && path == "/health/ready") { + if (g_draining.load()) { + send_all(client, error_response(503, "unavailable", + "shutting down", request_id)); + } else { + const bool pg_ok = pg.ping(); + const bool redis_ok = redis == nullptr || redis->ping(); + if (pg_ok && redis_ok) { + send_all(client, http_response(200, "OK", request_id, "{\"status\":\"ok\"}")); + } else { + std::clog << "readiness failed: pg=" << pg_ok + << " redis=" << redis_ok << "\n"; + send_all(client, error_response(503, "unavailable", + "service unavailable", request_id)); + } + } + } + else if (method == "POST" && path == "/api/v1/auth/sessions") { + const auto body_at = request.find("\r\n\r\n"); + const std::string session_body = + body_at == std::string::npos ? "" : request.substr(body_at + 4); + if (!session_body.empty()) { + send_all(client, error_response(400, "invalid_request", + "body not allowed", request_id)); + } else { + auto it = headers.find("authorization"); + std::optional> creds; + if (it != headers.end()) { + creds = parse_basic_auth(it->second); + } + + const auto send_basic_401 = [&]() { + send_all(client, error_response( + 401, "unauthorized", "unauthorized", request_id, + "Basic realm=\"messenger\", charset=\"UTF-8\"")); + }; + + if (!creds) { + send_basic_401(); + } else { + const auto& username = creds->first; + const auto& password = creds->second; + try { + const auto user = users.find_by_username(username); + if (!user || !verify_password(password, user->password_hash)) { + send_basic_401(); + } else { + const auto created = sessions.create(user->id); + nlohmann::json j; + j["token"] = created.token; + j["token_type"] = "Bearer"; + const std::time_t t = static_cast( + created.expires_at); + std::tm tm{}; + gmtime_r(&t, &tm); + std::ostringstream out; + out << std::put_time(&tm, "%Y-%m-%dT%H:%M:%SZ"); + j["expires_at"] = out.str(); + j["user"] = nlohmann::json::parse(user_json(*user)); + send_all(client, http_response(201, "Created", + request_id, j.dump())); + } + } catch (const std::exception& e) { + send_all(client, failure_response(e, "create_session", request_id)); + } + } + } + } + else if (method == "GET" && path == "/api/v1/users/me") { + if (send_auth_error()) { + } else { + try { + const auto user = users.find_by_id(user_id); + if (!user) { + send_all(client, error_response(401, "unauthorized", + "unauthorized", request_id, + "Bearer realm=\"messenger\"")); + } else { + send_all(client, http_response(200, "OK", request_id, + user_json(*user))); + } + } catch (const std::exception& e) { + send_all(client, failure_response(e, "find_user", request_id)); + } + } + } + else if (method == "POST" && path == "/api/v1/users") { + if (!json_content_type_ok(headers)) { + send_all(client, error_response(415, "unsupported_media_type", + "unsupported media type", request_id)); + } else { + const auto body_at = request.find("\r\n\r\n"); + const std::string body = + body_at == std::string::npos ? "" : request.substr(body_at + 4); + + const auto j = parse_json_object(body); + if (!j) { + send_all(client, error_response(400, "invalid_request", + "invalid json", request_id)); + } else if (auto bad = find_unexpected_key( + *j, {"username", "display_name", "password"})) { + send_all(client, error_response(400, "invalid_request", + "unexpected field: " + *bad, request_id)); + } else { + const auto username = get_string_field(*j, "username"); + const auto display_name = get_string_field(*j, "display_name"); + const auto password = get_string_field(*j, "password"); + if (!username || !display_name || !password) { + send_all(client, error_response(400, "invalid_request", + "invalid fields", request_id)); + } else if (!valid_username(*username) || + contains_nul(*display_name) || + is_blank(*display_name) || + !cps_in_range(*display_name, 1, 100)) { + send_all(client, error_response(400, "invalid_request", + "invalid fields", request_id)); + } else if (contains_nul(*password) || + !cps_in_range(*password, 12, 128)) { + send_all(client, error_response(400, "invalid_request", + "invalid password", request_id)); + } else { + std::string hash; + try { + hash = hash_password(*password); + } catch (const std::exception& e) { + send_all(client, failure_response(e, "hash_password", request_id)); + } + if (!hash.empty()) { + try { + const auto created = users.create(*username, + *display_name, hash); + if (!created) { + send_all(client, error_response(409, "conflict", + "username taken", request_id)); + } else { + send_all(client, http_response(201, "Created", request_id, + user_json(*created))); + } + } catch (const std::exception& e) { + send_all(client, failure_response(e, "create_user", request_id)); + } + } + } + } + } + } + else if (method == "POST" && path == "/api/v1/chats") { + if (send_auth_error()) { + // ответ отправлен + } else if (send_user_error()) { + // ответ отправлен + } else if (!json_content_type_ok(headers)) { + send_all(client, error_response(415, "unsupported_media_type", + "unsupported media type", request_id)); + } else { + const auto body_at = request.find("\r\n\r\n"); + const std::string body = + body_at == std::string::npos ? "" : request.substr(body_at + 4); + + const auto j = parse_json_object(body); + if (!j) { + send_all(client, error_response(400, "invalid_request", + "invalid json", request_id)); + } else if (auto bad = find_unexpected_key(*j, {"title", "member_ids"})) { + send_all(client, error_response(400, "invalid_request", + "unexpected field: " + *bad, request_id)); + } else { + const auto title = get_string_field(*j, "title"); + const auto member_ids = get_string_array(*j, "member_ids"); + if (!title || !member_ids) { + send_all(client, error_response(400, "invalid_request", + "invalid fields", request_id)); + } else if (contains_nul(*title) || is_blank(*title) || + !cps_in_range(*title, 1, 100)) { + send_all(client, error_response(400, "invalid_request", + "invalid fields", request_id)); + } else if (member_ids->empty() || member_ids->size() > 100) { + send_all(client, error_response(400, "invalid_request", + "invalid members", request_id)); + } else if (std::find(member_ids->begin(), member_ids->end(), + user_id) == member_ids->end()) { + send_all(client, error_response(400, "invalid_request", + "caller not in members", request_id)); + } else if (!std::all_of(member_ids->begin(), member_ids->end(), + valid_uuid)) { + send_all(client, error_response(400, "invalid_request", + "invalid members", request_id)); + } else if (has_duplicate_ids(*member_ids)) { + send_all(client, error_response(400, "invalid_request", + "duplicate members", request_id)); + } else { + try { + const auto created = chats.create(*title, *member_ids); + if (!created) { + send_all(client, error_response(400, "invalid_request", + "invalid members", request_id)); + } else { + send_all(client, http_response(201, "Created", request_id, + chat_json(*created))); + } + } catch (const std::exception& e) { + send_all(client, failure_response(e, "create_chat", request_id)); + } + } + } + } + } + else if (method == "POST" && match_chat_messages(path, chat_id)) { + if (send_auth_error()) { + // ответ отправлен + } else if (send_user_error()) { + // ответ отправлен + } else if (!valid_uuid(chat_id)) { + send_all(client, error_response(400, "invalid_request", + "invalid chat id", request_id)); + } else { + try { + const auto chat = chats.find_by_id(chat_id); + const bool is_member = chat && + (std::find(chat->member_ids.begin(), + chat->member_ids.end(), + user_id) != chat->member_ids.end()); + if (!is_member) { + send_all(client, error_response(404, "not_found", + "not found", request_id)); + } else if (!json_content_type_ok(headers)) { + send_all(client, error_response(415, "unsupported_media_type", + "unsupported media type", request_id)); + } else { + const auto body_at = request.find("\r\n\r\n"); + const std::string body = + body_at == std::string::npos ? "" : request.substr(body_at + 4); + + const auto j = parse_json_object(body); + if (!j) { + send_all(client, error_response(400, "invalid_request", + "invalid json", request_id)); + } else if (auto bad = find_unexpected_key(*j, {"text"})) { + send_all(client, error_response(400, "invalid_request", + "unexpected field: " + *bad, request_id)); + } else { + const auto text = get_string_field(*j, "text"); + if (!text) { + send_all(client, error_response(400, "invalid_request", + "invalid fields", request_id)); + } else if (contains_nul(*text) || is_blank(*text) || + !cps_in_range(*text, 1, 4000)) { + send_all(client, error_response(400, "invalid_request", + "invalid fields", request_id)); + } else { + const auto idem = headers.find("idempotency-key"); + if (idem == headers.end() || + !valid_idempotency_key(idem->second)) { + send_all(client, error_response( + 400, "invalid_request", + "invalid idempotency key", request_id)); + } else { + const auto created = messages.create_idempotent( + chat_id, user_id, *text, idem->second); + if (created.status == CreateResult::Status::NotFound) { + send_all(client, error_response(404, "not_found", + "not found", request_id)); + } else if (created.status == + CreateResult::Status::KeyConflict) { + send_all(client, error_response( + 409, "conflict", + "idempotency key reused", request_id)); + } else if (!created.message) { + send_all(client, error_response( + 500, "internal_error", + "internal error", request_id)); + } else { + send_all(client, http_response( + 201, "Created", request_id, + message_json(*created.message))); + } + } + } + } + } + } catch (const std::exception& e) { + send_all(client, failure_response(e, "post_message", request_id)); + } + } + } + else if (method == "GET" && match_chat_messages(path, chat_id)) { + if (send_auth_error()) { + } else if (send_user_error()) { + // ответ отправлен + } else if (!valid_uuid(chat_id)) { + send_all(client, error_response(400, "invalid_request", + "invalid chat id", request_id)); + } else { + try { + const auto chat = chats.find_by_id(chat_id); + const bool is_member = chat && + (std::find(chat->member_ids.begin(), + chat->member_ids.end(), + user_id) != chat->member_ids.end()); + if (!is_member) { + send_all(client, error_response(404, "not_found", + "not found", request_id)); + } else { + const auto params = parse_query(query); + int limit = 50; + bool bad_limit = false; + if (params.count("limit")) { + try { + std::size_t consumed = 0; + limit = std::stoi(params.at("limit"), &consumed); + if (consumed != params.at("limit").size() || + limit < 1 || limit > 100) { + bad_limit = true; + } + } catch (...) { + bad_limit = true; + } + } + std::optional cursor; + if (params.count("cursor")) { + cursor = params.at("cursor"); + } + if (bad_limit || (cursor && cursor->empty())) { + send_all(client, error_response(400, "invalid_request", + "bad query", request_id)); + } else { + const auto page = messages.list_page(chat_id, limit, cursor); + if (!page) { + send_all(client, error_response(400, "invalid_request", + "bad cursor", request_id)); + } else { + send_all(client, http_response(200, "OK", + request_id, + messages_page_json(*page))); + } + } + } + } catch (const std::exception& e) { + send_all(client, failure_response(e, "list_messages", request_id)); + } + } + } + else if (method == "GET" && path == "/api/v1/chats") { + if (send_auth_error()) { + // ответ отправлен + } else if (send_user_error()) { + // ответ отправлен + } else { + const auto params = parse_query(query); + int limit = 50; + bool bad_limit = false; + if (params.count("limit")) { + try { + std::size_t consumed = 0; + limit = std::stoi(params.at("limit"), &consumed); + if (consumed != params.at("limit").size() || + limit < 1 || limit > 100) { + bad_limit = true; + } + } catch (...) { + bad_limit = true; + } + } + std::optional cursor; + if (params.count("cursor")) { + cursor = params.at("cursor"); + } + if (bad_limit || (cursor && cursor->empty())) { + send_all(client, error_response(400, "invalid_request", + "bad query", request_id)); + } else { + try { + const auto page = chats.list_for_user(user_id, limit, cursor); + if (!page) { + send_all(client, error_response(400, "invalid_request", + "bad cursor", request_id)); + } else { + send_all(client, http_response(200, "OK", request_id, + chats_page_json(*page))); + } + } catch (const std::exception& e) { + send_all(client, failure_response(e, "list_chats", request_id)); + } + } + } + } + else if (method == "GET" && match_id_path(path, "/api/v1/chats/", chat_id)) { + if (send_auth_error()) { + // ответ отправлен + } else if (send_user_error()) { + // ответ отправлен + } else if (!valid_uuid(chat_id)) { + send_all(client, error_response(400, "invalid_request", + "invalid chat id", request_id)); + } else { + try { + const auto chat = chats.find_by_id(chat_id); + const bool is_member = chat && + (std::find(chat->member_ids.begin(), + chat->member_ids.end(), + user_id) != chat->member_ids.end()); + if (!is_member) { + send_all(client, error_response(404, "not_found", + "not found", request_id)); + } else { + send_all(client, http_response(200, "OK", request_id, + chat_json(*chat))); + } + } catch (const std::exception& e) { + send_all(client, failure_response(e, "find_chat", request_id)); + } + } + } else if (method == "DELETE" && path == "/api/v1/auth/sessions/current") { + if (send_auth_error()) { + } else { + try { + sessions.revoke(bearer_token); + send_all(client, http_no_content(request_id)); + } catch (const std::exception& e) { + send_all(client, failure_response(e, "revoke_session", request_id)); + } + } + } + else { + send_all(client, error_response(404, "not_found", "not found", request_id)); + } + + live_del(client); + ::close(client); +} + +int main() { + const char* host_env = std::getenv("APP_HOST"); + const char* port_env = std::getenv("APP_PORT"); + const char* host = host_env ? host_env : "0.0.0.0"; + const int port = port_env ? std::atoi(port_env) : 8080; + g_instance_id = make_instance_id(); + std::clog << "instance id: " << g_instance_id << "\n"; + + sigset_t set; + sigemptyset(&set); + sigaddset(&set, SIGTERM); + sigaddset(&set, SIGINT); + if (pthread_sigmask(SIG_BLOCK, &set, nullptr) != 0) { + std::cerr << "pthread_sigmask failed" << std::endl; + return 1; + } + + const std::string db_url = read_secret_file("DATABASE_URL_FILE"); + std::clog << "connecting to db...\n"; + { + auto conn = open_pg_connection(db_url, false); + std::clog << "applying migrations...\n"; + apply_migrations(*conn, "./migrations"); + std::clog << "migrations ok\n"; + } + + PgPool pool(db_url, 32); + std::clog << "pg pool ready (32 connections)\n"; + + UserRepo users(pool); + ChatRepo chats(pool); + MessageRepo messages(pool); + + const char* ttl_env = std::getenv("SESSION_TTL_SECONDS"); + const int ttl_seconds = ttl_env ? std::atoi(ttl_env) : 3600; + + const char* store_env = std::getenv("SESSION_STORE"); + const std::string store = store_env ? store_env : "redis"; + + std::unique_ptr redis_pool; + std::unique_ptr sessions; + if (store == "postgres") { + sessions = std::make_unique(pool, ttl_seconds); + std::clog << "session store: postgres\n"; + } else if (store == "redis") { + redis_pool = std::make_unique(read_secret_file("CACHE_URL_FILE"), 4); + std::clog << "redis pool ready (4 connections)\n"; + sessions = std::make_unique(*redis_pool, ttl_seconds); + std::clog << "session store: redis\n"; + } else { + throw std::runtime_error("unknown SESSION_STORE: " + store); + } + std::clog << "session ttl: " << ttl_seconds << "s\n"; + + const int fd = ::socket(AF_INET, SOCK_STREAM, 0); + if (fd < 0) { + std::cerr << "socket failed" << std::endl; + return 1; + } + + const int yes = 1; + ::setsockopt(fd, SOL_SOCKET, SO_REUSEADDR, &yes, sizeof(yes)); + + sockaddr_in addr{}; + addr.sin_family = AF_INET; + addr.sin_port = htons(static_cast(port)); + if (::inet_pton(AF_INET, host, &addr.sin_addr) != 1) { + std::cerr << "invalid APP_HOST" << std::endl; + ::close(fd); + return 1; + } + + if (::bind(fd, reinterpret_cast(&addr), sizeof(addr)) != 0) { + std::cerr << "bind failed on " << host << ":" << port << std::endl; + ::close(fd); + return 1; + } + + if (::listen(fd, 16) != 0) { + std::cerr << "listen failed" << std::endl; + ::close(fd); + return 1; + } + + g_listen.store(fd); + + std::clog << "listening on " << host << ":" << port << std::endl; + + std::atomic request_n{0}; + std::mutex q_mu; + std::condition_variable q_cv; + std::queue q; + const int workers_n = 32; + std::vector workers; + for (int i = 0; i < workers_n; ++i) { + workers.emplace_back([&]() { + for (;;) { + int client = -1; + { + std::unique_lock lk(q_mu); + q_cv.wait(lk, [&]() { return g_stop.load() || !q.empty(); }); + if (g_stop.load() && q.empty()) { + return; + } + client = q.front(); + q.pop(); + } + try { + handle_client(client, request_n, users, chats, messages, *sessions, pool, redis_pool.get()); + } catch (const std::exception& e) { + std::clog << "unhandled request error: " << e.what() << "\n"; + send_all(client, error_response(500, "internal_error", + "internal error", + std::to_string(request_n.load()))); + live_del(client); + ::close(client); + } catch (...) { + live_del(client); + ::close(client); + } + } + }); + } + + std::thread signal_thread([&]() { + int sig = 0; + if (sigwait(&set, &sig) != 0) { + return; + } + g_draining.store(true); + int drain_seconds = 2; + if (const char* env = std::getenv("DRAIN_SECONDS")) { + if (*env) { + drain_seconds = std::atoi(env); + if (drain_seconds < 0) { + drain_seconds = 0; + } else if (drain_seconds > 30) { + drain_seconds = 30; + } + } + } + std::clog << "draining: /health/ready is 503 for " + << drain_seconds << "s before listen socket closes\n"; + if (drain_seconds > 0) { + ::sleep(static_cast(drain_seconds)); + } + g_stop.store(true); + const int lfd = g_listen.load(); + if (lfd >= 0) { + ::shutdown(lfd, SHUT_RDWR); + } + }); + + for (;;) { + const int client = ::accept(fd, nullptr, nullptr); + if (client < 0) { + if (g_stop.load()) { + std::clog << "shutting down\n"; + break; + } + std::cerr << "accept failed\n"; + break; + } + set_timeouts(client); + live_add(client); + { + std::lock_guard lk(q_mu); + q.push(client); + } + q_cv.notify_one(); + } + { + std::lock_guard lk(q_mu); + g_stop.store(true); + } + q_cv.notify_all(); + for (auto& t : workers) { + t.join(); + } + signal_thread.detach(); + + ::close(fd); + std::clog << "stopped\n"; + return 0; +} \ No newline at end of file diff --git a/src/message_repo.cpp b/src/message_repo.cpp new file mode 100644 index 0000000..5adb123 --- /dev/null +++ b/src/message_repo.cpp @@ -0,0 +1,297 @@ +#include "message_repo.hpp" +#include "cursor.hpp" + +#include + +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include + +namespace { + +std::string make_uuid() { + static std::mutex rng_mu; + static std::mt19937_64 rng{std::random_device{}()}; + std::uniform_int_distribution d16(0, 0xffff); + std::uniform_int_distribution d32(0, 0xffffffffu); + std::lock_guard lock(rng_mu); + std::ostringstream out; + out << std::hex << std::setfill('0'); + out << std::setw(8) << d32(rng); + out << '-' << std::setw(4) << d16(rng); + out << '-' << std::setw(4) << ((d16(rng) & 0x0fff) | 0x4000); + out << '-' << std::setw(4) << ((d16(rng) & 0x3fff) | 0x8000); + out << '-' << std::setw(4) << d16(rng) << std::setw(8) << d32(rng); + return out.str(); +} + +std::string sha256_hex(const std::string& s) { + unsigned char out[crypto_hash_sha256_BYTES]; + crypto_hash_sha256(out, reinterpret_cast(s.data()), s.size()); + static const char hex[] = "0123456789abcdef"; + std::string r; + r.resize(sizeof(out) * 2); + for (std::size_t i = 0; i < sizeof(out); ++i) { + r[i * 2] = hex[out[i] >> 4]; + r[i * 2 + 1] = hex[out[i] & 0x0f]; + } + return r; +} + +std::string epoch_to_rfc3339(long long epoch) { + const std::time_t t = static_cast(epoch); + std::tm tm{}; + gmtime_r(&t, &tm); + std::ostringstream out; + out << std::put_time(&tm, "%Y-%m-%dT%H:%M:%SZ"); + return out.str(); +} + +std::string now_epoch_str() { + const auto now = std::chrono::system_clock::now(); + const auto secs = std::chrono::duration_cast( + now.time_since_epoch()).count(); + return std::to_string(secs); +} + +Message row_to_message(const pqxx::row& r) { + Message m; + m.id = r["id"].as(); + m.chat_id = r["chat_id"].as(); + m.sender_id = r["sender_id"].as(); + m.text = r["text"].as(); + m.created_at = epoch_to_rfc3339(r["created_at_epoch"].as()); + return m; +} + +constexpr const char* kMessageSelect = + "id, chat_id, sender_id, text, " + "EXTRACT(EPOCH FROM created_at)::bigint AS created_at_epoch"; + +// Lab3 принимает только text. Отсутствующий attachment_ids равен []. +// Порядок ключей JSON в хеш не входит: сравнивается семантика тела. +std::string canonical_message_body(const std::string& text) { + return "text=" + text + "\nattachment_ids="; +} + +int idempotency_ttl_seconds() { + const char* env = std::getenv("IDEMPOTENCY_TTL_SECONDS"); + if (env == nullptr || *env == '\0') { + return 86400; + } + try { + const int v = std::stoi(env); + if (v <= 0) { + return 86400; + } + return v; + } catch (...) { + return 86400; + } +} + +Message insert_message(pqxx::work& tx, + const std::string& chat_id, + const std::string& sender_id, + const std::string& text) { + const std::string id = make_uuid(); + const std::string created = now_epoch_str(); + auto r = tx.exec( + "INSERT INTO messages (id, chat_id, sender_id, text, created_at) " + "VALUES ($1, $2, $3, $4, to_timestamp($5::bigint)) " + "RETURNING " + std::string(kMessageSelect), + pqxx::params{id, chat_id, sender_id, text, created}); + return row_to_message(r[0]); +} + +bool insert_idempotency_key(pqxx::work& tx, + const std::string& user_id, + const std::string& chat_id, + const std::string& idem_key, + const std::string& request_hash, + const std::string& message_id) { + auto inserted = tx.exec( + "INSERT INTO idempotency_keys " + "(user_id, chat_id, key, request_hash, message_id) " + "VALUES ($1, $2, $3, $4, $5) " + "ON CONFLICT (user_id, chat_id, key) DO NOTHING " + "RETURNING message_id", + pqxx::params{user_id, chat_id, idem_key, request_hash, message_id}); + return !inserted.empty(); +} + +Message load_message(pqxx::work& tx, const std::string& message_id) { + auto r = tx.exec( + "SELECT " + std::string(kMessageSelect) + " FROM messages WHERE id = $1", + pqxx::params{message_id}); + if (r.empty()) { + throw std::runtime_error("idempotent message row is missing"); + } + return row_to_message(r[0]); +} + +} + +std::optional MessageRepo::create(const std::string& chat_id, + const std::string& sender_id, + const std::string& text) { + auto lease = pool_.acquire(); + pqxx::work tx(*lease); + + auto member_check = tx.exec( + "SELECT 1 FROM chat_members WHERE chat_id = $1 AND user_id = $2", + pqxx::params{chat_id, sender_id}); + if (member_check.empty()) { + tx.commit(); + return std::nullopt; + } + + const std::string id = make_uuid(); + const std::string created = now_epoch_str(); + + auto r = tx.exec( + "INSERT INTO messages (id, chat_id, sender_id, text, created_at) " + "VALUES ($1, $2, $3, $4, to_timestamp($5::bigint)) " + "RETURNING " + std::string(kMessageSelect), + pqxx::params{id, chat_id, sender_id, text, created}); + + tx.commit(); + return row_to_message(r[0]); +} + +std::optional MessageRepo::list_page( + const std::string& chat_id, + int limit, + const std::optional& cursor) { + + std::optional cur; + if (cursor) { + cur = parse_cursor(*cursor); + if (!cur) { + return std::nullopt; + } + } + + auto lease = pool_.acquire(); + pqxx::work tx(*lease); + + if (cur) { + auto owner_check = tx.exec( + "SELECT 1 FROM messages WHERE id = $1 AND chat_id = $2", + pqxx::params{cur->id, chat_id}); + if (owner_check.empty()) { + tx.commit(); + return std::nullopt; + } + } + + std::string sql = + "SELECT " + std::string(kMessageSelect) + ", " + kCreatedUsSql + " " + "FROM messages " + "WHERE chat_id = $1 "; + if (cur) { + sql += "AND (created_at, id) > (" + std::string(kCursorTimestampSql) + ", $4::uuid) "; + } + sql += "ORDER BY created_at ASC, id ASC LIMIT $2"; + + pqxx::result r; + if (cur) { + r = tx.exec(sql, pqxx::params{chat_id, limit + 1, cur->created_us, cur->id}); + } else { + r = tx.exec(sql, pqxx::params{chat_id, limit + 1}); + } + + MessagePage page; + const bool has_more = (static_cast(r.size()) > limit); + const int take = has_more ? limit : static_cast(r.size()); + page.items.reserve(take); + for (int i = 0; i < take; ++i) { + page.items.push_back(row_to_message(r[static_cast(i)])); + } + + if (has_more && take > 0) { + const auto& last = r[static_cast(take - 1)]; + page.next_cursor = make_cursor(last["created_us"].as(), + last["id"].as()); + } + + tx.commit(); + return page; +} + +CreateResult MessageRepo::create_idempotent(const std::string& chat_id, + const std::string& sender_id, + const std::string& text, + const std::string& idem_key) { + const int ttl = idempotency_ttl_seconds(); + const std::string hash = sha256_hex(canonical_message_body(text)); + + for (int attempt = 0; attempt < 3; ++attempt) { + { + auto lease = pool_.acquire(); + pqxx::work tx(*lease); + + auto member_check = tx.exec( + "SELECT 1 FROM chat_members WHERE chat_id = $1 AND user_id = $2", + pqxx::params{chat_id, sender_id}); + if (member_check.empty()) { + tx.commit(); + return CreateResult{CreateResult::Status::NotFound, std::nullopt}; + } + + const Message created = insert_message(tx, chat_id, sender_id, text); + if (insert_idempotency_key(tx, sender_id, chat_id, idem_key, hash, + created.id)) { + tx.commit(); + return CreateResult{CreateResult::Status::Created, created}; + } + } + + auto lease = pool_.acquire(); + pqxx::work tx(*lease); + auto existing = tx.exec( + "SELECT request_hash, message_id, " + "EXTRACT(EPOCH FROM (now() - created_at))::bigint AS age_seconds " + "FROM idempotency_keys " + "WHERE user_id = $1 AND chat_id = $2 AND key = $3 " + "FOR UPDATE", + pqxx::params{sender_id, chat_id, idem_key}); + if (existing.empty()) { + tx.commit(); + continue; + } + + const std::string existing_hash = existing[0]["request_hash"].as(); + const long long age = existing[0]["age_seconds"].as(); + const std::string message_id = existing[0]["message_id"].as(); + if (age < ttl) { + if (existing_hash != hash) { + tx.commit(); + return CreateResult{CreateResult::Status::KeyConflict, std::nullopt}; + } + const Message replayed = load_message(tx, message_id); + tx.commit(); + return CreateResult{CreateResult::Status::Replayed, replayed}; + } + + tx.exec( + "DELETE FROM idempotency_keys " + "WHERE user_id = $1 AND chat_id = $2 AND key = $3", + pqxx::params{sender_id, chat_id, idem_key}); + const Message created = insert_message(tx, chat_id, sender_id, text); + if (insert_idempotency_key(tx, sender_id, chat_id, idem_key, hash, + created.id)) { + tx.commit(); + return CreateResult{CreateResult::Status::Created, created}; + } + } + + throw std::runtime_error("idempotency retry exhausted"); +} \ No newline at end of file diff --git a/src/message_repo.hpp b/src/message_repo.hpp new file mode 100644 index 0000000..932a1db --- /dev/null +++ b/src/message_repo.hpp @@ -0,0 +1,37 @@ +#pragma once + +#include "db.hpp" +#include "models.hpp" + +#include +#include +#include + + +struct CreateResult { + enum class Status { Created, Replayed, NotFound, KeyConflict }; + Status status; + std::optional message; +}; + +class MessageRepo { +public: + explicit MessageRepo(PgPool& pool) : pool_(pool) {} + + std::optional create(const std::string& chat_id, + const std::string& sender_id, + const std::string& text); + + std::optional list_page( + const std::string& chat_id, + int limit, + const std::optional& cursor); + + CreateResult create_idempotent(const std::string& chat_id, + const std::string& sender_id, + const std::string& text, + const std::string& idem_key); + +private: + PgPool& pool_; +}; \ No newline at end of file diff --git a/src/models.hpp b/src/models.hpp new file mode 100644 index 0000000..87c3fe3 --- /dev/null +++ b/src/models.hpp @@ -0,0 +1,38 @@ +#pragma once + +#include +#include +#include + +struct User { + std::string id; + std::string username; + std::string display_name; + std::string password_hash; + std::string created_at; +}; + +struct Chat { + std::string id; + std::string title; + std::vector member_ids; + std::string created_at; +}; + +struct Message { + std::string id; + std::string chat_id; + std::string sender_id; + std::string text; + std::string created_at; +}; + +struct MessagePage { + std::vector items; + std::optional next_cursor; +}; + +struct ChatPage { + std::vector items; + std::optional next_cursor; +}; \ No newline at end of file diff --git a/src/pg_session_repo.cpp b/src/pg_session_repo.cpp new file mode 100644 index 0000000..507f2dd --- /dev/null +++ b/src/pg_session_repo.cpp @@ -0,0 +1,66 @@ +#include "pg_session_repo.hpp" + +#include +#include + +#include +#include +#include + +namespace { + +std::string random_token_hex() { + unsigned char buf[32]; + randombytes_buf(buf, sizeof(buf)); + static const char hex[] = "0123456789abcdef"; + std::string out; + out.resize(sizeof(buf) * 2); + for (std::size_t i = 0; i < sizeof(buf); ++i) { + out[i * 2] = hex[buf[i] >> 4]; + out[i * 2 + 1] = hex[buf[i] & 0x0f]; + } + return out; +} + +std::int64_t now_unix() { + return static_cast(std::time(nullptr)); +} + +} + +ISessionRepo::Created PgSessionRepo::create(const std::string& user_id) { + const std::string token = random_token_hex(); + const std::int64_t exp = now_unix() + ttl_; + + auto lease = pool_.acquire(); + pqxx::work tx(*lease); + tx.exec( + "INSERT INTO sessions (token, user_id, expires_at) " + "VALUES ($1, $2, to_timestamp($3::bigint))", + pqxx::params{token, user_id, exp}); + tx.commit(); + + return Created{token, exp}; +} + +std::optional PgSessionRepo::lookup(const std::string& token) { + auto lease = pool_.acquire(); + pqxx::work tx(*lease); + auto r = tx.exec( + "SELECT user_id FROM sessions " + "WHERE token = $1 AND expires_at > now()", + pqxx::params{token}); + tx.commit(); + if (r.empty()) return std::nullopt; + return r[0]["user_id"].as(); +} + +bool PgSessionRepo::revoke(const std::string& token) { + auto lease = pool_.acquire(); + pqxx::work tx(*lease); + auto r = tx.exec( + "DELETE FROM sessions WHERE token = $1", + pqxx::params{token}); + tx.commit(); + return r.affected_rows() > 0; +} \ No newline at end of file diff --git a/src/pg_session_repo.hpp b/src/pg_session_repo.hpp new file mode 100644 index 0000000..ed005fe --- /dev/null +++ b/src/pg_session_repo.hpp @@ -0,0 +1,18 @@ +#pragma once + +#include "db.hpp" +#include "session_repo_base.hpp" + +class PgSessionRepo : public ISessionRepo { +public: + PgSessionRepo(PgPool& pool, int ttl_seconds) + : pool_(pool), ttl_(ttl_seconds) {} + + Created create(const std::string& user_id) override; + std::optional lookup(const std::string& token) override; + bool revoke(const std::string& token) override; + +private: + PgPool& pool_; + int ttl_; +}; \ No newline at end of file diff --git a/src/redis_pool.cpp b/src/redis_pool.cpp new file mode 100644 index 0000000..035b5f2 --- /dev/null +++ b/src/redis_pool.cpp @@ -0,0 +1,216 @@ +#include "redis_pool.hpp" +#include "errors.hpp" + +#include +#include +#include +#include + +namespace { + +constexpr timeval kConnectTimeout{2, 0}; +constexpr timeval kCommandTimeout{2, 0}; +constexpr auto kAcquireTimeout = std::chrono::seconds(3); + +struct RedisUrl { + std::string host = "127.0.0.1"; + int port = 6379; + std::string password; + int db = 0; +}; + +RedisUrl parse_redis_url(const std::string& url) { + RedisUrl out; + const std::string prefix = "redis://"; + if (url.compare(0, prefix.size(), prefix) != 0) { + throw std::runtime_error("redis url must start with redis://"); + } + std::string rest = url.substr(prefix.size()); + + const auto slash = rest.find('/'); + if (slash != std::string::npos) { + const std::string db_str = rest.substr(slash + 1); + rest.resize(slash); + if (!db_str.empty()) { + out.db = std::atoi(db_str.c_str()); + } + } + + const auto at = rest.find('@'); + std::string hostport = rest; + if (at != std::string::npos) { + const std::string creds = rest.substr(0, at); + hostport = rest.substr(at + 1); + const auto colon = creds.find(':'); + if (colon != std::string::npos) { + out.password = creds.substr(colon + 1); + } else { + out.password = creds; + } + } + + const auto colon = hostport.find(':'); + if (colon == std::string::npos) { + out.host = hostport; + } else { + out.host = hostport.substr(0, colon); + out.port = std::atoi(hostport.substr(colon + 1).c_str()); + } + + return out; +} + +redisContext* make_connection(const RedisUrl& u) { + redisContext* c = redisConnectWithTimeout(u.host.c_str(), u.port, kConnectTimeout); + if (c == nullptr) { + throw std::runtime_error("redisConnect: allocation failed"); + } + if (c->err) { + const std::string err = c->errstr; + redisFree(c); + throw DependencyUnavailable("redisConnect failed: " + err); + } + if (redisSetTimeout(c, kCommandTimeout) != REDIS_OK) { + redisFree(c); + throw DependencyUnavailable("redisSetTimeout failed"); + } + if (!u.password.empty()) { + redisReply* r = static_cast( + redisCommand(c, "AUTH %s", u.password.c_str())); + if (r == nullptr) { + redisFree(c); + throw std::runtime_error("redis AUTH: no reply"); + } + const bool ok = (r->type == REDIS_REPLY_STATUS); + freeReplyObject(r); + if (!ok) { + redisFree(c); + throw std::runtime_error("redis AUTH failed"); + } + } + if (u.db != 0) { + redisReply* r = static_cast( + redisCommand(c, "SELECT %d", u.db)); + if (r == nullptr) { + redisFree(c); + throw std::runtime_error("redis SELECT: no reply"); + } + const bool ok = (r->type == REDIS_REPLY_STATUS); + freeReplyObject(r); + if (!ok) { + redisFree(c); + throw std::runtime_error("redis SELECT failed"); + } + } + return c; +} + +} + +RedisPool::RedisPool(std::string url, std::size_t n) + : url_(std::move(url)) { + if (n == 0) { + throw std::runtime_error("RedisPool: n must be > 0"); + } + const RedisUrl parsed = parse_redis_url(url_); + all_.reserve(n); + idle_.reserve(n); + for (std::size_t i = 0; i < n; ++i) { + ConnPtr c(make_connection(parsed)); + idle_.push_back(c.get()); + all_.push_back(std::move(c)); + } +} + +RedisPool::~RedisPool() { + { + std::lock_guard lk(mu_); + shutting_down_ = true; + } + cv_.notify_all(); +} + +RedisPool::Lease::Lease(RedisPool& pool) + : pool_(&pool), ctx_(pool.take()) {} + +RedisPool::Lease::~Lease() { + if (pool_ != nullptr && ctx_ != nullptr) { + pool_->give_back(ctx_); + } +} + +RedisPool::Lease::Lease(Lease&& other) noexcept + : pool_(other.pool_), ctx_(other.ctx_) { + other.pool_ = nullptr; + other.ctx_ = nullptr; +} + +RedisPool::Lease RedisPool::acquire() { + return Lease(*this); +} + +redisContext* RedisPool::take() { + std::unique_lock lk(mu_); + if (!cv_.wait_for(lk, kAcquireTimeout, + [&]() { return shutting_down_ || !idle_.empty(); })) { + throw DependencyUnavailable("redis pool: acquire timeout"); + } + if (shutting_down_) { + throw DependencyUnavailable("redis pool is shutting down"); + } + redisContext* c = idle_.back(); + idle_.pop_back(); + lk.unlock(); + + bool alive = false; + if (!c->err) { + redisReply* r = static_cast(redisCommand(c, "PING")); + if (r != nullptr && r->type == REDIS_REPLY_STATUS) { + alive = true; + } + if (r != nullptr) freeReplyObject(r); + } + if (alive) { + return c; + } + + ConnPtr fresh; + try { + fresh.reset(make_connection(parse_redis_url(url_))); + } catch (const std::exception& e) { + // Слот возвращается в пул, иначе после нескольких неудач пул опустеет навсегда. + give_back(c); + throw DependencyUnavailable(std::string("redis reconnect failed: ") + e.what()); + } + + std::lock_guard lk2(mu_); + for (auto& up : all_) { + if (up.get() == c) { + up = std::move(fresh); + return up.get(); + } + } + throw std::logic_error("RedisPool: connection not owned by pool"); +} + +void RedisPool::give_back(redisContext* c) { + { + std::lock_guard lk(mu_); + idle_.push_back(c); + } + cv_.notify_one(); +} + +bool RedisPool::ping() { + try { + auto lease = acquire(); + redisContext* c = lease.ctx(); + redisReply* r = static_cast(redisCommand(c, "PING")); + if (r == nullptr) return false; + const bool ok = (r->type == REDIS_REPLY_STATUS); + freeReplyObject(r); + return ok; + } catch (...) { + return false; + } +} \ No newline at end of file diff --git a/src/redis_pool.hpp b/src/redis_pool.hpp new file mode 100644 index 0000000..0032315 --- /dev/null +++ b/src/redis_pool.hpp @@ -0,0 +1,59 @@ +#pragma once + +#include + +#include +#include +#include +#include +#include +#include + +class RedisPool { +public: + RedisPool(std::string url, std::size_t n); + ~RedisPool(); + + RedisPool(const RedisPool&) = delete; + RedisPool& operator=(const RedisPool&) = delete; + + class Lease { + public: + explicit Lease(RedisPool& pool); + ~Lease(); + Lease(Lease&& other) noexcept; + Lease& operator=(Lease&&) = delete; + Lease(const Lease&) = delete; + Lease& operator=(const Lease&) = delete; + + redisContext* ctx() const { return ctx_; } + + private: + RedisPool* pool_; + redisContext* ctx_; + }; + + Lease acquire(); + + bool ping(); + +private: + friend class Lease; + + struct RedisDeleter { + void operator()(redisContext* c) const noexcept { + if (c != nullptr) ::redisFree(c); + } + }; + using ConnPtr = std::unique_ptr; + + redisContext* take(); + void give_back(redisContext* c); + + std::string url_; + std::vector all_; + std::vector idle_; + std::mutex mu_; + std::condition_variable cv_; + bool shutting_down_ = false; +}; \ No newline at end of file diff --git a/src/session_repo.cpp b/src/session_repo.cpp new file mode 100644 index 0000000..28f1edb --- /dev/null +++ b/src/session_repo.cpp @@ -0,0 +1,87 @@ +#include "session_repo.hpp" +#include "errors.hpp" + +#include + +#include +#include +#include +#include + +namespace { + +std::string random_token_hex() { + unsigned char buf[32]; + randombytes_buf(buf, sizeof(buf)); + static const char hex[] = "0123456789abcdef"; + std::string out; + out.resize(sizeof(buf) * 2); + for (std::size_t i = 0; i < sizeof(buf); ++i) { + out[i * 2] = hex[buf[i] >> 4]; + out[i * 2 + 1] = hex[buf[i] & 0x0f]; + } + return out; +} + +std::int64_t now_unix() { + return static_cast(std::time(nullptr)); +} + +redisReply* check_reply(redisContext* c, redisReply* r) { + if (r == nullptr) { + const std::string err = c->err ? c->errstr : "no reply"; + throw DependencyUnavailable("redis command failed: " + err); + } + return r; +} + +} + +ISessionRepo::Created SessionRepo::create(const std::string& user_id) { + const std::string token = random_token_hex(); + const std::int64_t exp = now_unix() + ttl_; + + auto lease = pool_.acquire(); + redisContext* c = lease.ctx(); + + redisReply* r = static_cast( + redisCommand(c, "SET session:%s %s EX %d", + token.c_str(), user_id.c_str(), ttl_)); + check_reply(c, r); + const bool ok = (r->type == REDIS_REPLY_STATUS); + freeReplyObject(r); + if (!ok) { + throw std::runtime_error("redis SET returned non-status"); + } + + return Created{token, exp}; +} + +std::optional SessionRepo::lookup(const std::string& token) { + auto lease = pool_.acquire(); + redisContext* c = lease.ctx(); + + redisReply* r = static_cast( + redisCommand(c, "GET session:%s", token.c_str())); + check_reply(c, r); + + std::optional out; + if (r->type == REDIS_REPLY_STRING) { + out = std::string(r->str, r->len); + } + freeReplyObject(r); + return out; +} + +bool SessionRepo::revoke(const std::string& token) { + auto lease = pool_.acquire(); + redisContext* c = lease.ctx(); + + redisReply* r = static_cast( + redisCommand(c, "DEL session:%s", token.c_str())); + check_reply(c, r); + + const bool existed = (r->type == REDIS_REPLY_INTEGER && r->integer == 1); + freeReplyObject(r); + return existed; +} \ No newline at end of file diff --git a/src/session_repo.hpp b/src/session_repo.hpp new file mode 100644 index 0000000..550eae6 --- /dev/null +++ b/src/session_repo.hpp @@ -0,0 +1,18 @@ +#pragma once + +#include "redis_pool.hpp" +#include "session_repo_base.hpp" + +class SessionRepo : public ISessionRepo { +public: + SessionRepo(RedisPool& pool, int ttl_seconds) + : pool_(pool), ttl_(ttl_seconds) {} + + Created create(const std::string& user_id) override; + std::optional lookup(const std::string& token) override; + bool revoke(const std::string& token) override; + +private: + RedisPool& pool_; + int ttl_; +}; \ No newline at end of file diff --git a/src/session_repo_base.hpp b/src/session_repo_base.hpp new file mode 100644 index 0000000..4a685ba --- /dev/null +++ b/src/session_repo_base.hpp @@ -0,0 +1,22 @@ +#pragma once + +#include +#include +#include + + +class ISessionRepo { +public: + virtual ~ISessionRepo() = default; + + struct Created { + std::string token; + std::int64_t expires_at; // unix-время в секундах UTC + }; + + virtual Created create(const std::string& user_id) = 0; + + virtual std::optional lookup(const std::string& token) = 0; + + virtual bool revoke(const std::string& token) = 0; +}; \ No newline at end of file diff --git a/src/user_repo.cpp b/src/user_repo.cpp new file mode 100644 index 0000000..2cc4bc9 --- /dev/null +++ b/src/user_repo.cpp @@ -0,0 +1,100 @@ +#include "user_repo.hpp" + +#include + +#include +#include +#include +#include +#include +#include + +namespace { + +std::string make_uuid() { + static std::mt19937_64 rng{std::random_device{}()}; + std::uniform_int_distribution d16(0, 0xffff); + std::uniform_int_distribution d32(0, 0xffffffffu); + std::ostringstream out; + out << std::hex << std::setfill('0'); + out << std::setw(8) << d32(rng); + out << '-' << std::setw(4) << d16(rng); + out << '-' << std::setw(4) << ((d16(rng) & 0x0fff) | 0x4000); + out << '-' << std::setw(4) << ((d16(rng) & 0x3fff) | 0x8000); + out << '-' << std::setw(4) << d16(rng) << std::setw(8) << d32(rng); + return out.str(); +} + +std::string epoch_to_rfc3339(long long epoch) { + const std::time_t t = static_cast(epoch); + std::tm tm{}; + gmtime_r(&t, &tm); + std::ostringstream out; + out << std::put_time(&tm, "%Y-%m-%dT%H:%M:%SZ"); + return out.str(); +} + +std::string now_epoch_str() { + const auto now = std::chrono::system_clock::now(); + const auto secs = std::chrono::duration_cast( + now.time_since_epoch()).count(); + return std::to_string(secs); +} + +User row_to_user(const pqxx::row& r) { + User u; + u.id = r["id"].as(); + u.username = r["username"].as(); + u.display_name = r["display_name"].as(); + u.password_hash = r["password_hash"].as(); + u.created_at = epoch_to_rfc3339(r["created_at_epoch"].as()); + return u; +} + +constexpr const char* kUserColumns = + "id, username, display_name, password_hash, " + "EXTRACT(EPOCH FROM created_at)::bigint AS created_at_epoch"; + +} + +std::optional UserRepo::create(const std::string& username, + const std::string& display_name, + const std::string& password_hash) { + auto lease = pool_.acquire(); + pqxx::work tx(*lease); + try { + const std::string id = make_uuid(); + auto r = tx.exec( + "INSERT INTO users (id, username, display_name, password_hash, created_at) " + "VALUES ($1, $2, $3, $4, to_timestamp($5::bigint)) " + "RETURNING " + std::string(kUserColumns), + pqxx::params{id, username, display_name, password_hash, now_epoch_str()}); + tx.commit(); + return row_to_user(r[0]); + } catch (const pqxx::unique_violation&) { + tx.abort(); + return std::nullopt; + } +} + +std::optional UserRepo::find_by_id(const std::string& id) { + auto lease = pool_.acquire(); + pqxx::work tx(*lease); + auto r = tx.exec( + "SELECT " + std::string(kUserColumns) + " FROM users WHERE id = $1", + pqxx::params{id}); + tx.commit(); + if (r.empty()) return std::nullopt; + return row_to_user(r[0]); +} + +std::optional UserRepo::find_by_username(const std::string& username) { + auto lease = pool_.acquire(); + pqxx::work tx(*lease); + auto r = tx.exec( + "SELECT " + std::string(kUserColumns) + " FROM users WHERE username = $1", + pqxx::params{username}); + tx.commit(); + if (r.empty()) return std::nullopt; + return row_to_user(r[0]); +} \ No newline at end of file diff --git a/src/user_repo.hpp b/src/user_repo.hpp new file mode 100644 index 0000000..b8cbada --- /dev/null +++ b/src/user_repo.hpp @@ -0,0 +1,22 @@ +#pragma once + +#include "db.hpp" +#include "models.hpp" + +#include +#include + +class UserRepo { +public: + explicit UserRepo(PgPool& pool) : pool_(pool) {} + + std::optional create(const std::string& username, + const std::string& display_name, + const std::string& password_hash); + + std::optional find_by_id(const std::string& id); + std::optional find_by_username(const std::string& username); + +private: + PgPool& pool_; +}; \ No newline at end of file diff --git a/student-tests/idempotency_parallel.py b/student-tests/idempotency_parallel.py new file mode 100644 index 0000000..32ffc8c --- /dev/null +++ b/student-tests/idempotency_parallel.py @@ -0,0 +1,114 @@ +#!/usr/bin/env python3 +"""Same Idempotency-Key from several threads, then the same key in another chat.""" +import base64 +import json +import os +import threading +import urllib.error +import urllib.request +import uuid + +BASE = os.environ.get("BASE_URL", "http://localhost:8080").rstrip("/") + + +def call(method, path, expected, body=None, headers=None): + h = {"Accept": "application/json"} + raw = None + if body is not None: + raw = json.dumps(body, ensure_ascii=False).encode() + h["Content-Type"] = "application/json" + h.update(headers or {}) + req = urllib.request.Request(BASE + path, data=raw, headers=h, method=method) + try: + resp = urllib.request.urlopen(req, timeout=10) + except urllib.error.HTTPError as exc: + resp = exc + with resp: + data = resp.read() + payload = json.loads(data) if data else None + if resp.code != expected: + raise SystemExit( + method + " " + path.split("?")[0] + ": expected " + + str(expected) + ", got " + str(resp.code) + ) + return payload, resp.headers.get("X-Instance-Id") + + +def main(): + username = "u_par_" + uuid.uuid4().hex[:12] + password = "T3st-" + uuid.uuid4().hex + user, _ = call( + "POST", "/api/v1/users", 201, + {"username": username, "display_name": "Параллельный", "password": password}, + ) + basic = base64.b64encode((username + ":" + password).encode()).decode() + session, _ = call( + "POST", "/api/v1/auth/sessions", 201, + headers={"Authorization": "Basic " + basic}, + ) + auth = {"Authorization": "Bearer " + session["token"]} + chat_a, _ = call( + "POST", "/api/v1/chats", 201, + {"title": "A", "member_ids": [user["id"]]}, + auth, + ) + chat_b, _ = call( + "POST", "/api/v1/chats", 201, + {"title": "B", "member_ids": [user["id"]]}, + auth, + ) + key = "same-" + uuid.uuid4().hex + text = "одно сообщение " + key + results = [] + errors = [] + lock = threading.Lock() + + def post(): + try: + payload, instance = call( + "POST", "/api/v1/chats/" + chat_a["id"] + "/messages", 201, + {"text": text}, + {**auth, "Idempotency-Key": key}, + ) + with lock: + results.append((payload["id"], instance)) + except SystemExit as exc: + with lock: + errors.append(str(exc)) + + threads = [threading.Thread(target=post) for _ in range(8)] + for t in threads: + t.start() + for t in threads: + t.join() + if errors: + raise SystemExit("parallel post failed: " + "; ".join(errors)) + ids = {item[0] for item in results} + instances = {item[1] for item in results} + if len(ids) != 1: + raise SystemExit("parallel retry created " + str(len(ids)) + " messages") + other, _ = call( + "POST", "/api/v1/chats/" + chat_b["id"] + "/messages", 201, + {"text": text}, + {**auth, "Idempotency-Key": key}, + ) + if other["id"] == next(iter(ids)): + raise SystemExit("same key in another chat reused the first message") + conflict, _ = call( + "POST", "/api/v1/chats/" + chat_a["id"] + "/messages", 409, + {"text": "другое тело"}, + {**auth, "Idempotency-Key": key}, + ) + if conflict["error"]["code"] != "conflict": + raise SystemExit("conflict code mismatch") + print(json.dumps({ + "parallel_responses": len(results), + "unique_message_ids": len(ids), + "instances_seen": len(instances), + "other_chat_independent": True, + "different_body": 409, + }, ensure_ascii=False)) + + +if __name__ == "__main__": + main()