From cddd65fe4eabe3ffe175a23f5454f6c9546f763a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=D0=90=D0=BB=D0=B8=D1=85=D0=B0=D0=BD=20=D0=90=D0=B1=D0=B4?= =?UTF-8?q?=D1=83=D1=80=D0=B0=D1=88=D0=B8=D0=B4=D0=BE=D0=B2?= Date: Fri, 30 Oct 2026 14:09:36 +0300 Subject: [PATCH] =?UTF-8?q?=D0=9B=D0=A0=202:=20PostgreSQL,=20Bearer-=D1=81?= =?UTF-8?q?=D0=B5=D1=81=D1=81=D0=B8=D0=B8,=20Valkey=20=D0=B8=20=D0=B8?= =?UTF-8?q?=D1=81=D1=81=D0=BB=D0=B5=D0=B4=D0=BE=D0=B2=D0=B0=D0=BD=D0=B8?= =?UTF-8?q?=D0=B5=20=D0=B2=D0=BE=D1=81=D1=81=D1=82=D0=B0=D0=BD=D0=BE=D0=B2?= =?UTF-8?q?=D0=BB=D0=B5=D0=BD=D0=B8=D1=8F?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .dockerignore | 6 + .env.example | 4 + .github/pull_request_template.md | 32 +- .github/workflows/application.yml | 19 + Dockerfile | 12 + Makefile | 25 +- PR_DESCRIPTION.md | 20 + REPORT.md | 213 +- SOLUTION.md | 44 + compose.yaml | 73 + evidence/contracts.txt | 4 + evidence/explain-plans.json | 2252 ++++++++++++++++++ evidence/infrastructure-run.txt | 49 + evidence/infrastructure.json | 49 + evidence/persistence.txt | 3 + evidence/query-measurements.csv | 25 + evidence/research-run.txt | 2 + evidence/research-summary.md | 38 + evidence/research.json | 3627 +++++++++++++++++++++++++++++ evidence/research.png | Bin 0 -> 123802 bytes evidence/smoke.txt | 2 + evidence/student-tests.txt | 17 + infra/SCHEMA.md | 14 + migrations/001_initial.sql | 37 + requirements.txt | 5 + research/README.md | 23 + research/requirements.txt | 3 + research/run.py | 103 + research/summarize.py | 56 + research/worker.py | 156 ++ scripts/bootstrap.py | 30 + scripts/restart.sh | 6 + src/app.py | 104 + src/config.py | 14 + src/http_transport.py | 198 ++ src/migrate.py | 30 + src/store.py | 265 +++ student-tests/clean_clone.py | 52 + student-tests/infrastructure.py | 161 ++ student-tests/test_api.py | 152 ++ 40 files changed, 7890 insertions(+), 35 deletions(-) create mode 100644 .github/workflows/application.yml create mode 100644 Dockerfile create mode 100644 PR_DESCRIPTION.md create mode 100644 SOLUTION.md create mode 100644 compose.yaml create mode 100644 evidence/contracts.txt create mode 100644 evidence/explain-plans.json create mode 100644 evidence/infrastructure-run.txt create mode 100644 evidence/infrastructure.json create mode 100644 evidence/persistence.txt create mode 100644 evidence/query-measurements.csv create mode 100644 evidence/research-run.txt create mode 100644 evidence/research-summary.md create mode 100644 evidence/research.json create mode 100644 evidence/research.png create mode 100644 evidence/smoke.txt create mode 100644 evidence/student-tests.txt create mode 100644 infra/SCHEMA.md create mode 100644 migrations/001_initial.sql create mode 100644 requirements.txt create mode 100644 research/README.md create mode 100644 research/requirements.txt create mode 100644 research/run.py create mode 100644 research/summarize.py create mode 100644 research/worker.py create mode 100644 scripts/bootstrap.py create mode 100755 scripts/restart.sh create mode 100644 src/app.py create mode 100644 src/config.py create mode 100644 src/http_transport.py create mode 100644 src/migrate.py create mode 100644 src/store.py create mode 100644 student-tests/clean_clone.py create mode 100644 student-tests/infrastructure.py create mode 100644 student-tests/test_api.py diff --git a/.dockerignore b/.dockerignore index bc16e55..665fdc0 100644 --- a/.dockerignore +++ b/.dockerignore @@ -18,3 +18,9 @@ __pycache__ node_modules evidence .DS_Store +student-tests +research +build +**/__pycache__ +**/*.py[cod] +*.log diff --git a/.env.example b/.env.example index 714c807..16e2300 100644 --- a/.env.example +++ b/.env.example @@ -9,3 +9,7 @@ DATABASE_URL_FILE=/run/secrets/database_url # Optional on 3, required use on 4 in lab2; Redis OR Valkey: SESSION_STORE=postgres CACHE_URL_FILE=/run/secrets/cache_url +# Published host port: lab1 may continue running on 8080. +HOST_PORT=8082 +PROFILE_CACHE_TTL_SECONDS=300 +DB_POOL_MAX=8 diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md index 8ceefa1..6ef1349 100644 --- a/.github/pull_request_template.md +++ b/.github/pull_request_template.md @@ -1,18 +1,20 @@ -## Лабораторная 2 +# ЛР 2 — БВТ2301 — Абдурашидов — на 5 -Автор / группа: TODO -Целевая оценка (3/4/5): TODO -Трек 5, если заявлен: TODO +Алихан Абдурашидов, БВТ2301. Целевая оценка 5, трек 2 — план запроса и восстановление. -Что реализовано и что перенесено: TODO -Команды запуска из чистого clone: TODO -Результаты проверок и ссылка на REPORT.md: TODO -Ограничения / известные ошибки: TODO -Источники и использование ИИ: TODO +Мессенджер из lab1 перенесён в PostgreSQL: пользователи, чаты, членство, сообщения и действующие сессии переживают рестарт. Добавлены scrypt, Basic-вход, opaque Bearer с expiry/logout, транзакционные миграции, пул соединений и Valkey-кэш публичных профилей с безопасным fallback. -- [ ] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами. -- [ ] Контракт и публичные тесты не ослаблены. -- [ ] make check и make test выполнены; приложен реальный вывод. -- [ ] Сценарии отказов/безопасности своего уровня воспроизведены. -- [ ] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens. -- [ ] README задания сохранён, REPORT.md содержит инструкцию именно моего решения. +Docker Compose запускает весь стенд из репозитория. Исходные contracts/ и публичные tests/ не изменены. Команды: `make up`, `make check test student-test`, `make infra-test`, `make research`. Подробности запуска — SOLUTION.md, архитектура, доказательства и ограничения — REPORT.md. + +Проверено: публичные smoke/persistence, 11 собственных HTTP-тестов, гонки регистрации, 100 сообщений от 10 клиентов, SQL rollback, TTL 2 с, logout, остановка Valkey/PostgreSQL, чистый clone с отдельными volumes. + +Исследование: 100 000 сообщений, неравномерные чаты, 3 индекса, keyset/OFFSET, стоимость committed INSERT и WAL. Для чата 80 000 сообщений p95 поздней страницы снизился с 7,1933 до 0,2545 мс. Backup восстановлен в новый PostgreSQL-контейнер/volume; сверены все counts, 7 samples и SHA-256 всей истории. Запись после снимка ожидаемо не входит в восстановление. + +Источники: собственная lab1, контракт курса, Python stdlib, psycopg, redis-py и официальная документация; matplotlib/NumPy — только рисунок. Ограничения: локальный одиночный PostgreSQL, без HA/PITR; измерения SQL не являются HTTP capacity/SLA. + +- [x] Минимум lab1 сохранён с объявленным переходом на PostgreSQL/Bearer. +- [x] Контракт и публичные тесты не ослаблены. +- [x] Smoke и полный restart выполнены, вывод сохранён. +- [x] Критерии уровня 4 и трек 2 проверены воспроизводимыми сценариями. +- [x] Secrets, volumes, dump и credentials исключены из Git. +- [x] README задания сохранён; REPORT.md заполнен. diff --git a/.github/workflows/application.yml b/.github/workflows/application.yml new file mode 100644 index 0000000..c056554 --- /dev/null +++ b/.github/workflows/application.yml @@ -0,0 +1,19 @@ +name: Python PostgreSQL messenger +on: [push, pull_request] +permissions: + contents: read +jobs: + application: + runs-on: ubuntu-latest + timeout-minutes: 15 + steps: + - uses: actions/checkout@v4 + - uses: actions/setup-python@v5 + with: + python-version: '3.13.12' + - run: python3 student-tests/clean_clone.py + - uses: actions/upload-artifact@v4 + if: always() + with: + name: lab2-evidence + path: evidence/ diff --git a/Dockerfile b/Dockerfile new file mode 100644 index 0000000..bee7797 --- /dev/null +++ b/Dockerfile @@ -0,0 +1,12 @@ +FROM python:3.13.12-slim-bookworm@sha256:a58daefb915e1e03ad48f3ca4df8832065412c5c35cacb9d39f4229184de12b6 +ENV PYTHONUNBUFFERED=1 PYTHONDONTWRITEBYTECODE=1 APP_HOST=0.0.0.0 APP_PORT=8080 +WORKDIR /app +COPY requirements.txt /app/ +RUN pip install --no-cache-dir -r requirements.txt +COPY --chown=10001:10001 src/ /app/src/ +COPY --chown=10001:10001 migrations/ /app/migrations/ +USER 10001:10001 +EXPOSE 8080 +STOPSIGNAL SIGTERM +HEALTHCHECK --interval=5s --timeout=4s --start-period=10s --retries=3 CMD ["python", "src/app.py", "--healthcheck"] +ENTRYPOINT ["python", "src/app.py"] diff --git a/Makefile b/Makefile index 9ecb223..ef4f573 100644 --- a/Makefile +++ b/Makefile @@ -1,5 +1,5 @@ PYTHON ?= python3 -BASE_URL ?= http://localhost:8080 +BASE_URL ?= http://localhost:8082 CA_FILE ?= ACTION_SCRIPT ?= TLS_ARGS = $(if $(CA_FILE),--ca-file "$(CA_FILE)",) @@ -24,3 +24,26 @@ load: test-persistence: @test -n "$(ACTION_SCRIPT)" || (echo "Set ACTION_SCRIPT to your implemented executable restart hook"; exit 2) $(PYTHON) tests/resilience.py --mode persistence --action-script "$(ACTION_SCRIPT)" --base-url "$(BASE_URL)" $(TLS_ARGS) + +.PHONY: bootstrap up down student-test infra-test research +bootstrap: + $(PYTHON) scripts/bootstrap.py + +up: bootstrap + docker compose up -d --build --wait + +down: + docker compose down + +student-test: + BASE_URL="$(BASE_URL)" $(PYTHON) -m unittest discover -s student-tests -p 'test_*.py' -v + +infra-test: + $(PYTHON) student-tests/infrastructure.py + +research: + $(PYTHON) research/run.py + +.PHONY: clean-clone-test +clean-clone-test: + $(PYTHON) student-tests/clean_clone.py diff --git a/PR_DESCRIPTION.md b/PR_DESCRIPTION.md new file mode 100644 index 0000000..6ef1349 --- /dev/null +++ b/PR_DESCRIPTION.md @@ -0,0 +1,20 @@ +# ЛР 2 — БВТ2301 — Абдурашидов — на 5 + +Алихан Абдурашидов, БВТ2301. Целевая оценка 5, трек 2 — план запроса и восстановление. + +Мессенджер из lab1 перенесён в PostgreSQL: пользователи, чаты, членство, сообщения и действующие сессии переживают рестарт. Добавлены scrypt, Basic-вход, opaque Bearer с expiry/logout, транзакционные миграции, пул соединений и Valkey-кэш публичных профилей с безопасным fallback. + +Docker Compose запускает весь стенд из репозитория. Исходные contracts/ и публичные tests/ не изменены. Команды: `make up`, `make check test student-test`, `make infra-test`, `make research`. Подробности запуска — SOLUTION.md, архитектура, доказательства и ограничения — REPORT.md. + +Проверено: публичные smoke/persistence, 11 собственных HTTP-тестов, гонки регистрации, 100 сообщений от 10 клиентов, SQL rollback, TTL 2 с, logout, остановка Valkey/PostgreSQL, чистый clone с отдельными volumes. + +Исследование: 100 000 сообщений, неравномерные чаты, 3 индекса, keyset/OFFSET, стоимость committed INSERT и WAL. Для чата 80 000 сообщений p95 поздней страницы снизился с 7,1933 до 0,2545 мс. Backup восстановлен в новый PostgreSQL-контейнер/volume; сверены все counts, 7 samples и SHA-256 всей истории. Запись после снимка ожидаемо не входит в восстановление. + +Источники: собственная lab1, контракт курса, Python stdlib, psycopg, redis-py и официальная документация; matplotlib/NumPy — только рисунок. Ограничения: локальный одиночный PostgreSQL, без HA/PITR; измерения SQL не являются HTTP capacity/SLA. + +- [x] Минимум lab1 сохранён с объявленным переходом на PostgreSQL/Bearer. +- [x] Контракт и публичные тесты не ослаблены. +- [x] Smoke и полный restart выполнены, вывод сохранён. +- [x] Критерии уровня 4 и трек 2 проверены воспроизводимыми сценариями. +- [x] Secrets, volumes, dump и credentials исключены из Git. +- [x] README задания сохранён; REPORT.md заполнен. diff --git a/REPORT.md b/REPORT.md index e42f2b0..6ae02c7 100644 --- a/REPORT.md +++ b/REPORT.md @@ -1,37 +1,212 @@ # Отчёт — лабораторная 2 -- Автор, группа: TODO -- Целевая оценка; выбранный трек 5, если нужен: TODO -- Commit/PR: TODO после публикации -- Использованные источники, библиотеки и помощь ИИ: TODO +- Автор: Алихан Абдурашидов. Группа: БВТ2301. +- Целевая оценка: **5**, трек 2 «План запроса и восстановление». +- Основа: `mtusi2026/mtusi2026lab2`, commit `65003b61195361aac238f19c9bff0027ca58e09e`. +- Ветка решения: `solution/bvt2301-abdurashidov`. Проверенный commit записывается в `evidence/clean-clone.json`; хеши исходников измерений — в `evidence/research.json`. +- Дата проверок: 30 октября 2026 года. +- Источники и библиотеки: контракт курса, Python stdlib, psycopg 3, redis-py, официальная документация PostgreSQL/Docker/Valkey. matplotlib/NumPy нужны только для рисунка. Собственное Python-решение lab1 использовано как основа HTTP-транспорта; чужие студенческие решения не переносились. + +## Что выполнено + +1. Изучены новый README, COURSE, OpenAPI, семантика сессий, инфраструктурные роли и публичные проверки. Исходный `make check` прошёл; smoke на ещё отсутствовавшем lab2-сервере ожидаемо получил ошибку соединения. +2. До SQL-запросов описаны [таблицы, ограничения, индексы и транзакции](infra/SCHEMA.md). Добавлена версионируемая миграция `001_initial.sql`; повторный запуск проверяет SHA-256 и не дублирует данные. +3. Из lab1 перенесены строгий HTTP/JSON-транспорт, Unicode-валидация, единый формат ошибок, Request-Id и обработка остановки. Память процесса как источник данных заменена PostgreSQL. +4. Добавлены регистрация с scrypt, Basic-вход без JSON body, непрозрачные 256-битные Bearer-токены, абсолютный expiry и logout. Сессии сохраняются в PostgreSQL; X-User-Id не влияет на идентификацию. +5. Подготовлены Dockerfile и Compose с API, PostgreSQL и Valkey, именованным volume, локальными secret-файлами, healthchecks и закреплёнными версиями/digest. +6. Valkey используется как cache-aside неизменяемого публичного профиля с TTL. История и действительность сессии всегда читаются из PostgreSQL; отказ кэша допускает fallback. +7. Добавлены собственные HTTP-тесты, автоматические проверки отказов/expiry/rollback, публичный hook реального перезапуска всех трёх компонентов и проверка отдельного чистого clone. +8. Проведено исследование на трёх изолированных БД по 100 000 сообщений; сравниваются три индекса, keyset/OFFSET и стоимость committed INSERT. Backup восстановлен в отдельный новый PostgreSQL-контейнер с новым volume; сверена вся история. ## Запуск из чистого clone -TODO: версии runtime/образов, prerequisites, команды создания локальных secrets/.env, build, миграций, запуска, ожидания готовности, тестов и остановки. Указать необходимые действия оператора. Не вставлять секреты. Отдельно указать безопасную остановку и команду намеренного удаления учебных данных. +Требуются Git, Docker с Compose, Python 3.11+ и make. Внешняя установленная БД не нужна. Исходный README задания, contracts/ и публичные tests/ сохранены. -## Архитектура и решения +```sh +# В корне checkout решения: +make up +make check test student-test +make infra-test +# Отдельно публичный persistence: +make test-persistence ACTION_SCRIPT=scripts/restart.sh +# Исследование: +make research +``` -TODO: схема процессов/хранилищ, источник истины, транзакционные границы, ограничения. Что перенесено из lab1, что изменено в этой работе. Соответствие переменных из .env.example реальной конфигурации. +`make up` вызывает `scripts/bootstrap.py`: создаются `.env` из примера и случайные локальные credentials только при их отсутствии. Затем `docker compose up -d --build --wait` собирает исходники и ждёт healthcheck. Миграции применяются при старте API до bind HTTP-порта. Оператор не создаёт таблицы вручную и не передаёт пароли в командной строке. + +Приложение слушает `0.0.0.0:8080` внутри контейнера, опубликовано только на `127.0.0.1:8082`. Другие сервисы не публикуют host-порты. 8082 выбран для сосуществования с lab1 на 8080; `make` передаёт BASE_URL явно. При смене HOST_PORT изменить также BASE_URL команд тестов. + +| Компонент | Закреплённая версия | Назначение | +| --- | --- | --- | +| API | Python 3.13.12 slim-bookworm, digest в Dockerfile | HTTP и драйверы, UID 10001, read-only rootfs | +| PostgreSQL | 17.9-bookworm, digest в compose.yaml | Источник истины; persistent postgres_data | +| Valkey | 8.1.3-alpine, digest в compose.yaml | Только профильный кэш; память 64 MB, allkeys-lru | +| psycopg / psycopg-binary | 3.3.6 | Параметризованный SQL и бинарный libpq | +| psycopg-pool | 3.3.1 | Ограниченный потокобезопасный пул | +| redis-py | 6.4.0 | Valkey protocol client | +| typing_extensions | 4.16.0 | Закреплённая зависимость пула | + +Все Python-зависимости приложения закреплены в `requirements.txt`. Dockerfile копирует только исходники и миграции; `.dockerignore` исключает Git, .env, secrets, backups, локальные окружения, тесты, исследования и bytecode. Build/runtime для компилируемого языка здесь неприменимы. + +### Конфигурация и секреты + +| Переменная | Реальное поведение | +| --- | --- | +| APP_HOST / APP_PORT | В Compose фиксированы 0.0.0.0 / 8080, внутренний HTTP bind | +| HOST_PORT | Host published port; по умолчанию 8082 | +| APP_ENV | Метка лабораторного окружения в .env; не переключает хранилище | +| SESSION_TTL_SECONDS | Абсолютный срок сессии, 3600 с по умолчанию; тест отдельно использует 2 с | +| SESSION_STORE | Поддерживается и проверяется postgres; Valkey не является хранилищем сессий | +| PROFILE_CACHE_TTL_SECONDS | TTL публичного профиля, по умолчанию 300 с | +| DB_POOL_MAX | Максимум 8 соединений по умолчанию; допустимо 1–32 | +| DATABASE_URL_FILE / CACHE_URL_FILE | DSN читаются из явно смонтированных `/run/secrets/...` | + +Папка secrets/ имеет режим 0700 на хосте; файлы читаемы сервисными UID только в тех контейнерах, куда явно смонтированы. Compose secrets локального стенда — файловые mounts, не шифрованное secret-хранилище. .env содержит настройки без credentials. Сами пароли/DSN не печатаются и не входят в Git или отчёт. + +```sh +# Остановка с сохранением volume и secret-файлов: +docker compose down +# Возобновление: +docker compose up -d --wait +# Намеренное удаление учебных данных только этого проекта: +docker compose down --volumes +``` + +Удаление volume не удаляет secret-файлы. Удаление/регенерация файлов при сохранённой БД не меняет её пароль автоматически. Секреты следует хранить вместе с инструкцией эксплуатации вне Git. + +## Архитектура и транзакции + +```text +Клиент → HTTP API (Python, один процесс, потоки) + ├→ PostgreSQL: пользователи, чаты, членство, история, + │ хеши сессий/expiry, cursor key, миграции + └→ Valkey: public User по user_id, TTL 300 с +``` + +Реализация хранит `users`, `chats`, `chat_members`, `messages`, `sessions`, `app_settings`, `schema_migrations`. PK/FK, уникальность username и CHECK обеспечивают базовые инварианты. У сообщения составной FK `(chat_id,sender_id)` на участника чата. Индекс членства `(user_id,chat_id)` поддерживает список доступных чатов. Схема и её обоснование сохранены отдельно до SQL-реализации. + +Регистрация атомарно вставляет пользователя, конфликт уникальности возвращает 409. Создание чата и всех участников — одна транзакция; неизвестный участник вызывает FK violation и полный rollback. Отправка сообщения обновляет `last_message_at` чата и вставляет сообщение в одной транзакции. Контекст соединения фиксирует COMMIT до возврата успешного HTTP-ответа; исключения откатывают операцию. SQL-параметры передаются драйверу отдельно от текста запроса. + +Пул: минимум 1, максимум 8 соединений, очередь не более 32 ожидающих, ожидание 2 с. Connect timeout 2 с, statement timeout 2 с, lock timeout 1 с, idle-in-transaction 5 с. Исчерпание пула/таймаут/потеря БД дают 503 без внутренних деталей. Потоки HTTP не являются отдельными независимыми источниками состояния. + +Миграции инициализируются под транзакционной advisory lock; применённые версии и SHA-256 хранятся в БД. Повторное применение не создаёт бизнес-данные. Изменение уже применённого файла обнаруживается; изменение схемы требует новой миграции. Все pending migrations одного запуска фиксируются вместе с созданием постоянного cursor key. + +### Пароли, сессии и доступ + +Пароли: scrypt N=16384, r=8, p=1, dklen=32, случайная соль 16 байт; параметры, соль и hash записаны вместе. Длина 12–128 Unicode code points; пароль кодируется в UTF-8 без усечения, двоеточие допускается. Сравнение constant-time. Для неизвестного username выполняется dummy KDF; текст и challenge 401 совпадают с неверным паролем существующего пользователя. + +`POST /auth/sessions` принимает Basic только в Authorization, без JSON body. Выдаётся `secrets.token_urlsafe(32)` — 256 бит случайности, не UUID и не username. В БД сохраняется SHA-256 токена, user_id и абсолютное expires_at по часам PostgreSQL. Здесь быстрый SHA-256 уместен для случайного высокоэнтропийного токена; пароль обрабатывается медленным password KDF. + +Каждый защищённый запрос проверяет Bearer и expiry в PostgreSQL. Logout удаляет только текущую сессию; другая сессия пользователя остаётся действительной. X-User-Id игнорируется. Сначала аутентификация, затем доступ; чужой/отсутствующий чат одинаково возвращает 404. Пароль, hash и session-данные в User не включаются. HTTP используется только для локального синтетического стенда. + +### Кэш и read-after-write + +Valkey хранит только четыре поля public User: id, username, display_name, created_at. В текущем контракте профили не изменяются, поэтому TTL 300 с и cache miss безопасны; при добавлении UPDATE/DELETE потребуется явная инвалидация/версионирование ключей. Ключ имеет namespace `profile:v1:`. + +Сначала PostgreSQL подтверждает сессию, затем разрешается cache hit профиля. Поэтому cache hit никогда не позволяет обойти expiry или logout. При недоступности Valkey timeout 200 мс, автоматических retry нет: профиль читается из PostgreSQL, cache set может быть пропущен. Потеря всего кэша не теряет сессии. Valkey persistence намеренно выключен: это восстанавливаемый кэш, а не единственное хранилище данных или сессий. + +Сообщения и история вообще не кэшируются. Следующий GET обращается к primary PostgreSQL после завершённого COMMIT записи. Членство тоже проверяется в БД. Это обеспечивает read-after-write без риска устаревшей страницы из Valkey. + +### Пагинация и часы + +Cursor подписан HMAC-SHA256 постоянным ключом из app_settings, включает resource scope и `(created_at,id)`. Он переживает рестарт API/БД, привязан к чату либо текущему пользователю для списка чатов. Неверная подпись/scope — 400; limit 1–100 может меняться между страницами. + +```sql +SELECT id, chat_id, sender_id, text, created_at +FROM messages +WHERE chat_id = $1 AND (created_at, id) > ($2, $3) +ORDER BY created_at, id +LIMIT $4; +``` + +Рабочий индекс — `(chat_id,created_at,id)`. API читает limit+1 строку для определения next_cursor, возвращает только limit. OFFSET в API не используется. Timestamp сообщений монотонен внутри чата: row lock и `greatest(clock_timestamp(), last_message_at + interval '1 microsecond')` защищают порядок конкурентных вставок и откат часов. Время может слегка опережать физические часы; это не распределённые часы. + +Snapshot isolation между HTTP-страницами не обещается. Подтверждённое между страницами новое сообщение может попасть в последующие страницы. Отсутствие повторов гарантируется для неизменной истории. Для создаваемых конкурентно чатов порядок определяется парой, но страницы не являются снимком всех будущих COMMIT. + +### Health и остановка + +Live проверяет HTTP-процесс. Ready проверяет PostgreSQL; Valkey некритичен, поскольку есть fallback. SIGTERM прекращает приём новых запросов и дренирует потоки; socket timeout 3 с, общий срок 7,5 с с закрытием оставшихся сокетов, stop_grace_period 10 с. Содержимое сообщений, Authorization и DSN не логируются; лог содержит request_id, метод, статус и длительность. ## Доказательства критериев -| Критерий README | Команда/сценарий | Наблюдаемый результат | Файл доказательства | +| Критерий | Команда / сценарий | Результат | Доказательство | | --- | --- | --- | --- | -| Публичный smoke | make test | TODO | TODO | -| Остальные пункты уровня 3 | TODO | TODO | TODO | -| Все пункты уровня 4, если заявлен | TODO | TODO | TODO | -| Выбранный трек 5, если заявлен | TODO | TODO | TODO | +| Целостность контракта и схемы | make check validate PYTHON=.venv/bin/python | PASS | [contracts.txt](evidence/contracts.txt) | +| Обязательный lab2 API | make test | Публичный сценарий PASS | [smoke.txt](evidence/smoke.txt) | +| PostgreSQL, миграции, сессии переживают рестарт | make test-persistence ACTION_SCRIPT=scripts/restart.sh | Тот же токен читает прежние данные | [persistence.txt](evidence/persistence.txt) | +| Все реальные процессы/хранилища перезапущены | make infra-test | StartedAt изменился у API, PostgreSQL и Valkey; volumes не удалены | [infrastructure.json](evidence/infrastructure.json) | +| Valkey используется осмысленно | make infra-test | Есть profile keys с положительным TTL, только public поля; flush/restart восстанавливается | [infrastructure.json](evidence/infrastructure.json) | +| Параметризованные SQL, pool/timeouts | src/store.py; отказ PostgreSQL | 503 примерно за 2,01 с; анонимные запросы не доверены | [store.py](src/store.py), [infrastructure.json](evidence/infrastructure.json) | +| Гонка username | make student-test | 10 одновременных запросов → ровно 1×201 и 9×409 | [student-tests.txt](evidence/student-tests.txt) | +| Rollback составной операции | make student-test; make infra-test | Ошибка неизвестного участника не оставляет чат и членство; количества сверяются в SQL | [student-tests.txt](evidence/student-tests.txt), [clean-clone.json](evidence/clean-clone.json) | +| Конкурентная история | make student-test | 100 сообщений / 10 клиентов, без потерь и дублей | [student-tests.txt](evidence/student-tests.txt) | +| Expiry/logout/неверный пароль | make student-test; make infra-test | 401, отдельный TTL 2 с, другая сессия сохраняется | [student-tests.txt](evidence/student-tests.txt), [infrastructure.json](evidence/infrastructure.json) | +| Отказ Valkey и PostgreSQL | make infra-test | Cache fallback; PG→503; live 200 / ready 503; восстановление с прежней сессией | [infrastructure.json](evidence/infrastructure.json) | +| Индекс и EXPLAIN на ≥10 000 | make research | Измерены 100 000 сообщений; index condition по chat_id и tuple; 50 строк вместо фильтрации 79 900 | [explain-plans.json](evidence/explain-plans.json) | +| Чистый clone / новая БД / воспроизводимость | make clean-clone-test | Отдельные clone, порт, credentials, сеть и volumes; сборка, HTTP и infrastructure проверки | [clean-clone.json](evidence/clean-clone.json), [clean-clone-run.txt](evidence/clean-clone-run.txt) | +| Трек 2: ≥100 000, неравномерные чаты, ≥2 индекса/запроса | make research | 3 индекса × 4 чата × 2 запроса × 30 чтений; 10 write-batch на индекс | [research.json](evidence/research.json), [CSV](evidence/query-measurements.csv) | +| Backup → новое хранилище → сверка | make research | Новый контейнер и volume; 100 000 сообщений, все counts, 7 samples и полный SHA-256 совпали | [research.json](evidence/research.json) | -TODO: добавить отдельную строку для каждого заявленного критерия. PASS без команды и наблюдения не является доказательством. Проверка инфраструктурного hook требует подтверждения, какие реальные процессы/хранилища перезапущены. +`make clean-clone-test` проверяет текущий commit, а не незакоммиченные изменения. Он удаляет только свои одноразовые тестовые volumes. CI workflow приложения добавлен отдельно; удалённый запуск GitHub Actions на Gitea не заявляется. -## Эксперименты и отказы +## Исследование и фактические результаты -TODO: гипотеза, hardware/лимиты, версии, объём данных, профиль нагрузки, concurrency/arrival rate, длительность/прогрев, повторы, успешные RPS, ошибки, p50/p95/p99, CPU/RAM. Сохранить raw summary без tokens и объяснить ограничения измерения. +Гипотеза, полный метод и ограничения: [research/README.md](research/README.md). Аппаратная среда: Apple M4, 16 GiB RAM, Docker Desktop 29.4.3, Linux arm64. PostgreSQL и клиент имеют по 1 CPU / 512 MiB; Valkey — 0,5 CPU / 128 MiB, внутренний cache maxmemory 64 MB. -| Воздействие | Что ожидаем | Что наблюдали | Время восстановления / потеря данных | +Исследуются три отдельных БД с одинаковой схемой и 100 000 сообщениями в чатах 80 000 / 15 000 / 4 000 / 1 000. Структурное отличие — только индекс: `chat_id`, составной keyset, либо covering с INCLUDE. После 3 прогревов выполняется по 30 последовательных чтений; сохраняются все времена и nearest-rank p50/p95/p99. Стоимость записи — 10 реальных транзакций по 1000 сообщений, время включает EXPLAIN ANALYZE и COMMIT. Write-строки после измерения удаляются только в исследовательской БД; VACUUM ANALYZE предшествует чтению. Это не нагрузочный HTTP-тест. + +| Индекс / запрос, чат 80 000 | p50, мс | p95, мс | p99, мс | +| --- | ---: | ---: | ---: | +| chat_id / keyset | 7,0761 | 7,1933 | 7,1945 | +| составной / keyset | 0,2249 | 0,2545 | 0,3508 | +| covering / keyset | 0,1993 | 0,3393 | 0,4040 | +| составной / OFFSET | 6,9243 | 12,6501 | 15,0282 | + +При поздней странице большого чата p95 составного keyset-запроса меньше исходного примерно в **28,26 раза**. EXPLAIN показывает: исходный индекс фильтрует 79 900 строк и сортирует, затрагивает 2017 shared hit blocks; составной — Index Scan с tuple в Index Cond, только 50 строк и 6 shared hit blocks. Covering даёт Index Only Scan, 0 heap fetches, 5 blocks, но это не гарантирует лучший p95 в короткой выборке. + +| Индекс | Все индексы messages, MiB | INSERT 1000 + COMMIT p50, мс | p95, мс | Средний WAL bytes | +| --- | ---: | ---: | ---: | ---: | +| chat_id | 5,203 | 9,6394 | 11,5286 | 379 956 | +| составной | 11,156 | 10,2890 | 12,1678 | 453 492 | +| covering | 27,609 | 13,9626 | 64,6203 | 708 616 | + +Выбран узкий составной индекс: он устраняет линейный просмотр поздней страницы, а covering увеличивает размер индексов примерно в 2,47 раза относительно составного и медиану write-batch примерно в 1,36 раза. Малые разницы субмиллисекундных чтений не перевешивают этот расход в данном стенде. OFFSET остаётся затратным даже с составным индексом. Планировщик и реальные buffers подтверждают механизм изменения; один факт наличия индекса этого не доказывает. + +![Индексы, задержки и стоимость записи](evidence/research.png) + +Backup custom-format: **3 004 503 bytes**, создание **0,5288 с**. Подготовка нового PostgreSQL с новым volume — **1,3216 с**, restore — **0,6135 с**, вместе **1,9351 с** без последующей проверки. После восстановления совпали counts всех семи таблиц, 7 выбранных сообщений и SHA-256 всей истории. Orphan messages — 0. Сессия и постоянный cursor key также присутствуют в снимке; функциональная сохранность реальных API-сессий отдельно проверена публичным restart-тестом. + +После dump в источник добавлена canary-запись. Источник содержит 100 001 сообщение, восстановленная БД — исходные 100 000. Это ожидаемая граница snapshot backup: подтверждённая после снимка запись в этот backup не входит. Нулевой RPO не заявляется; нужны WAL archive/PITR. Время здесь относится к маленькому локальному синтетическому набору, не к полному production RTO. + +Полные результаты: [таблица](evidence/research-summary.md), [raw JSON](evidence/research.json), [EXPLAIN](evidence/explain-plans.json), [CSV](evidence/query-measurements.csv). Dump хранится только локально в игнорируемом backups/; реальные рабочие данные не экспортировались. + +## Отказы, ограничения и дальнейшие шаги + +| Воздействие | Ожидание | Наблюдение | Потери / восстановление | | --- | --- | --- | --- | -| TODO | TODO | TODO | TODO | +| Valkey down | Fallback в PostgreSQL, logout действует | Сценарий 0,85 с, корректные profile/history и 401 после logout | Потерян только восстанавливаемый кэш | +| Valkey flush/restart | Перезаполнение профилей; revoked token не оживает | PASS | Пользователи/сообщения/сессии не теряются | +| PostgreSQL down | 503, ready 503, live 200, без доверия анониму | Первый защищённый запрос 2,01 с | Данные на volume; прежняя сессия работает после старта | +| API + все хранилища restart | Данные и неизменённый expiry сохраняются | Публичный persistence PASS; все StartedAt изменились | Воспроизведённое восстановление около 7,924 с | +| SESSION_TTL_SECONDS=2 | 401 после expiry | PASS в отдельном API-контейнере | Истекает только сессия | +| Неизвестный участник в создании чата | Полный rollback | HTTP и SQL-проверка отсутствия остаточных строк | Нет частичного чата | +| Restore снимка | Совпадение состояния на момент dump | 100 000 сообщений и полный checksum совпали | Canary после снимка отсутствует ожидаемо | -## Ограничения и следующие шаги +Ограничения: один локальный PostgreSQL, нет репликации/HA/PITR; именованный volume не защищает от потери диска/хоста. Synchronous COMMIT опирается на настройки PostgreSQL и честность fsync нижележащего хранилища. Истёкшие сессии логически не дают доступ, но фоновая очистка их строк пока не реализована. Кэш не измерялся на stampede/stale read — трек 1 не заявляется. Обновление/удаление пользователей, вложения, idempotency и балансировка относятся к следующим работам. -TODO: какие отказы выдерживаются и какие нет; что не реализовано; где учебное упрощение; какое улучшение подтверждено, а какое пока гипотеза. +Короткие последовательные SQL-измерения с прогретыми страницами и фиксированным порядком вариантов не дают production SLA, максимальный throughput или статистически устойчивые tail-percentiles. CPU-профилирование не проводилось; ограничения ресурсов заданы явно. Полноценный HTTP-сервер промышленного развёртывания потребовал бы дополнительных ограничений соединений и внешнего TLS. + +## Ответы на вопросы защиты + +- **COMMIT:** фиксирует всю транзакцию либо не фиксирует её при ошибке; возврат API происходит после завершения контекста транзакции. Durability зависит от synchronous_commit, fsync, full_page_writes, диска и сохранности volume. Ответ на неопределённый сетевой обрыв ещё не гарантирует отсутствие совершённой записи. +- **Сессии и Redis/Valkey:** сессии находятся в PostgreSQL, Valkey содержит только public User. Flush/restart теряет cache hit, но не токен/expiry. Logout всегда проверяется по БД. +- **Аутентификация и доступ:** Bearer устанавливает текущего пользователя; членство решает, может ли он читать/писать конкретный чат. Действительный токен постороннего всё равно получает 404. +- **Password KDF и checksum:** человеческий пароль низкоэнтропийный, нужен salted memory-cost KDF; случайный 256-битный токен можно искать по SHA-256. SHA-256 истории в backup-проверке обнаруживает отличие данных и не заменяет password KDF. + +## Первичные источники + +- [PostgreSQL transactions](https://www.postgresql.org/docs/17/tutorial-transactions.html), [EXPLAIN](https://www.postgresql.org/docs/17/using-explain.html), [SQL dump](https://www.postgresql.org/docs/17/backup-dump.html). +- [Psycopg connection pools](https://www.psycopg.org/psycopg3/docs/advanced/pool.html), [query parameters](https://www.psycopg.org/psycopg3/docs/basic/params.html). +- [Python scrypt](https://docs.python.org/3.13/library/hashlib.html#hashlib.scrypt), [Basic authentication RFC 7617](https://www.rfc-editor.org/rfc/rfc7617). +- [Valkey expiration](https://valkey.io/commands/expire/), [Dockerfile reference](https://docs.docker.com/reference/dockerfile/). diff --git a/SOLUTION.md b/SOLUTION.md new file mode 100644 index 0000000..0146053 --- /dev/null +++ b/SOLUTION.md @@ -0,0 +1,44 @@ +# Лабораторная 2 на Python + +Алихан Абдурашидов, БВТ2301. Целевая оценка 5, трек 2 — план запроса и восстановление. + +Нужны Docker Compose, Python 3.11+ и make. PostgreSQL/Valkey устанавливаются контейнерами из этого репозитория. Рабочий HTTP-порт по умолчанию 8082; первая лабораторная может продолжать работать на 8080. + +```sh +make up +# bootstrap автоматически создаст .env и secrets/ только при их отсутствии. +# up дождётся Docker healthcheck. +make check test student-test +make infra-test +``` + +`make infra-test` намеренно останавливает PostgreSQL и Valkey текущего проекта, проверяет 503/cache fallback/expiry и затем запускает публичный полный restart-сценарий. Учебные данные и именованный volume сохраняются. + +```sh +# Отдельно публичная проверка сохранности: +make test-persistence ACTION_SCRIPT=scripts/restart.sh +# Повторяемое исследование на изолированных синтетических БД: +make research +# Полная проверка схемы: +python3 -m venv .venv +.venv/bin/python -m pip install -r requirements-dev.txt +make validate PYTHON=.venv/bin/python +# Необязательный рисунок по сохранённым данным: +.venv/bin/python -m pip install -r research/requirements.txt +.venv/bin/python research/summarize.py +``` + +Для другого порта: задать `HOST_PORT` в `.env`, пересоздать API командой `docker compose up -d`, передавать тестам `BASE_URL=http://localhost:<порт>`. `APP_PORT=8080` — внутренний порт контейнера. Для короткого TTL используется отдельный тестовый контейнер; обычный стенд оставляет SESSION_TTL_SECONDS=3600. + +```sh +# Корректная остановка с сохранением данных: +docker compose down +# Повторный запуск с тем же volume: +docker compose up -d --wait +# Только если нужно намеренно уничтожить все учебные данные этого проекта: +docker compose down --volumes +``` + +Секреты не печатаются и не коммитятся. Не удалять secrets/ при сохранённом volume: смена пароля в файлах не меняет пароль уже инициализированной PostgreSQL. `make clean-clone-test` проверяет именно текущий commit в отдельном clone, со своими секретами, портом и временными volumes; незакоммиченные изменения в этот clone не попадают. + +Схема до реализации запросов: [infra/SCHEMA.md](infra/SCHEMA.md). Подробный отчёт: [REPORT.md](REPORT.md). Методика исследования: [research/README.md](research/README.md). diff --git a/compose.yaml b/compose.yaml new file mode 100644 index 0000000..f61d56e --- /dev/null +++ b/compose.yaml @@ -0,0 +1,73 @@ +name: mtusi-lab2 +services: + api: + build: . + image: mtusi-messenger:lab2 + environment: + APP_HOST: 0.0.0.0 + APP_PORT: 8080 + APP_ENV: ${APP_ENV:-lab} + SESSION_TTL_SECONDS: ${SESSION_TTL_SECONDS:-3600} + SESSION_STORE: postgres + PROFILE_CACHE_TTL_SECONDS: ${PROFILE_CACHE_TTL_SECONDS:-300} + DB_POOL_MAX: ${DB_POOL_MAX:-8} + DATABASE_URL_FILE: /run/secrets/database_url + CACHE_URL_FILE: /run/secrets/cache_url + ports: + - "127.0.0.1:${HOST_PORT:-8082}:8080" + secrets: [database_url, cache_url] + depends_on: + postgres: + condition: service_healthy + valkey: + condition: service_started + read_only: true + cap_drop: [ALL] + security_opt: [no-new-privileges:true] + cpus: 1 + mem_limit: 512m + pids_limit: 256 + stop_grace_period: 10s + postgres: + image: postgres:17.9-bookworm@sha256:47f917f7409eacd22fc5dfb1dee634e1b55cf0c01d1a7eb701be2227a03e0641 + environment: + POSTGRES_DB: messenger + POSTGRES_USER: messenger + POSTGRES_PASSWORD_FILE: /run/secrets/db_password + secrets: [db_password] + volumes: [postgres_data:/var/lib/postgresql/data] + healthcheck: + test: [CMD-SHELL, "pg_isready -U messenger -d messenger"] + interval: 2s + timeout: 2s + retries: 20 + command: [postgres, -c, shared_buffers=128MB, -c, max_connections=40] + cpus: 1 + mem_limit: 512m + pids_limit: 128 + stop_grace_period: 10s + valkey: + image: valkey/valkey:8.1.3-alpine@sha256:d827e7f7552cdee40cc7482dbae9da020f42bc47669af6f71182a4ef76a22773 + command: [valkey-server, /run/secrets/valkey_config] + secrets: + - source: valkey_config + target: valkey_config + healthcheck: + test: [CMD-SHELL, "valkey-cli ping 2>&1 | grep -q NOAUTH"] + interval: 2s + timeout: 2s + retries: 15 + cpus: 0.5 + mem_limit: 128m + pids_limit: 64 +volumes: + postgres_data: +secrets: + db_password: + file: ./secrets/db_password + database_url: + file: ./secrets/database_url + cache_url: + file: ./secrets/cache_url + valkey_config: + file: ./secrets/valkey.conf diff --git a/evidence/contracts.txt b/evidence/contracts.txt new file mode 100644 index 0000000..ed9cd47 --- /dev/null +++ b/evidence/contracts.txt @@ -0,0 +1,4 @@ +.venv/bin/python scripts/check_contract.py +PASS: offline skeleton structure, local refs and Python syntax; application NOT tested. +.venv/bin/python scripts/validate_openapi.py +PASS: full OpenAPI 3.1 and JSON Schema validation; application NOT tested. diff --git a/evidence/explain-plans.json b/evidence/explain-plans.json new file mode 100644 index 0000000..ee4de10 --- /dev/null +++ b/evidence/explain-plans.json @@ -0,0 +1,2252 @@ +[ + { + "index": "chat_only", + "chat_size": 80000, + "query": "keyset", + "explain_analyze_buffers": { + "Plan": { + "Node Type": "Limit", + "Parallel Aware": false, + "Async Capable": false, + "Startup Cost": 4583.62, + "Total Cost": 4583.74, + "Plan Rows": 50, + "Plan Width": 162, + "Actual Startup Time": 6.726, + "Actual Total Time": 6.732, + "Actual Rows": 50, + "Actual Loops": 1, + "Shared Hit Blocks": 2017, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0, + "Plans": [ + { + "Node Type": "Sort", + "Parent Relationship": "Outer", + "Parallel Aware": false, + "Async Capable": false, + "Startup Cost": 4583.62, + "Total Cost": 4623.51, + "Plan Rows": 15957, + "Plan Width": 162, + "Actual Startup Time": 6.726, + "Actual Total Time": 6.728, + "Actual Rows": 50, + "Actual Loops": 1, + "Sort Key": [ + "created_at", + "id" + ], + "Sort Method": "quicksort", + "Sort Space Used": 50, + "Sort Space Type": "Memory", + "Shared Hit Blocks": 2017, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0, + "Plans": [ + { + "Node Type": "Index Scan", + "Parent Relationship": "Outer", + "Parallel Aware": false, + "Async Capable": false, + "Scan Direction": "Forward", + "Index Name": "messages_chat_only_idx", + "Relation Name": "messages", + "Alias": "messages", + "Startup Cost": 0.29, + "Total Cost": 4053.53, + "Plan Rows": 15957, + "Plan Width": 162, + "Actual Startup Time": 6.692, + "Actual Total Time": 6.715, + "Actual Rows": 100, + "Actual Loops": 1, + "Index Cond": "(chat_id = '00000000-0000-0000-0000-000000000001'::uuid)", + "Rows Removed by Index Recheck": 0, + "Filter": "(ROW(created_at, id) > ROW('2026-01-01 00:00:00.0799+00'::timestamp with time zone, '4c258fbb-7ab4-ca0e-1a48-23111d989887'::uuid))", + "Rows Removed by Filter": 79900, + "Shared Hit Blocks": 2017, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + } + ] + } + ] + }, + "Planning": { + "Shared Hit Blocks": 0, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + }, + "Planning Time": 0.044, + "Triggers": [], + "Execution Time": 6.74 + } + }, + { + "index": "chat_only", + "chat_size": 80000, + "query": "offset", + "explain_analyze_buffers": { + "Plan": { + "Node Type": "Limit", + "Parallel Aware": false, + "Async Capable": false, + "Startup Cost": 16971.36, + "Total Cost": 16971.49, + "Plan Rows": 50, + "Plan Width": 162, + "Actual Startup Time": 51.018, + "Actual Total Time": 51.027, + "Actual Rows": 50, + "Actual Loops": 1, + "Shared Hit Blocks": 2017, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 1742, + "Temp Written Blocks": 1747, + "Plans": [ + { + "Node Type": "Sort", + "Parent Relationship": "Outer", + "Parallel Aware": false, + "Async Capable": false, + "Startup Cost": 16771.61, + "Total Cost": 16972.2, + "Plan Rows": 80233, + "Plan Width": 162, + "Actual Startup Time": 39.315, + "Actual Total Time": 48.181, + "Actual Rows": 79950, + "Actual Loops": 1, + "Sort Key": [ + "created_at", + "id" + ], + "Sort Method": "external merge", + "Sort Space Used": 13936, + "Sort Space Type": "Disk", + "Shared Hit Blocks": 2017, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 1742, + "Temp Written Blocks": 1747, + "Plans": [ + { + "Node Type": "Index Scan", + "Parent Relationship": "Outer", + "Parallel Aware": false, + "Async Capable": false, + "Scan Direction": "Forward", + "Index Name": "messages_chat_only_idx", + "Relation Name": "messages", + "Alias": "messages", + "Startup Cost": 0.29, + "Total Cost": 3652.37, + "Plan Rows": 80233, + "Plan Width": 162, + "Actual Startup Time": 0.01, + "Actual Total Time": 7.926, + "Actual Rows": 80000, + "Actual Loops": 1, + "Index Cond": "(chat_id = '00000000-0000-0000-0000-000000000001'::uuid)", + "Rows Removed by Index Recheck": 0, + "Shared Hit Blocks": 2017, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + } + ] + } + ] + }, + "Planning": { + "Shared Hit Blocks": 0, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + }, + "Planning Time": 0.072, + "Triggers": [], + "Execution Time": 51.932 + } + }, + { + "index": "chat_only", + "chat_size": 15000, + "query": "keyset", + "explain_analyze_buffers": { + "Plan": { + "Node Type": "Limit", + "Parallel Aware": false, + "Async Capable": false, + "Startup Cost": 779.4, + "Total Cost": 779.52, + "Plan Rows": 50, + "Plan Width": 162, + "Actual Startup Time": 1.266, + "Actual Total Time": 1.271, + "Actual Rows": 50, + "Actual Loops": 1, + "Shared Hit Blocks": 379, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0, + "Plans": [ + { + "Node Type": "Sort", + "Parent Relationship": "Outer", + "Parallel Aware": false, + "Async Capable": false, + "Startup Cost": 779.4, + "Total Cost": 781.27, + "Plan Rows": 747, + "Plan Width": 162, + "Actual Startup Time": 1.265, + "Actual Total Time": 1.267, + "Actual Rows": 50, + "Actual Loops": 1, + "Sort Key": [ + "created_at", + "id" + ], + "Sort Method": "quicksort", + "Sort Space Used": 50, + "Sort Space Type": "Memory", + "Shared Hit Blocks": 379, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0, + "Plans": [ + { + "Node Type": "Index Scan", + "Parent Relationship": "Outer", + "Parallel Aware": false, + "Async Capable": false, + "Scan Direction": "Forward", + "Index Name": "messages_chat_only_idx", + "Relation Name": "messages", + "Alias": "messages", + "Startup Cost": 0.29, + "Total Cost": 754.59, + "Plan Rows": 747, + "Plan Width": 162, + "Actual Startup Time": 1.243, + "Actual Total Time": 1.255, + "Actual Rows": 100, + "Actual Loops": 1, + "Index Cond": "(chat_id = '00000000-0000-0000-0000-000000000002'::uuid)", + "Rows Removed by Index Recheck": 0, + "Filter": "(ROW(created_at, id) > ROW('2026-01-01 00:00:00.0949+00'::timestamp with time zone, '83309d4e-6a9c-bf24-ec2c-d0ad8d47e31e'::uuid))", + "Rows Removed by Filter": 14900, + "Shared Hit Blocks": 379, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + } + ] + } + ] + }, + "Planning": { + "Shared Hit Blocks": 0, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + }, + "Planning Time": 0.074, + "Triggers": [], + "Execution Time": 1.279 + } + }, + { + "index": "chat_only", + "chat_size": 15000, + "query": "offset", + "explain_analyze_buffers": { + "Plan": { + "Node Type": "Limit", + "Parallel Aware": false, + "Async Capable": false, + "Startup Cost": 1743.69, + "Total Cost": 1743.69, + "Plan Rows": 1, + "Plan Width": 162, + "Actual Startup Time": 6.012, + "Actual Total Time": 6.02, + "Actual Rows": 50, + "Actual Loops": 1, + "Shared Hit Blocks": 379, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 328, + "Temp Written Blocks": 329, + "Plans": [ + { + "Node Type": "Sort", + "Parent Relationship": "Outer", + "Parallel Aware": false, + "Async Capable": false, + "Startup Cost": 1706.66, + "Total Cost": 1743.69, + "Plan Rows": 14813, + "Plan Width": 162, + "Actual Startup Time": 4.225, + "Actual Total Time": 5.504, + "Actual Rows": 14950, + "Actual Loops": 1, + "Sort Key": [ + "created_at", + "id" + ], + "Sort Method": "external merge", + "Sort Space Used": 2624, + "Sort Space Type": "Disk", + "Shared Hit Blocks": 379, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 328, + "Temp Written Blocks": 329, + "Plans": [ + { + "Node Type": "Index Scan", + "Parent Relationship": "Outer", + "Parallel Aware": false, + "Async Capable": false, + "Scan Direction": "Forward", + "Index Name": "messages_chat_only_idx", + "Relation Name": "messages", + "Alias": "messages", + "Startup Cost": 0.29, + "Total Cost": 680.52, + "Plan Rows": 14813, + "Plan Width": 162, + "Actual Startup Time": 0.006, + "Actual Total Time": 1.521, + "Actual Rows": 15000, + "Actual Loops": 1, + "Index Cond": "(chat_id = '00000000-0000-0000-0000-000000000002'::uuid)", + "Rows Removed by Index Recheck": 0, + "Shared Hit Blocks": 379, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + } + ] + } + ] + }, + "Planning": { + "Shared Hit Blocks": 0, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + }, + "Planning Time": 0.027, + "Triggers": [], + "Execution Time": 6.17 + } + }, + { + "index": "chat_only", + "chat_size": 4000, + "query": "keyset", + "explain_analyze_buffers": { + "Plan": { + "Node Type": "Limit", + "Parallel Aware": false, + "Async Capable": false, + "Startup Cost": 208.17, + "Total Cost": 208.27, + "Plan Rows": 43, + "Plan Width": 162, + "Actual Startup Time": 0.346, + "Actual Total Time": 0.352, + "Actual Rows": 50, + "Actual Loops": 1, + "Shared Hit Blocks": 104, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0, + "Plans": [ + { + "Node Type": "Sort", + "Parent Relationship": "Outer", + "Parallel Aware": false, + "Async Capable": false, + "Startup Cost": 208.17, + "Total Cost": 208.27, + "Plan Rows": 43, + "Plan Width": 162, + "Actual Startup Time": 0.346, + "Actual Total Time": 0.348, + "Actual Rows": 50, + "Actual Loops": 1, + "Sort Key": [ + "created_at", + "id" + ], + "Sort Method": "quicksort", + "Sort Space Used": 50, + "Sort Space Type": "Memory", + "Shared Hit Blocks": 104, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0, + "Plans": [ + { + "Node Type": "Index Scan", + "Parent Relationship": "Outer", + "Parallel Aware": false, + "Async Capable": false, + "Scan Direction": "Forward", + "Index Name": "messages_chat_only_idx", + "Relation Name": "messages", + "Alias": "messages", + "Startup Cost": 0.29, + "Total Cost": 207.0, + "Plan Rows": 43, + "Plan Width": 162, + "Actual Startup Time": 0.324, + "Actual Total Time": 0.336, + "Actual Rows": 100, + "Actual Loops": 1, + "Index Cond": "(chat_id = '00000000-0000-0000-0000-000000000003'::uuid)", + "Rows Removed by Index Recheck": 0, + "Filter": "(ROW(created_at, id) > ROW('2026-01-01 00:00:00.0989+00'::timestamp with time zone, '3ca7f544-85f6-3d47-6ce5-72ab53f46142'::uuid))", + "Rows Removed by Filter": 3900, + "Shared Hit Blocks": 104, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + } + ] + } + ] + }, + "Planning": { + "Shared Hit Blocks": 0, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + }, + "Planning Time": 0.077, + "Triggers": [], + "Execution Time": 0.36 + } + }, + { + "index": "chat_only", + "chat_size": 4000, + "query": "offset", + "explain_analyze_buffers": { + "Plan": { + "Node Type": "Limit", + "Parallel Aware": false, + "Async Capable": false, + "Startup Cost": 435.26, + "Total Cost": 435.38, + "Plan Rows": 50, + "Plan Width": 162, + "Actual Startup Time": 0.976, + "Actual Total Time": 0.982, + "Actual Rows": 50, + "Actual Loops": 1, + "Shared Hit Blocks": 104, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0, + "Plans": [ + { + "Node Type": "Sort", + "Parent Relationship": "Outer", + "Parallel Aware": false, + "Async Capable": false, + "Startup Cost": 425.51, + "Total Cost": 435.48, + "Plan Rows": 3987, + "Plan Width": 162, + "Actual Startup Time": 0.671, + "Actual Total Time": 0.84, + "Actual Rows": 3950, + "Actual Loops": 1, + "Sort Key": [ + "created_at", + "id" + ], + "Sort Method": "quicksort", + "Sort Space Used": 1128, + "Sort Space Type": "Memory", + "Shared Hit Blocks": 104, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0, + "Plans": [ + { + "Node Type": "Index Scan", + "Parent Relationship": "Outer", + "Parallel Aware": false, + "Async Capable": false, + "Scan Direction": "Forward", + "Index Name": "messages_chat_only_idx", + "Relation Name": "messages", + "Alias": "messages", + "Startup Cost": 0.29, + "Total Cost": 187.06, + "Plan Rows": 3987, + "Plan Width": 162, + "Actual Startup Time": 0.005, + "Actual Total Time": 0.364, + "Actual Rows": 4000, + "Actual Loops": 1, + "Index Cond": "(chat_id = '00000000-0000-0000-0000-000000000003'::uuid)", + "Rows Removed by Index Recheck": 0, + "Shared Hit Blocks": 104, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + } + ] + } + ] + }, + "Planning": { + "Shared Hit Blocks": 0, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + }, + "Planning Time": 0.019, + "Triggers": [], + "Execution Time": 0.989 + } + }, + { + "index": "chat_only", + "chat_size": 1000, + "query": "keyset", + "explain_analyze_buffers": { + "Plan": { + "Node Type": "Limit", + "Parallel Aware": false, + "Async Capable": false, + "Startup Cost": 53.06, + "Total Cost": 53.06, + "Plan Rows": 1, + "Plan Width": 162, + "Actual Startup Time": 0.101, + "Actual Total Time": 0.107, + "Actual Rows": 50, + "Actual Loops": 1, + "Shared Hit Blocks": 27, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0, + "Plans": [ + { + "Node Type": "Sort", + "Parent Relationship": "Outer", + "Parallel Aware": false, + "Async Capable": false, + "Startup Cost": 53.06, + "Total Cost": 53.06, + "Plan Rows": 1, + "Plan Width": 162, + "Actual Startup Time": 0.101, + "Actual Total Time": 0.103, + "Actual Rows": 50, + "Actual Loops": 1, + "Sort Key": [ + "created_at", + "id" + ], + "Sort Method": "quicksort", + "Sort Space Used": 50, + "Sort Space Type": "Memory", + "Shared Hit Blocks": 27, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0, + "Plans": [ + { + "Node Type": "Index Scan", + "Parent Relationship": "Outer", + "Parallel Aware": false, + "Async Capable": false, + "Scan Direction": "Forward", + "Index Name": "messages_chat_only_idx", + "Relation Name": "messages", + "Alias": "messages", + "Startup Cost": 0.29, + "Total Cost": 53.05, + "Plan Rows": 1, + "Plan Width": 162, + "Actual Startup Time": 0.08, + "Actual Total Time": 0.092, + "Actual Rows": 100, + "Actual Loops": 1, + "Index Cond": "(chat_id = '00000000-0000-0000-0000-000000000004'::uuid)", + "Rows Removed by Index Recheck": 0, + "Filter": "(ROW(created_at, id) > ROW('2026-01-01 00:00:00.0999+00'::timestamp with time zone, '7fa13929-f6d0-fc18-76f9-46306abe42ca'::uuid))", + "Rows Removed by Filter": 900, + "Shared Hit Blocks": 27, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + } + ] + } + ] + }, + "Planning": { + "Shared Hit Blocks": 0, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + }, + "Planning Time": 0.067, + "Triggers": [], + "Execution Time": 0.115 + } + }, + { + "index": "chat_only", + "chat_size": 1000, + "query": "offset", + "explain_analyze_buffers": { + "Plan": { + "Node Type": "Limit", + "Parallel Aware": false, + "Async Capable": false, + "Startup Cost": 98.42, + "Total Cost": 98.54, + "Plan Rows": 50, + "Plan Width": 162, + "Actual Startup Time": 0.298, + "Actual Total Time": 0.304, + "Actual Rows": 50, + "Actual Loops": 1, + "Shared Hit Blocks": 27, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0, + "Plans": [ + { + "Node Type": "Sort", + "Parent Relationship": "Outer", + "Parallel Aware": false, + "Async Capable": false, + "Startup Cost": 96.17, + "Total Cost": 98.58, + "Plan Rows": 967, + "Plan Width": 162, + "Actual Startup Time": 0.163, + "Actual Total Time": 0.242, + "Actual Rows": 950, + "Actual Loops": 1, + "Sort Key": [ + "created_at", + "id" + ], + "Sort Method": "quicksort", + "Sort Space Used": 282, + "Sort Space Type": "Memory", + "Shared Hit Blocks": 27, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0, + "Plans": [ + { + "Node Type": "Index Scan", + "Parent Relationship": "Outer", + "Parallel Aware": false, + "Async Capable": false, + "Scan Direction": "Forward", + "Index Name": "messages_chat_only_idx", + "Relation Name": "messages", + "Alias": "messages", + "Startup Cost": 0.29, + "Total Cost": 48.21, + "Plan Rows": 967, + "Plan Width": 162, + "Actual Startup Time": 0.004, + "Actual Total Time": 0.091, + "Actual Rows": 1000, + "Actual Loops": 1, + "Index Cond": "(chat_id = '00000000-0000-0000-0000-000000000004'::uuid)", + "Rows Removed by Index Recheck": 0, + "Shared Hit Blocks": 27, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + } + ] + } + ] + }, + "Planning": { + "Shared Hit Blocks": 0, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + }, + "Planning Time": 0.019, + "Triggers": [], + "Execution Time": 0.312 + } + }, + { + "index": "keyset", + "chat_size": 80000, + "query": "keyset", + "explain_analyze_buffers": { + "Plan": { + "Node Type": "Limit", + "Parallel Aware": false, + "Async Capable": false, + "Startup Cost": 0.42, + "Total Cost": 16.91, + "Plan Rows": 50, + "Plan Width": 162, + "Actual Startup Time": 0.004, + "Actual Total Time": 0.014, + "Actual Rows": 50, + "Actual Loops": 1, + "Shared Hit Blocks": 6, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0, + "Plans": [ + { + "Node Type": "Index Scan", + "Parent Relationship": "Outer", + "Parallel Aware": false, + "Async Capable": false, + "Scan Direction": "Forward", + "Index Name": "messages_chat_created_id_idx", + "Relation Name": "messages", + "Alias": "messages", + "Startup Cost": 0.42, + "Total Cost": 5376.21, + "Plan Rows": 16299, + "Plan Width": 162, + "Actual Startup Time": 0.004, + "Actual Total Time": 0.01, + "Actual Rows": 50, + "Actual Loops": 1, + "Index Cond": "((chat_id = '00000000-0000-0000-0000-000000000001'::uuid) AND (ROW(created_at, id) > ROW('2026-01-01 00:00:00.0799+00'::timestamp with time zone, '4c258fbb-7ab4-ca0e-1a48-23111d989887'::uuid)))", + "Rows Removed by Index Recheck": 0, + "Shared Hit Blocks": 6, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + } + ] + }, + "Planning": { + "Shared Hit Blocks": 0, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + }, + "Planning Time": 0.019, + "Triggers": [], + "Execution Time": 0.02 + } + }, + { + "index": "keyset", + "chat_size": 80000, + "query": "offset", + "explain_analyze_buffers": { + "Plan": { + "Node Type": "Limit", + "Parallel Aware": false, + "Async Capable": false, + "Startup Cost": 9467.91, + "Total Cost": 9468.02, + "Plan Rows": 1, + "Plan Width": 162, + "Actual Startup Time": 11.335, + "Actual Total Time": 11.345, + "Actual Rows": 50, + "Actual Loops": 1, + "Shared Hit Blocks": 2524, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0, + "Plans": [ + { + "Node Type": "Index Scan", + "Parent Relationship": "Outer", + "Parallel Aware": false, + "Async Capable": false, + "Scan Direction": "Forward", + "Index Name": "messages_chat_created_id_idx", + "Relation Name": "messages", + "Alias": "messages", + "Startup Cost": 0.42, + "Total Cost": 9467.91, + "Plan Rows": 79610, + "Plan Width": 162, + "Actual Startup Time": 0.008, + "Actual Total Time": 8.54, + "Actual Rows": 79950, + "Actual Loops": 1, + "Index Cond": "(chat_id = '00000000-0000-0000-0000-000000000001'::uuid)", + "Rows Removed by Index Recheck": 0, + "Shared Hit Blocks": 2524, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + } + ] + }, + "Planning": { + "Shared Hit Blocks": 0, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + }, + "Planning Time": 0.092, + "Triggers": [], + "Execution Time": 11.357 + } + }, + { + "index": "keyset", + "chat_size": 15000, + "query": "keyset", + "explain_analyze_buffers": { + "Plan": { + "Node Type": "Limit", + "Parallel Aware": false, + "Async Capable": false, + "Startup Cost": 0.42, + "Total Cost": 79.7, + "Plan Rows": 50, + "Plan Width": 162, + "Actual Startup Time": 0.004, + "Actual Total Time": 0.014, + "Actual Rows": 50, + "Actual Loops": 1, + "Shared Hit Blocks": 6, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0, + "Plans": [ + { + "Node Type": "Index Scan", + "Parent Relationship": "Outer", + "Parallel Aware": false, + "Async Capable": false, + "Scan Direction": "Forward", + "Index Name": "messages_chat_created_id_idx", + "Relation Name": "messages", + "Alias": "messages", + "Startup Cost": 0.42, + "Total Cost": 1218.15, + "Plan Rows": 768, + "Plan Width": 162, + "Actual Startup Time": 0.004, + "Actual Total Time": 0.01, + "Actual Rows": 50, + "Actual Loops": 1, + "Index Cond": "((chat_id = '00000000-0000-0000-0000-000000000002'::uuid) AND (ROW(created_at, id) > ROW('2026-01-01 00:00:00.0949+00'::timestamp with time zone, '83309d4e-6a9c-bf24-ec2c-d0ad8d47e31e'::uuid)))", + "Rows Removed by Index Recheck": 0, + "Shared Hit Blocks": 6, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + } + ] + }, + "Planning": { + "Shared Hit Blocks": 0, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + }, + "Planning Time": 0.049, + "Triggers": [], + "Execution Time": 0.022 + } + }, + { + "index": "keyset", + "chat_size": 15000, + "query": "offset", + "explain_analyze_buffers": { + "Plan": { + "Node Type": "Limit", + "Parallel Aware": false, + "Async Capable": false, + "Startup Cost": 4412.7, + "Total Cost": 4412.83, + "Plan Rows": 50, + "Plan Width": 162, + "Actual Startup Time": 7.498, + "Actual Total Time": 7.508, + "Actual Rows": 50, + "Actual Loops": 1, + "Shared Hit Blocks": 476, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 328, + "Temp Written Blocks": 329, + "Plans": [ + { + "Node Type": "Sort", + "Parent Relationship": "Outer", + "Parallel Aware": false, + "Async Capable": false, + "Startup Cost": 4375.45, + "Total Cost": 4414.49, + "Plan Rows": 15617, + "Plan Width": 162, + "Actual Startup Time": 5.713, + "Actual Total Time": 6.979, + "Actual Rows": 14950, + "Actual Loops": 1, + "Sort Key": [ + "created_at", + "id" + ], + "Sort Method": "external merge", + "Sort Space Used": 2624, + "Sort Space Type": "Disk", + "Shared Hit Blocks": 476, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 328, + "Temp Written Blocks": 329, + "Plans": [ + { + "Node Type": "Bitmap Heap Scan", + "Parent Relationship": "Outer", + "Parallel Aware": false, + "Async Capable": false, + "Relation Name": "messages", + "Alias": "messages", + "Startup Cost": 653.45, + "Total Cost": 3287.66, + "Plan Rows": 15617, + "Plan Width": 162, + "Actual Startup Time": 0.546, + "Actual Total Time": 1.806, + "Actual Rows": 15000, + "Actual Loops": 1, + "Recheck Cond": "(chat_id = '00000000-0000-0000-0000-000000000002'::uuid)", + "Rows Removed by Index Recheck": 0, + "Exact Heap Blocks": 366, + "Lossy Heap Blocks": 0, + "Shared Hit Blocks": 476, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0, + "Plans": [ + { + "Node Type": "Bitmap Index Scan", + "Parent Relationship": "Outer", + "Parallel Aware": false, + "Async Capable": false, + "Index Name": "messages_chat_created_id_idx", + "Startup Cost": 0.0, + "Total Cost": 649.54, + "Plan Rows": 15617, + "Plan Width": 0, + "Actual Startup Time": 0.503, + "Actual Total Time": 0.503, + "Actual Rows": 15000, + "Actual Loops": 1, + "Index Cond": "(chat_id = '00000000-0000-0000-0000-000000000002'::uuid)", + "Shared Hit Blocks": 110, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + } + ] + } + ] + } + ] + }, + "Planning": { + "Shared Hit Blocks": 0, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + }, + "Planning Time": 0.071, + "Triggers": [], + "Execution Time": 7.708 + } + }, + { + "index": "keyset", + "chat_size": 4000, + "query": "keyset", + "explain_analyze_buffers": { + "Plan": { + "Node Type": "Limit", + "Parallel Aware": false, + "Async Capable": false, + "Startup Cost": 0.42, + "Total Cost": 79.8, + "Plan Rows": 41, + "Plan Width": 162, + "Actual Startup Time": 0.006, + "Actual Total Time": 0.014, + "Actual Rows": 50, + "Actual Loops": 1, + "Shared Hit Blocks": 5, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0, + "Plans": [ + { + "Node Type": "Index Scan", + "Parent Relationship": "Outer", + "Parallel Aware": false, + "Async Capable": false, + "Scan Direction": "Forward", + "Index Name": "messages_chat_created_id_idx", + "Relation Name": "messages", + "Alias": "messages", + "Startup Cost": 0.42, + "Total Cost": 79.8, + "Plan Rows": 41, + "Plan Width": 162, + "Actual Startup Time": 0.005, + "Actual Total Time": 0.01, + "Actual Rows": 50, + "Actual Loops": 1, + "Index Cond": "((chat_id = '00000000-0000-0000-0000-000000000003'::uuid) AND (ROW(created_at, id) > ROW('2026-01-01 00:00:00.0989+00'::timestamp with time zone, '3ca7f544-85f6-3d47-6ce5-72ab53f46142'::uuid)))", + "Rows Removed by Index Recheck": 0, + "Shared Hit Blocks": 5, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + } + ] + }, + "Planning": { + "Shared Hit Blocks": 0, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + }, + "Planning Time": 0.081, + "Triggers": [], + "Execution Time": 0.021 + } + }, + { + "index": "keyset", + "chat_size": 4000, + "query": "offset", + "explain_analyze_buffers": { + "Plan": { + "Node Type": "Limit", + "Parallel Aware": false, + "Async Capable": false, + "Startup Cost": 2991.44, + "Total Cost": 2991.44, + "Plan Rows": 1, + "Plan Width": 162, + "Actual Startup Time": 1.111, + "Actual Total Time": 1.117, + "Actual Rows": 50, + "Actual Loops": 1, + "Shared Hit Blocks": 131, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0, + "Plans": [ + { + "Node Type": "Sort", + "Parent Relationship": "Outer", + "Parallel Aware": false, + "Async Capable": false, + "Startup Cost": 2982.0, + "Total Cost": 2991.44, + "Plan Rows": 3777, + "Plan Width": 162, + "Actual Startup Time": 0.79, + "Actual Total Time": 0.976, + "Actual Rows": 3950, + "Actual Loops": 1, + "Sort Key": [ + "created_at", + "id" + ], + "Sort Method": "quicksort", + "Sort Space Used": 1128, + "Sort Space Type": "Memory", + "Shared Hit Blocks": 131, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0, + "Plans": [ + { + "Node Type": "Bitmap Heap Scan", + "Parent Relationship": "Outer", + "Parallel Aware": false, + "Async Capable": false, + "Relation Name": "messages", + "Alias": "messages", + "Startup Cost": 161.69, + "Total Cost": 2757.59, + "Plan Rows": 3777, + "Plan Width": 162, + "Actual Startup Time": 0.152, + "Actual Total Time": 0.46, + "Actual Rows": 4000, + "Actual Loops": 1, + "Recheck Cond": "(chat_id = '00000000-0000-0000-0000-000000000003'::uuid)", + "Rows Removed by Index Recheck": 0, + "Exact Heap Blocks": 99, + "Lossy Heap Blocks": 0, + "Shared Hit Blocks": 131, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0, + "Plans": [ + { + "Node Type": "Bitmap Index Scan", + "Parent Relationship": "Outer", + "Parallel Aware": false, + "Async Capable": false, + "Index Name": "messages_chat_created_id_idx", + "Startup Cost": 0.0, + "Total Cost": 160.74, + "Plan Rows": 3777, + "Plan Width": 0, + "Actual Startup Time": 0.139, + "Actual Total Time": 0.139, + "Actual Rows": 4000, + "Actual Loops": 1, + "Index Cond": "(chat_id = '00000000-0000-0000-0000-000000000003'::uuid)", + "Shared Hit Blocks": 32, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + } + ] + } + ] + } + ] + }, + "Planning": { + "Shared Hit Blocks": 0, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + }, + "Planning Time": 0.068, + "Triggers": [], + "Execution Time": 1.129 + } + }, + { + "index": "keyset", + "chat_size": 1000, + "query": "keyset", + "explain_analyze_buffers": { + "Plan": { + "Node Type": "Limit", + "Parallel Aware": false, + "Async Capable": false, + "Startup Cost": 0.42, + "Total Cost": 8.44, + "Plan Rows": 1, + "Plan Width": 162, + "Actual Startup Time": 0.005, + "Actual Total Time": 0.013, + "Actual Rows": 50, + "Actual Loops": 1, + "Shared Hit Blocks": 5, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0, + "Plans": [ + { + "Node Type": "Index Scan", + "Parent Relationship": "Outer", + "Parallel Aware": false, + "Async Capable": false, + "Scan Direction": "Forward", + "Index Name": "messages_chat_created_id_idx", + "Relation Name": "messages", + "Alias": "messages", + "Startup Cost": 0.42, + "Total Cost": 8.44, + "Plan Rows": 1, + "Plan Width": 162, + "Actual Startup Time": 0.004, + "Actual Total Time": 0.009, + "Actual Rows": 50, + "Actual Loops": 1, + "Index Cond": "((chat_id = '00000000-0000-0000-0000-000000000004'::uuid) AND (ROW(created_at, id) > ROW('2026-01-01 00:00:00.0999+00'::timestamp with time zone, '7fa13929-f6d0-fc18-76f9-46306abe42ca'::uuid)))", + "Rows Removed by Index Recheck": 0, + "Shared Hit Blocks": 5, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + } + ] + }, + "Planning": { + "Shared Hit Blocks": 0, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + }, + "Planning Time": 0.061, + "Triggers": [], + "Execution Time": 0.019 + } + }, + { + "index": "keyset", + "chat_size": 1000, + "query": "offset", + "explain_analyze_buffers": { + "Plan": { + "Node Type": "Limit", + "Parallel Aware": false, + "Async Capable": false, + "Startup Cost": 1370.91, + "Total Cost": 1447.05, + "Plan Rows": 50, + "Plan Width": 162, + "Actual Startup Time": 0.128, + "Actual Total Time": 0.136, + "Actual Rows": 50, + "Actual Loops": 1, + "Shared Hit Blocks": 33, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0, + "Plans": [ + { + "Node Type": "Index Scan", + "Parent Relationship": "Outer", + "Parallel Aware": false, + "Async Capable": false, + "Scan Direction": "Forward", + "Index Name": "messages_chat_created_id_idx", + "Relation Name": "messages", + "Alias": "messages", + "Startup Cost": 0.42, + "Total Cost": 1518.62, + "Plan Rows": 997, + "Plan Width": 162, + "Actual Startup Time": 0.005, + "Actual Total Time": 0.101, + "Actual Rows": 950, + "Actual Loops": 1, + "Index Cond": "(chat_id = '00000000-0000-0000-0000-000000000004'::uuid)", + "Rows Removed by Index Recheck": 0, + "Shared Hit Blocks": 33, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + } + ] + }, + "Planning": { + "Shared Hit Blocks": 0, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + }, + "Planning Time": 0.062, + "Triggers": [], + "Execution Time": 0.145 + } + }, + { + "index": "covering", + "chat_size": 80000, + "query": "keyset", + "explain_analyze_buffers": { + "Plan": { + "Node Type": "Limit", + "Parallel Aware": false, + "Async Capable": false, + "Startup Cost": 0.42, + "Total Cost": 7.34, + "Plan Rows": 50, + "Plan Width": 162, + "Actual Startup Time": 0.006, + "Actual Total Time": 0.015, + "Actual Rows": 50, + "Actual Loops": 1, + "Shared Hit Blocks": 5, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0, + "Plans": [ + { + "Node Type": "Index Only Scan", + "Parent Relationship": "Outer", + "Parallel Aware": false, + "Async Capable": false, + "Scan Direction": "Forward", + "Index Name": "messages_chat_covering_idx", + "Relation Name": "messages", + "Alias": "messages", + "Startup Cost": 0.42, + "Total Cost": 2212.08, + "Plan Rows": 15983, + "Plan Width": 162, + "Actual Startup Time": 0.006, + "Actual Total Time": 0.011, + "Actual Rows": 50, + "Actual Loops": 1, + "Index Cond": "((chat_id = '00000000-0000-0000-0000-000000000001'::uuid) AND (ROW(created_at, id) > ROW('2026-01-01 00:00:00.0799+00'::timestamp with time zone, '4c258fbb-7ab4-ca0e-1a48-23111d989887'::uuid)))", + "Rows Removed by Index Recheck": 0, + "Heap Fetches": 0, + "Shared Hit Blocks": 5, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + } + ] + }, + "Planning": { + "Shared Hit Blocks": 0, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + }, + "Planning Time": 0.035, + "Triggers": [], + "Execution Time": 0.024 + } + }, + { + "index": "covering", + "chat_size": 80000, + "query": "offset", + "explain_analyze_buffers": { + "Plan": { + "Node Type": "Limit", + "Parallel Aware": false, + "Async Capable": false, + "Startup Cost": 10853.18, + "Total Cost": 10859.97, + "Plan Rows": 50, + "Plan Width": 162, + "Actual Startup Time": 11.598, + "Actual Total Time": 11.608, + "Actual Rows": 50, + "Actual Loops": 1, + "Shared Hit Blocks": 2002, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0, + "Plans": [ + { + "Node Type": "Index Only Scan", + "Parent Relationship": "Outer", + "Parallel Aware": false, + "Async Capable": false, + "Scan Direction": "Forward", + "Index Name": "messages_chat_covering_idx", + "Relation Name": "messages", + "Alias": "messages", + "Startup Cost": 0.42, + "Total Cost": 10891.62, + "Plan Rows": 80183, + "Plan Width": 162, + "Actual Startup Time": 0.005, + "Actual Total Time": 8.823, + "Actual Rows": 79950, + "Actual Loops": 1, + "Index Cond": "(chat_id = '00000000-0000-0000-0000-000000000001'::uuid)", + "Rows Removed by Index Recheck": 0, + "Heap Fetches": 0, + "Shared Hit Blocks": 2002, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + } + ] + }, + "Planning": { + "Shared Hit Blocks": 0, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + }, + "Planning Time": 0.04, + "Triggers": [], + "Execution Time": 11.616 + } + }, + { + "index": "covering", + "chat_size": 15000, + "query": "keyset", + "explain_analyze_buffers": { + "Plan": { + "Node Type": "Limit", + "Parallel Aware": false, + "Async Capable": false, + "Startup Cost": 0.42, + "Total Cost": 7.36, + "Plan Rows": 50, + "Plan Width": 162, + "Actual Startup Time": 0.005, + "Actual Total Time": 0.014, + "Actual Rows": 50, + "Actual Loops": 1, + "Shared Hit Blocks": 5, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0, + "Plans": [ + { + "Node Type": "Index Only Scan", + "Parent Relationship": "Outer", + "Parallel Aware": false, + "Async Capable": false, + "Scan Direction": "Forward", + "Index Name": "messages_chat_covering_idx", + "Relation Name": "messages", + "Alias": "messages", + "Startup Cost": 0.42, + "Total Cost": 103.22, + "Plan Rows": 740, + "Plan Width": 162, + "Actual Startup Time": 0.005, + "Actual Total Time": 0.01, + "Actual Rows": 50, + "Actual Loops": 1, + "Index Cond": "((chat_id = '00000000-0000-0000-0000-000000000002'::uuid) AND (ROW(created_at, id) > ROW('2026-01-01 00:00:00.0949+00'::timestamp with time zone, '83309d4e-6a9c-bf24-ec2c-d0ad8d47e31e'::uuid)))", + "Rows Removed by Index Recheck": 0, + "Heap Fetches": 0, + "Shared Hit Blocks": 5, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + } + ] + }, + "Planning": { + "Shared Hit Blocks": 0, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + }, + "Planning Time": 0.043, + "Triggers": [], + "Execution Time": 0.021 + } + }, + { + "index": "covering", + "chat_size": 15000, + "query": "offset", + "explain_analyze_buffers": { + "Plan": { + "Node Type": "Limit", + "Parallel Aware": false, + "Async Capable": false, + "Startup Cost": 2024.08, + "Total Cost": 2029.92, + "Plan Rows": 43, + "Plan Width": 162, + "Actual Startup Time": 2.174, + "Actual Total Time": 2.182, + "Actual Rows": 50, + "Actual Loops": 1, + "Shared Hit Blocks": 378, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0, + "Plans": [ + { + "Node Type": "Index Only Scan", + "Parent Relationship": "Outer", + "Parallel Aware": false, + "Async Capable": false, + "Scan Direction": "Forward", + "Index Name": "messages_chat_covering_idx", + "Relation Name": "messages", + "Alias": "messages", + "Startup Cost": 0.42, + "Total Cost": 2029.92, + "Plan Rows": 14943, + "Plan Width": 162, + "Actual Startup Time": 0.004, + "Actual Total Time": 1.656, + "Actual Rows": 14950, + "Actual Loops": 1, + "Index Cond": "(chat_id = '00000000-0000-0000-0000-000000000002'::uuid)", + "Rows Removed by Index Recheck": 0, + "Heap Fetches": 0, + "Shared Hit Blocks": 378, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + } + ] + }, + "Planning": { + "Shared Hit Blocks": 0, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + }, + "Planning Time": 0.048, + "Triggers": [], + "Execution Time": 2.19 + } + }, + { + "index": "covering", + "chat_size": 4000, + "query": "keyset", + "explain_analyze_buffers": { + "Plan": { + "Node Type": "Limit", + "Parallel Aware": false, + "Async Capable": false, + "Startup Cost": 0.42, + "Total Cost": 9.32, + "Plan Rows": 45, + "Plan Width": 162, + "Actual Startup Time": 0.004, + "Actual Total Time": 0.013, + "Actual Rows": 50, + "Actual Loops": 1, + "Shared Hit Blocks": 5, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0, + "Plans": [ + { + "Node Type": "Index Only Scan", + "Parent Relationship": "Outer", + "Parallel Aware": false, + "Async Capable": false, + "Scan Direction": "Forward", + "Index Name": "messages_chat_covering_idx", + "Relation Name": "messages", + "Alias": "messages", + "Startup Cost": 0.42, + "Total Cost": 9.32, + "Plan Rows": 45, + "Plan Width": 162, + "Actual Startup Time": 0.004, + "Actual Total Time": 0.009, + "Actual Rows": 50, + "Actual Loops": 1, + "Index Cond": "((chat_id = '00000000-0000-0000-0000-000000000003'::uuid) AND (ROW(created_at, id) > ROW('2026-01-01 00:00:00.0989+00'::timestamp with time zone, '3ca7f544-85f6-3d47-6ce5-72ab53f46142'::uuid)))", + "Rows Removed by Index Recheck": 0, + "Heap Fetches": 0, + "Shared Hit Blocks": 5, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + } + ] + }, + "Planning": { + "Shared Hit Blocks": 0, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + }, + "Planning Time": 0.026, + "Triggers": [], + "Execution Time": 0.019 + } + }, + { + "index": "covering", + "chat_size": 4000, + "query": "offset", + "explain_analyze_buffers": { + "Plan": { + "Node Type": "Limit", + "Parallel Aware": false, + "Async Capable": false, + "Startup Cost": 514.62, + "Total Cost": 514.76, + "Plan Rows": 1, + "Plan Width": 162, + "Actual Startup Time": 0.605, + "Actual Total Time": 0.614, + "Actual Rows": 50, + "Actual Loops": 1, + "Shared Hit Blocks": 103, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0, + "Plans": [ + { + "Node Type": "Index Only Scan", + "Parent Relationship": "Outer", + "Parallel Aware": false, + "Async Capable": false, + "Scan Direction": "Forward", + "Index Name": "messages_chat_covering_idx", + "Relation Name": "messages", + "Alias": "messages", + "Startup Cost": 0.42, + "Total Cost": 514.62, + "Plan Rows": 3783, + "Plan Width": 162, + "Actual Startup Time": 0.005, + "Actual Total Time": 0.474, + "Actual Rows": 3950, + "Actual Loops": 1, + "Index Cond": "(chat_id = '00000000-0000-0000-0000-000000000003'::uuid)", + "Rows Removed by Index Recheck": 0, + "Heap Fetches": 0, + "Shared Hit Blocks": 103, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + } + ] + }, + "Planning": { + "Shared Hit Blocks": 0, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + }, + "Planning Time": 0.048, + "Triggers": [], + "Execution Time": 0.625 + } + }, + { + "index": "covering", + "chat_size": 1000, + "query": "keyset", + "explain_analyze_buffers": { + "Plan": { + "Node Type": "Limit", + "Parallel Aware": false, + "Async Capable": false, + "Startup Cost": 0.42, + "Total Cost": 4.44, + "Plan Rows": 1, + "Plan Width": 162, + "Actual Startup Time": 0.004, + "Actual Total Time": 0.014, + "Actual Rows": 50, + "Actual Loops": 1, + "Shared Hit Blocks": 5, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0, + "Plans": [ + { + "Node Type": "Index Only Scan", + "Parent Relationship": "Outer", + "Parallel Aware": false, + "Async Capable": false, + "Scan Direction": "Forward", + "Index Name": "messages_chat_covering_idx", + "Relation Name": "messages", + "Alias": "messages", + "Startup Cost": 0.42, + "Total Cost": 4.44, + "Plan Rows": 1, + "Plan Width": 162, + "Actual Startup Time": 0.004, + "Actual Total Time": 0.01, + "Actual Rows": 50, + "Actual Loops": 1, + "Index Cond": "((chat_id = '00000000-0000-0000-0000-000000000004'::uuid) AND (ROW(created_at, id) > ROW('2026-01-01 00:00:00.0999+00'::timestamp with time zone, '7fa13929-f6d0-fc18-76f9-46306abe42ca'::uuid)))", + "Rows Removed by Index Recheck": 0, + "Heap Fetches": 0, + "Shared Hit Blocks": 5, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + } + ] + }, + "Planning": { + "Shared Hit Blocks": 0, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + }, + "Planning Time": 0.052, + "Triggers": [], + "Execution Time": 0.02 + } + }, + { + "index": "covering", + "chat_size": 1000, + "query": "offset", + "explain_analyze_buffers": { + "Plan": { + "Node Type": "Limit", + "Parallel Aware": false, + "Async Capable": false, + "Startup Cost": 125.16, + "Total Cost": 132.09, + "Plan Rows": 50, + "Plan Width": 162, + "Actual Startup Time": 0.143, + "Actual Total Time": 0.151, + "Actual Rows": 50, + "Actual Loops": 1, + "Shared Hit Blocks": 28, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0, + "Plans": [ + { + "Node Type": "Index Only Scan", + "Parent Relationship": "Outer", + "Parallel Aware": false, + "Async Capable": false, + "Scan Direction": "Forward", + "Index Name": "messages_chat_covering_idx", + "Relation Name": "messages", + "Alias": "messages", + "Startup Cost": 0.42, + "Total Cost": 151.49, + "Plan Rows": 1090, + "Plan Width": 162, + "Actual Startup Time": 0.003, + "Actual Total Time": 0.116, + "Actual Rows": 950, + "Actual Loops": 1, + "Index Cond": "(chat_id = '00000000-0000-0000-0000-000000000004'::uuid)", + "Rows Removed by Index Recheck": 0, + "Heap Fetches": 0, + "Shared Hit Blocks": 28, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + } + ] + }, + "Planning": { + "Shared Hit Blocks": 0, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + }, + "Planning Time": 0.039, + "Triggers": [], + "Execution Time": 0.157 + } + } +] diff --git a/evidence/infrastructure-run.txt b/evidence/infrastructure-run.txt new file mode 100644 index 0000000..c4cfa5d --- /dev/null +++ b/evidence/infrastructure-run.txt @@ -0,0 +1,49 @@ +{ + "date_utc": "2026-10-30T11:00:43.989800+00:00", + "checks": { + "valkey_really_caches_profiles": { + "cached_profiles": 48, + "all_profiles_public_fields_only": true, + "positive_ttl": true + }, + "password_kdf_and_hashed_tokens": { + "all_passwords_scrypt": true, + "all_token_digests_32_bytes": true + }, + "cache_outage": { + "fallback_profile_and_history": true, + "anonymous_rejected": true, + "logout_effective": true, + "scenario_seconds": 0.85 + }, + "cache_restart_no_revoked_session_resurrection": true, + "cache_flush_repopulates_from_postgres": true, + "postgres_outage": { + "authenticated_request_503_seconds": 2.01, + "live_200": true, + "ready_503": true, + "no_anonymous_trust": true + }, + "postgres_recovery_same_session": true, + "expiry_ttl_2_seconds": true, + "repeat_migration_does_not_duplicate_data": { + "migrations": 1, + "users": 50 + }, + "full_stack_persistence": { + "api_and_all_stores_restarted": true, + "before": { + "api": "2026-10-30T10:58:17.679191091Z", + "postgres": "2026-10-30T11:00:54.063549678Z", + "valkey": "2026-10-30T11:00:46.458543341Z" + }, + "after": { + "api": "2026-10-30T11:01:04.399852418Z", + "postgres": "2026-10-30T11:01:04.247473126Z", + "valkey": "2026-10-30T11:01:04.435663252Z" + }, + "elapsed_seconds": 7.924 + } + }, + "status": "PASS" +} diff --git a/evidence/infrastructure.json b/evidence/infrastructure.json new file mode 100644 index 0000000..c4cfa5d --- /dev/null +++ b/evidence/infrastructure.json @@ -0,0 +1,49 @@ +{ + "date_utc": "2026-10-30T11:00:43.989800+00:00", + "checks": { + "valkey_really_caches_profiles": { + "cached_profiles": 48, + "all_profiles_public_fields_only": true, + "positive_ttl": true + }, + "password_kdf_and_hashed_tokens": { + "all_passwords_scrypt": true, + "all_token_digests_32_bytes": true + }, + "cache_outage": { + "fallback_profile_and_history": true, + "anonymous_rejected": true, + "logout_effective": true, + "scenario_seconds": 0.85 + }, + "cache_restart_no_revoked_session_resurrection": true, + "cache_flush_repopulates_from_postgres": true, + "postgres_outage": { + "authenticated_request_503_seconds": 2.01, + "live_200": true, + "ready_503": true, + "no_anonymous_trust": true + }, + "postgres_recovery_same_session": true, + "expiry_ttl_2_seconds": true, + "repeat_migration_does_not_duplicate_data": { + "migrations": 1, + "users": 50 + }, + "full_stack_persistence": { + "api_and_all_stores_restarted": true, + "before": { + "api": "2026-10-30T10:58:17.679191091Z", + "postgres": "2026-10-30T11:00:54.063549678Z", + "valkey": "2026-10-30T11:00:46.458543341Z" + }, + "after": { + "api": "2026-10-30T11:01:04.399852418Z", + "postgres": "2026-10-30T11:01:04.247473126Z", + "valkey": "2026-10-30T11:01:04.435663252Z" + }, + "elapsed_seconds": 7.924 + } + }, + "status": "PASS" +} diff --git a/evidence/persistence.txt b/evidence/persistence.txt new file mode 100644 index 0000000..79082d1 --- /dev/null +++ b/evidence/persistence.txt @@ -0,0 +1,3 @@ +python3 tests/resilience.py --mode persistence --action-script "scripts/restart.sh" --base-url "http://localhost:8082" +Executing explicit persistence hook; hook output suppressed to avoid leaking secrets. +PASS: persistence preserved confirmed data and existing session. Hook scope needs operator evidence. diff --git a/evidence/query-measurements.csv b/evidence/query-measurements.csv new file mode 100644 index 0000000..5e5344f --- /dev/null +++ b/evidence/query-measurements.csv @@ -0,0 +1,25 @@ +index,chat_size,query,p50,p95,p99,mean,qps +chat_only,80000,keyset,7.0761,7.1933,7.1945,7.0884,141.064 +chat_only,80000,offset,24.9378,28.3299,29.9997,25.4597,39.275 +chat_only,15000,keyset,1.4773,1.5489,1.5723,1.4867,672.438 +chat_only,15000,offset,4.1769,8.9294,9.3571,4.5287,220.78 +chat_only,4000,keyset,0.6269,0.8833,0.9718,0.6489,1539.583 +chat_only,4000,offset,0.6617,1.123,1.5037,0.729,1370.731 +chat_only,1000,keyset,0.3048,0.443,0.6305,0.325,3072.865 +chat_only,1000,offset,0.3366,0.4242,0.4286,0.3492,2860.548 +keyset,80000,keyset,0.2249,0.2545,0.3508,0.2318,4307.199 +keyset,80000,offset,6.9243,12.6501,15.0282,7.8992,126.569 +keyset,15000,keyset,0.2069,0.2373,0.2455,0.2108,4736.312 +keyset,15000,offset,1.3274,6.6483,6.7603,2.32,430.747 +keyset,4000,keyset,0.2088,0.2822,0.3122,0.2174,4590.519 +keyset,4000,offset,0.5051,0.657,0.7066,0.5265,1897.228 +keyset,1000,keyset,0.1998,0.235,0.2685,0.205,4868.845 +keyset,1000,offset,0.2825,0.517,0.5368,0.3155,3164.696 +covering,80000,keyset,0.1993,0.3393,0.404,0.2336,4272.262 +covering,80000,offset,6.7655,7.1888,7.3155,6.8453,146.073 +covering,15000,keyset,0.2027,0.2262,0.2397,0.206,4840.044 +covering,15000,offset,1.374,1.5291,1.5962,1.3926,717.922 +covering,4000,keyset,0.1897,0.2183,0.2226,0.1935,5160.995 +covering,4000,offset,0.508,0.7336,0.8249,0.5293,1888.336 +covering,1000,keyset,0.1999,0.2138,0.2153,0.2028,4925.03 +covering,1000,offset,0.2774,0.3663,0.4765,0.2948,3388.315 diff --git a/evidence/research-run.txt b/evidence/research-run.txt new file mode 100644 index 0000000..0898904 --- /dev/null +++ b/evidence/research-run.txt @@ -0,0 +1,2 @@ +Benchmarking 100000 messages, 4 skewed chats, 3 indexes and 2 queries... +PASS: restored 100000 messages to a new PostgreSQL container/volume; counts, 7 samples, complete SHA256 and foreign keys verified. diff --git a/evidence/research-summary.md b/evidence/research-summary.md new file mode 100644 index 0000000..accac9c --- /dev/null +++ b/evidence/research-summary.md @@ -0,0 +1,38 @@ +# План запроса и восстановление + +| Индекс | Сообщений в чате | Запрос | p50, мс | p95, мс | p99, мс | Sequential QPS | +| --- | ---: | --- | ---: | ---: | ---: | ---: | +| chat_only | 80000 | keyset | 7.0761 | 7.1933 | 7.1945 | 141.064 | +| chat_only | 80000 | offset | 24.9378 | 28.3299 | 29.9997 | 39.275 | +| chat_only | 15000 | keyset | 1.4773 | 1.5489 | 1.5723 | 672.438 | +| chat_only | 15000 | offset | 4.1769 | 8.9294 | 9.3571 | 220.78 | +| chat_only | 4000 | keyset | 0.6269 | 0.8833 | 0.9718 | 1539.583 | +| chat_only | 4000 | offset | 0.6617 | 1.123 | 1.5037 | 1370.731 | +| chat_only | 1000 | keyset | 0.3048 | 0.443 | 0.6305 | 3072.865 | +| chat_only | 1000 | offset | 0.3366 | 0.4242 | 0.4286 | 2860.548 | +| keyset | 80000 | keyset | 0.2249 | 0.2545 | 0.3508 | 4307.199 | +| keyset | 80000 | offset | 6.9243 | 12.6501 | 15.0282 | 126.569 | +| keyset | 15000 | keyset | 0.2069 | 0.2373 | 0.2455 | 4736.312 | +| keyset | 15000 | offset | 1.3274 | 6.6483 | 6.7603 | 430.747 | +| keyset | 4000 | keyset | 0.2088 | 0.2822 | 0.3122 | 4590.519 | +| keyset | 4000 | offset | 0.5051 | 0.657 | 0.7066 | 1897.228 | +| keyset | 1000 | keyset | 0.1998 | 0.235 | 0.2685 | 4868.845 | +| keyset | 1000 | offset | 0.2825 | 0.517 | 0.5368 | 3164.696 | +| covering | 80000 | keyset | 0.1993 | 0.3393 | 0.404 | 4272.262 | +| covering | 80000 | offset | 6.7655 | 7.1888 | 7.3155 | 146.073 | +| covering | 15000 | keyset | 0.2027 | 0.2262 | 0.2397 | 4840.044 | +| covering | 15000 | offset | 1.374 | 1.5291 | 1.5962 | 717.922 | +| covering | 4000 | keyset | 0.1897 | 0.2183 | 0.2226 | 5160.995 | +| covering | 4000 | offset | 0.508 | 0.7336 | 0.8249 | 1888.336 | +| covering | 1000 | keyset | 0.1999 | 0.2138 | 0.2153 | 4925.03 | +| covering | 1000 | offset | 0.2774 | 0.3663 | 0.4765 | 3388.315 | + +| Индекс | Индексы messages, MiB | INSERT 1000 + COMMIT p50, мс | p95, мс | Средний WAL на 1000 строк, bytes | +| --- | ---: | ---: | ---: | ---: | +| chat_only | 5.203 | 9.6394 | 11.5286 | 379956 | +| keyset | 11.156 | 10.289 | 12.1678 | 453492 | +| covering | 27.609 | 13.9626 | 64.6203 | 708616 | + +Backup: 3004503 bytes, 0.5288 с. Новый PostgreSQL/volume: 1.3216 с. Restore: 0.6135 с. Provision + restore: 1.9351 с. + +Сверены количества всех таблиц, 7 выбранных сообщений, SHA-256 всей истории из 100 000 сообщений, отсутствие нарушенных связей. Запись после снимка ожидаемо отсутствует в восстановленной БД. diff --git a/evidence/research.json b/evidence/research.json new file mode 100644 index 0000000..3893b6e --- /dev/null +++ b/evidence/research.json @@ -0,0 +1,3627 @@ +{ + "date_utc": "2026-10-30T11:04:35.421935+00:00", + "source_sha256": { + "src/store.py": "162782315e7df8a4e2a442b5accaa0620d5b6214cc5c361017d69b306f76cfc6", + "migrations/001_initial.sql": "a009840617a4d08a7b18bdcffb588920838678e19a19b3918cbb0849c2ac81a9", + "research/worker.py": "52ec875ab656277887cc1239f05ca4ba8200228de8a1dabfbdbbca8c339e1cc5" + }, + "method": "Isolated skewed PostgreSQL datasets; 30 sequential reads after 3 warmups; 10 committed INSERT batches of 1000 rows; fresh restore volume.", + "limitations": [ + "Local single-host measurements; warm buffers; no concurrent HTTP capacity claim.", + "EXPLAIN insert wall times include plan collection and COMMIT; 10 batches do not establish a write SLA.", + "Logical backup is a snapshot, not PITR or HA; the post-dump canary is intentionally absent after restore." + ], + "query_experiment": { + "postgres_version": "17.9 (Debian 17.9-1.pgdg12+1)", + "dataset_messages": 100000, + "chat_sizes": [ + 80000, + 15000, + 4000, + 1000 + ], + "read_repeats": 30, + "warmup_queries": 3, + "write_batches": 10, + "write_batch_size": 1000, + "limits": { + "postgres_cpus": 1, + "postgres_memory_mib": 512, + "client_cpus": 1, + "client_memory_mib": 512 + }, + "variants": [ + { + "name": "chat_only", + "database": "lab2_research_e09aa1b4_chat_only", + "seed_seconds": 0.8756, + "table_bytes": 20021248, + "indexes_bytes": 5455872, + "write_runs": [ + { + "commit_wall_ms": 11.5286, + "execution_ms": 9.524, + "wal_bytes": 386092, + "shared_dirtied_blocks": 31 + }, + { + "commit_wall_ms": 9.9018, + "execution_ms": 8.992, + "wal_bytes": 400880, + "shared_dirtied_blocks": 34 + }, + { + "commit_wall_ms": 9.6394, + "execution_ms": 8.765, + "wal_bytes": 390012, + "shared_dirtied_blocks": 32 + }, + { + "commit_wall_ms": 9.8604, + "execution_ms": 8.889, + "wal_bytes": 379068, + "shared_dirtied_blocks": 28 + }, + { + "commit_wall_ms": 9.7735, + "execution_ms": 8.874, + "wal_bytes": 367380, + "shared_dirtied_blocks": 24 + }, + { + "commit_wall_ms": 9.3423, + "execution_ms": 8.538, + "wal_bytes": 375332, + "shared_dirtied_blocks": 28 + }, + { + "commit_wall_ms": 8.9664, + "execution_ms": 8.28, + "wal_bytes": 368072, + "shared_dirtied_blocks": 25 + }, + { + "commit_wall_ms": 9.5945, + "execution_ms": 8.681, + "wal_bytes": 382676, + "shared_dirtied_blocks": 30 + }, + { + "commit_wall_ms": 9.9285, + "execution_ms": 8.947, + "wal_bytes": 371756, + "shared_dirtied_blocks": 26 + }, + { + "commit_wall_ms": 9.2812, + "execution_ms": 8.499, + "wal_bytes": 378296, + "shared_dirtied_blocks": 27 + } + ], + "write_commit_ms": { + "p50": 9.6394, + "p95": 11.5286, + "p99": 11.5286, + "mean": 9.7817 + }, + "reads": [ + { + "chat_size": 80000, + "query": "keyset", + "latency_ms": { + "p50": 7.0761, + "p95": 7.1933, + "p99": 7.1945, + "mean": 7.0884 + }, + "raw_latency_ms": [ + 7.1945, + 7.0456, + 7.0677, + 6.9425, + 6.9956, + 7.0325, + 6.9857, + 7.1158, + 7.0837, + 7.0636, + 7.1851, + 7.112, + 7.1655, + 7.1372, + 7.0726, + 7.1933, + 7.0881, + 7.0583, + 7.0782, + 7.0714, + 7.172, + 7.0634, + 7.0387, + 7.0761, + 7.1624, + 7.0884, + 7.0871, + 7.0658, + 7.0226, + 7.1865 + ], + "successful_queries": 30, + "failed_queries": 0, + "observed_sequential_qps": 141.064, + "explain": { + "Plan": { + "Node Type": "Limit", + "Parallel Aware": false, + "Async Capable": false, + "Startup Cost": 4583.62, + "Total Cost": 4583.74, + "Plan Rows": 50, + "Plan Width": 162, + "Actual Startup Time": 6.726, + "Actual Total Time": 6.732, + "Actual Rows": 50, + "Actual Loops": 1, + "Shared Hit Blocks": 2017, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0, + "Plans": [ + { + "Node Type": "Sort", + "Parent Relationship": "Outer", + "Parallel Aware": false, + "Async Capable": false, + "Startup Cost": 4583.62, + "Total Cost": 4623.51, + "Plan Rows": 15957, + "Plan Width": 162, + "Actual Startup Time": 6.726, + "Actual Total Time": 6.728, + "Actual Rows": 50, + "Actual Loops": 1, + "Sort Key": [ + "created_at", + "id" + ], + "Sort Method": "quicksort", + "Sort Space Used": 50, + "Sort Space Type": "Memory", + "Shared Hit Blocks": 2017, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0, + "Plans": [ + { + "Node Type": "Index Scan", + "Parent Relationship": "Outer", + "Parallel Aware": false, + "Async Capable": false, + "Scan Direction": "Forward", + "Index Name": "messages_chat_only_idx", + "Relation Name": "messages", + "Alias": "messages", + "Startup Cost": 0.29, + "Total Cost": 4053.53, + "Plan Rows": 15957, + "Plan Width": 162, + "Actual Startup Time": 6.692, + "Actual Total Time": 6.715, + "Actual Rows": 100, + "Actual Loops": 1, + "Index Cond": "(chat_id = '00000000-0000-0000-0000-000000000001'::uuid)", + "Rows Removed by Index Recheck": 0, + "Filter": "(ROW(created_at, id) > ROW('2026-01-01 00:00:00.0799+00'::timestamp with time zone, '4c258fbb-7ab4-ca0e-1a48-23111d989887'::uuid))", + "Rows Removed by Filter": 79900, + "Shared Hit Blocks": 2017, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + } + ] + } + ] + }, + "Planning": { + "Shared Hit Blocks": 0, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + }, + "Planning Time": 0.044, + "Triggers": [], + "Execution Time": 6.74 + } + }, + { + "chat_size": 80000, + "query": "offset", + "latency_ms": { + "p50": 24.9378, + "p95": 28.3299, + "p99": 29.9997, + "mean": 25.4597 + }, + "raw_latency_ms": [ + 24.7768, + 24.6414, + 24.9378, + 24.4358, + 24.1052, + 24.2144, + 24.6242, + 24.3533, + 25.1993, + 25.3574, + 25.3675, + 29.9997, + 28.3299, + 25.9315, + 24.3103, + 23.9882, + 26.5002, + 27.6485, + 27.0724, + 27.0823, + 27.9675, + 27.3795, + 26.1129, + 26.4398, + 26.2524, + 23.8179, + 23.6142, + 23.2457, + 22.9133, + 23.1718 + ], + "successful_queries": 30, + "failed_queries": 0, + "observed_sequential_qps": 39.275, + "explain": { + "Plan": { + "Node Type": "Limit", + "Parallel Aware": false, + "Async Capable": false, + "Startup Cost": 16971.36, + "Total Cost": 16971.49, + "Plan Rows": 50, + "Plan Width": 162, + "Actual Startup Time": 51.018, + "Actual Total Time": 51.027, + "Actual Rows": 50, + "Actual Loops": 1, + "Shared Hit Blocks": 2017, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 1742, + "Temp Written Blocks": 1747, + "Plans": [ + { + "Node Type": "Sort", + "Parent Relationship": "Outer", + "Parallel Aware": false, + "Async Capable": false, + "Startup Cost": 16771.61, + "Total Cost": 16972.2, + "Plan Rows": 80233, + "Plan Width": 162, + "Actual Startup Time": 39.315, + "Actual Total Time": 48.181, + "Actual Rows": 79950, + "Actual Loops": 1, + "Sort Key": [ + "created_at", + "id" + ], + "Sort Method": "external merge", + "Sort Space Used": 13936, + "Sort Space Type": "Disk", + "Shared Hit Blocks": 2017, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 1742, + "Temp Written Blocks": 1747, + "Plans": [ + { + "Node Type": "Index Scan", + "Parent Relationship": "Outer", + "Parallel Aware": false, + "Async Capable": false, + "Scan Direction": "Forward", + "Index Name": "messages_chat_only_idx", + "Relation Name": "messages", + "Alias": "messages", + "Startup Cost": 0.29, + "Total Cost": 3652.37, + "Plan Rows": 80233, + "Plan Width": 162, + "Actual Startup Time": 0.01, + "Actual Total Time": 7.926, + "Actual Rows": 80000, + "Actual Loops": 1, + "Index Cond": "(chat_id = '00000000-0000-0000-0000-000000000001'::uuid)", + "Rows Removed by Index Recheck": 0, + "Shared Hit Blocks": 2017, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + } + ] + } + ] + }, + "Planning": { + "Shared Hit Blocks": 0, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + }, + "Planning Time": 0.072, + "Triggers": [], + "Execution Time": 51.932 + } + }, + { + "chat_size": 15000, + "query": "keyset", + "latency_ms": { + "p50": 1.4773, + "p95": 1.5489, + "p99": 1.5723, + "mean": 1.4867 + }, + "raw_latency_ms": [ + 1.4891, + 1.4852, + 1.5267, + 1.5221, + 1.4782, + 1.4716, + 1.4668, + 1.478, + 1.4559, + 1.4603, + 1.492, + 1.4773, + 1.459, + 1.4697, + 1.4777, + 1.4993, + 1.4817, + 1.4659, + 1.4485, + 1.4569, + 1.4668, + 1.5444, + 1.4605, + 1.4554, + 1.4745, + 1.5723, + 1.5445, + 1.5489, + 1.4955, + 1.4772 + ], + "successful_queries": 30, + "failed_queries": 0, + "observed_sequential_qps": 672.438, + "explain": { + "Plan": { + "Node Type": "Limit", + "Parallel Aware": false, + "Async Capable": false, + "Startup Cost": 779.4, + "Total Cost": 779.52, + "Plan Rows": 50, + "Plan Width": 162, + "Actual Startup Time": 1.266, + "Actual Total Time": 1.271, + "Actual Rows": 50, + "Actual Loops": 1, + "Shared Hit Blocks": 379, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0, + "Plans": [ + { + "Node Type": "Sort", + "Parent Relationship": "Outer", + "Parallel Aware": false, + "Async Capable": false, + "Startup Cost": 779.4, + "Total Cost": 781.27, + "Plan Rows": 747, + "Plan Width": 162, + "Actual Startup Time": 1.265, + "Actual Total Time": 1.267, + "Actual Rows": 50, + "Actual Loops": 1, + "Sort Key": [ + "created_at", + "id" + ], + "Sort Method": "quicksort", + "Sort Space Used": 50, + "Sort Space Type": "Memory", + "Shared Hit Blocks": 379, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0, + "Plans": [ + { + "Node Type": "Index Scan", + "Parent Relationship": "Outer", + "Parallel Aware": false, + "Async Capable": false, + "Scan Direction": "Forward", + "Index Name": "messages_chat_only_idx", + "Relation Name": "messages", + "Alias": "messages", + "Startup Cost": 0.29, + "Total Cost": 754.59, + "Plan Rows": 747, + "Plan Width": 162, + "Actual Startup Time": 1.243, + "Actual Total Time": 1.255, + "Actual Rows": 100, + "Actual Loops": 1, + "Index Cond": "(chat_id = '00000000-0000-0000-0000-000000000002'::uuid)", + "Rows Removed by Index Recheck": 0, + "Filter": "(ROW(created_at, id) > ROW('2026-01-01 00:00:00.0949+00'::timestamp with time zone, '83309d4e-6a9c-bf24-ec2c-d0ad8d47e31e'::uuid))", + "Rows Removed by Filter": 14900, + "Shared Hit Blocks": 379, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + } + ] + } + ] + }, + "Planning": { + "Shared Hit Blocks": 0, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + }, + "Planning Time": 0.074, + "Triggers": [], + "Execution Time": 1.279 + } + }, + { + "chat_size": 15000, + "query": "offset", + "latency_ms": { + "p50": 4.1769, + "p95": 8.9294, + "p99": 9.3571, + "mean": 4.5287 + }, + "raw_latency_ms": [ + 3.9992, + 4.1769, + 4.1085, + 9.3571, + 4.3402, + 4.0119, + 3.9902, + 4.159, + 4.0303, + 4.2165, + 4.5519, + 4.7326, + 4.3163, + 4.1272, + 4.8157, + 8.9294, + 4.4488, + 4.278, + 4.4118, + 4.1779, + 3.9815, + 4.3006, + 4.6323, + 3.932, + 3.8745, + 3.8335, + 3.9477, + 3.8701, + 3.9719, + 4.3378 + ], + "successful_queries": 30, + "failed_queries": 0, + "observed_sequential_qps": 220.78, + "explain": { + "Plan": { + "Node Type": "Limit", + "Parallel Aware": false, + "Async Capable": false, + "Startup Cost": 1743.69, + "Total Cost": 1743.69, + "Plan Rows": 1, + "Plan Width": 162, + "Actual Startup Time": 6.012, + "Actual Total Time": 6.02, + "Actual Rows": 50, + "Actual Loops": 1, + "Shared Hit Blocks": 379, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 328, + "Temp Written Blocks": 329, + "Plans": [ + { + "Node Type": "Sort", + "Parent Relationship": "Outer", + "Parallel Aware": false, + "Async Capable": false, + "Startup Cost": 1706.66, + "Total Cost": 1743.69, + "Plan Rows": 14813, + "Plan Width": 162, + "Actual Startup Time": 4.225, + "Actual Total Time": 5.504, + "Actual Rows": 14950, + "Actual Loops": 1, + "Sort Key": [ + "created_at", + "id" + ], + "Sort Method": "external merge", + "Sort Space Used": 2624, + "Sort Space Type": "Disk", + "Shared Hit Blocks": 379, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 328, + "Temp Written Blocks": 329, + "Plans": [ + { + "Node Type": "Index Scan", + "Parent Relationship": "Outer", + "Parallel Aware": false, + "Async Capable": false, + "Scan Direction": "Forward", + "Index Name": "messages_chat_only_idx", + "Relation Name": "messages", + "Alias": "messages", + "Startup Cost": 0.29, + "Total Cost": 680.52, + "Plan Rows": 14813, + "Plan Width": 162, + "Actual Startup Time": 0.006, + "Actual Total Time": 1.521, + "Actual Rows": 15000, + "Actual Loops": 1, + "Index Cond": "(chat_id = '00000000-0000-0000-0000-000000000002'::uuid)", + "Rows Removed by Index Recheck": 0, + "Shared Hit Blocks": 379, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + } + ] + } + ] + }, + "Planning": { + "Shared Hit Blocks": 0, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + }, + "Planning Time": 0.027, + "Triggers": [], + "Execution Time": 6.17 + } + }, + { + "chat_size": 4000, + "query": "keyset", + "latency_ms": { + "p50": 0.6269, + "p95": 0.8833, + "p99": 0.9718, + "mean": 0.6489 + }, + "raw_latency_ms": [ + 0.6667, + 0.6633, + 0.8833, + 0.6693, + 0.6508, + 0.7086, + 0.6538, + 0.7583, + 0.6407, + 0.7791, + 0.5865, + 0.6176, + 0.7591, + 0.9718, + 0.751, + 0.6269, + 0.6428, + 0.6371, + 0.5982, + 0.5791, + 0.5791, + 0.5623, + 0.5722, + 0.5835, + 0.5617, + 0.5422, + 0.5575, + 0.5559, + 0.546, + 0.5618 + ], + "successful_queries": 30, + "failed_queries": 0, + "observed_sequential_qps": 1539.583, + "explain": { + "Plan": { + "Node Type": "Limit", + "Parallel Aware": false, + "Async Capable": false, + "Startup Cost": 208.17, + "Total Cost": 208.27, + "Plan Rows": 43, + "Plan Width": 162, + "Actual Startup Time": 0.346, + "Actual Total Time": 0.352, + "Actual Rows": 50, + "Actual Loops": 1, + "Shared Hit Blocks": 104, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0, + "Plans": [ + { + "Node Type": "Sort", + "Parent Relationship": "Outer", + "Parallel Aware": false, + "Async Capable": false, + "Startup Cost": 208.17, + "Total Cost": 208.27, + "Plan Rows": 43, + "Plan Width": 162, + "Actual Startup Time": 0.346, + "Actual Total Time": 0.348, + "Actual Rows": 50, + "Actual Loops": 1, + "Sort Key": [ + "created_at", + "id" + ], + "Sort Method": "quicksort", + "Sort Space Used": 50, + "Sort Space Type": "Memory", + "Shared Hit Blocks": 104, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0, + "Plans": [ + { + "Node Type": "Index Scan", + "Parent Relationship": "Outer", + "Parallel Aware": false, + "Async Capable": false, + "Scan Direction": "Forward", + "Index Name": "messages_chat_only_idx", + "Relation Name": "messages", + "Alias": "messages", + "Startup Cost": 0.29, + "Total Cost": 207.0, + "Plan Rows": 43, + "Plan Width": 162, + "Actual Startup Time": 0.324, + "Actual Total Time": 0.336, + "Actual Rows": 100, + "Actual Loops": 1, + "Index Cond": "(chat_id = '00000000-0000-0000-0000-000000000003'::uuid)", + "Rows Removed by Index Recheck": 0, + "Filter": "(ROW(created_at, id) > ROW('2026-01-01 00:00:00.0989+00'::timestamp with time zone, '3ca7f544-85f6-3d47-6ce5-72ab53f46142'::uuid))", + "Rows Removed by Filter": 3900, + "Shared Hit Blocks": 104, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + } + ] + } + ] + }, + "Planning": { + "Shared Hit Blocks": 0, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + }, + "Planning Time": 0.077, + "Triggers": [], + "Execution Time": 0.36 + } + }, + { + "chat_size": 4000, + "query": "offset", + "latency_ms": { + "p50": 0.6617, + "p95": 1.123, + "p99": 1.5037, + "mean": 0.729 + }, + "raw_latency_ms": [ + 0.6681, + 0.6432, + 0.6471, + 0.6594, + 0.6617, + 0.6541, + 0.6335, + 0.6689, + 0.6442, + 0.6426, + 0.6442, + 0.658, + 0.7162, + 0.7088, + 0.8265, + 0.7309, + 0.677, + 0.668, + 0.651, + 0.6417, + 0.6567, + 0.6553, + 0.6392, + 0.6815, + 0.6943, + 0.7807, + 1.5037, + 0.8532, + 1.123, + 0.8366 + ], + "successful_queries": 30, + "failed_queries": 0, + "observed_sequential_qps": 1370.731, + "explain": { + "Plan": { + "Node Type": "Limit", + "Parallel Aware": false, + "Async Capable": false, + "Startup Cost": 435.26, + "Total Cost": 435.38, + "Plan Rows": 50, + "Plan Width": 162, + "Actual Startup Time": 0.976, + "Actual Total Time": 0.982, + "Actual Rows": 50, + "Actual Loops": 1, + "Shared Hit Blocks": 104, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0, + "Plans": [ + { + "Node Type": "Sort", + "Parent Relationship": "Outer", + "Parallel Aware": false, + "Async Capable": false, + "Startup Cost": 425.51, + "Total Cost": 435.48, + "Plan Rows": 3987, + "Plan Width": 162, + "Actual Startup Time": 0.671, + "Actual Total Time": 0.84, + "Actual Rows": 3950, + "Actual Loops": 1, + "Sort Key": [ + "created_at", + "id" + ], + "Sort Method": "quicksort", + "Sort Space Used": 1128, + "Sort Space Type": "Memory", + "Shared Hit Blocks": 104, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0, + "Plans": [ + { + "Node Type": "Index Scan", + "Parent Relationship": "Outer", + "Parallel Aware": false, + "Async Capable": false, + "Scan Direction": "Forward", + "Index Name": "messages_chat_only_idx", + "Relation Name": "messages", + "Alias": "messages", + "Startup Cost": 0.29, + "Total Cost": 187.06, + "Plan Rows": 3987, + "Plan Width": 162, + "Actual Startup Time": 0.005, + "Actual Total Time": 0.364, + "Actual Rows": 4000, + "Actual Loops": 1, + "Index Cond": "(chat_id = '00000000-0000-0000-0000-000000000003'::uuid)", + "Rows Removed by Index Recheck": 0, + "Shared Hit Blocks": 104, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + } + ] + } + ] + }, + "Planning": { + "Shared Hit Blocks": 0, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + }, + "Planning Time": 0.019, + "Triggers": [], + "Execution Time": 0.989 + } + }, + { + "chat_size": 1000, + "query": "keyset", + "latency_ms": { + "p50": 0.3048, + "p95": 0.443, + "p99": 0.6305, + "mean": 0.325 + }, + "raw_latency_ms": [ + 0.308, + 0.319, + 0.2923, + 0.294, + 0.3007, + 0.3048, + 0.3013, + 0.3191, + 0.3412, + 0.443, + 0.6305, + 0.3525, + 0.3222, + 0.3087, + 0.3078, + 0.3036, + 0.3035, + 0.3029, + 0.3091, + 0.2937, + 0.2918, + 0.3296, + 0.3577, + 0.3153, + 0.3032, + 0.3124, + 0.294, + 0.2951, + 0.3019, + 0.2896 + ], + "successful_queries": 30, + "failed_queries": 0, + "observed_sequential_qps": 3072.865, + "explain": { + "Plan": { + "Node Type": "Limit", + "Parallel Aware": false, + "Async Capable": false, + "Startup Cost": 53.06, + "Total Cost": 53.06, + "Plan Rows": 1, + "Plan Width": 162, + "Actual Startup Time": 0.101, + "Actual Total Time": 0.107, + "Actual Rows": 50, + "Actual Loops": 1, + "Shared Hit Blocks": 27, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0, + "Plans": [ + { + "Node Type": "Sort", + "Parent Relationship": "Outer", + "Parallel Aware": false, + "Async Capable": false, + "Startup Cost": 53.06, + "Total Cost": 53.06, + "Plan Rows": 1, + "Plan Width": 162, + "Actual Startup Time": 0.101, + "Actual Total Time": 0.103, + "Actual Rows": 50, + "Actual Loops": 1, + "Sort Key": [ + "created_at", + "id" + ], + "Sort Method": "quicksort", + "Sort Space Used": 50, + "Sort Space Type": "Memory", + "Shared Hit Blocks": 27, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0, + "Plans": [ + { + "Node Type": "Index Scan", + "Parent Relationship": "Outer", + "Parallel Aware": false, + "Async Capable": false, + "Scan Direction": "Forward", + "Index Name": "messages_chat_only_idx", + "Relation Name": "messages", + "Alias": "messages", + "Startup Cost": 0.29, + "Total Cost": 53.05, + "Plan Rows": 1, + "Plan Width": 162, + "Actual Startup Time": 0.08, + "Actual Total Time": 0.092, + "Actual Rows": 100, + "Actual Loops": 1, + "Index Cond": "(chat_id = '00000000-0000-0000-0000-000000000004'::uuid)", + "Rows Removed by Index Recheck": 0, + "Filter": "(ROW(created_at, id) > ROW('2026-01-01 00:00:00.0999+00'::timestamp with time zone, '7fa13929-f6d0-fc18-76f9-46306abe42ca'::uuid))", + "Rows Removed by Filter": 900, + "Shared Hit Blocks": 27, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + } + ] + } + ] + }, + "Planning": { + "Shared Hit Blocks": 0, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + }, + "Planning Time": 0.067, + "Triggers": [], + "Execution Time": 0.115 + } + }, + { + "chat_size": 1000, + "query": "offset", + "latency_ms": { + "p50": 0.3366, + "p95": 0.4242, + "p99": 0.4286, + "mean": 0.3492 + }, + "raw_latency_ms": [ + 0.3735, + 0.3238, + 0.3473, + 0.3185, + 0.319, + 0.3433, + 0.3205, + 0.3139, + 0.3342, + 0.3158, + 0.3344, + 0.3477, + 0.3227, + 0.3212, + 0.3645, + 0.3983, + 0.3515, + 0.354, + 0.3337, + 0.3295, + 0.4286, + 0.414, + 0.4242, + 0.389, + 0.3699, + 0.3508, + 0.3351, + 0.3229, + 0.3366, + 0.3368 + ], + "successful_queries": 30, + "failed_queries": 0, + "observed_sequential_qps": 2860.548, + "explain": { + "Plan": { + "Node Type": "Limit", + "Parallel Aware": false, + "Async Capable": false, + "Startup Cost": 98.42, + "Total Cost": 98.54, + "Plan Rows": 50, + "Plan Width": 162, + "Actual Startup Time": 0.298, + "Actual Total Time": 0.304, + "Actual Rows": 50, + "Actual Loops": 1, + "Shared Hit Blocks": 27, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0, + "Plans": [ + { + "Node Type": "Sort", + "Parent Relationship": "Outer", + "Parallel Aware": false, + "Async Capable": false, + "Startup Cost": 96.17, + "Total Cost": 98.58, + "Plan Rows": 967, + "Plan Width": 162, + "Actual Startup Time": 0.163, + "Actual Total Time": 0.242, + "Actual Rows": 950, + "Actual Loops": 1, + "Sort Key": [ + "created_at", + "id" + ], + "Sort Method": "quicksort", + "Sort Space Used": 282, + "Sort Space Type": "Memory", + "Shared Hit Blocks": 27, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0, + "Plans": [ + { + "Node Type": "Index Scan", + "Parent Relationship": "Outer", + "Parallel Aware": false, + "Async Capable": false, + "Scan Direction": "Forward", + "Index Name": "messages_chat_only_idx", + "Relation Name": "messages", + "Alias": "messages", + "Startup Cost": 0.29, + "Total Cost": 48.21, + "Plan Rows": 967, + "Plan Width": 162, + "Actual Startup Time": 0.004, + "Actual Total Time": 0.091, + "Actual Rows": 1000, + "Actual Loops": 1, + "Index Cond": "(chat_id = '00000000-0000-0000-0000-000000000004'::uuid)", + "Rows Removed by Index Recheck": 0, + "Shared Hit Blocks": 27, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + } + ] + } + ] + }, + "Planning": { + "Shared Hit Blocks": 0, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + }, + "Planning Time": 0.019, + "Triggers": [], + "Execution Time": 0.312 + } + } + ] + }, + { + "name": "keyset", + "database": "lab2_research_e09aa1b4_keyset", + "seed_seconds": 0.9453, + "table_bytes": 20021248, + "indexes_bytes": 11698176, + "write_runs": [ + { + "commit_wall_ms": 12.1678, + "execution_ms": 10.483, + "wal_bytes": 460176, + "shared_dirtied_blocks": 43 + }, + { + "commit_wall_ms": 11.4934, + "execution_ms": 10.325, + "wal_bytes": 474664, + "shared_dirtied_blocks": 46 + }, + { + "commit_wall_ms": 10.289, + "execution_ms": 9.276, + "wal_bytes": 463744, + "shared_dirtied_blocks": 44 + }, + { + "commit_wall_ms": 9.9325, + "execution_ms": 9.007, + "wal_bytes": 452800, + "shared_dirtied_blocks": 40 + }, + { + "commit_wall_ms": 9.5215, + "execution_ms": 8.692, + "wal_bytes": 437944, + "shared_dirtied_blocks": 36 + }, + { + "commit_wall_ms": 9.6942, + "execution_ms": 8.842, + "wal_bytes": 452928, + "shared_dirtied_blocks": 41 + }, + { + "commit_wall_ms": 9.3175, + "execution_ms": 8.613, + "wal_bytes": 441856, + "shared_dirtied_blocks": 37 + }, + { + "commit_wall_ms": 10.5368, + "execution_ms": 8.682, + "wal_bytes": 456408, + "shared_dirtied_blocks": 42 + }, + { + "commit_wall_ms": 11.4386, + "execution_ms": 10.19, + "wal_bytes": 445488, + "shared_dirtied_blocks": 38 + }, + { + "commit_wall_ms": 10.5862, + "execution_ms": 9.668, + "wal_bytes": 448912, + "shared_dirtied_blocks": 39 + } + ], + "write_commit_ms": { + "p50": 10.289, + "p95": 12.1678, + "p99": 12.1678, + "mean": 10.4977 + }, + "reads": [ + { + "chat_size": 80000, + "query": "keyset", + "latency_ms": { + "p50": 0.2249, + "p95": 0.2545, + "p99": 0.3508, + "mean": 0.2318 + }, + "raw_latency_ms": [ + 0.2507, + 0.2534, + 0.3508, + 0.2332, + 0.2198, + 0.2226, + 0.2395, + 0.2545, + 0.2281, + 0.2288, + 0.2328, + 0.2252, + 0.2284, + 0.225, + 0.2247, + 0.2362, + 0.2197, + 0.2186, + 0.2248, + 0.2344, + 0.22, + 0.222, + 0.2189, + 0.2172, + 0.2151, + 0.2249, + 0.2205, + 0.2218, + 0.2325, + 0.2104 + ], + "successful_queries": 30, + "failed_queries": 0, + "observed_sequential_qps": 4307.199, + "explain": { + "Plan": { + "Node Type": "Limit", + "Parallel Aware": false, + "Async Capable": false, + "Startup Cost": 0.42, + "Total Cost": 16.91, + "Plan Rows": 50, + "Plan Width": 162, + "Actual Startup Time": 0.004, + "Actual Total Time": 0.014, + "Actual Rows": 50, + "Actual Loops": 1, + "Shared Hit Blocks": 6, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0, + "Plans": [ + { + "Node Type": "Index Scan", + "Parent Relationship": "Outer", + "Parallel Aware": false, + "Async Capable": false, + "Scan Direction": "Forward", + "Index Name": "messages_chat_created_id_idx", + "Relation Name": "messages", + "Alias": "messages", + "Startup Cost": 0.42, + "Total Cost": 5376.21, + "Plan Rows": 16299, + "Plan Width": 162, + "Actual Startup Time": 0.004, + "Actual Total Time": 0.01, + "Actual Rows": 50, + "Actual Loops": 1, + "Index Cond": "((chat_id = '00000000-0000-0000-0000-000000000001'::uuid) AND (ROW(created_at, id) > ROW('2026-01-01 00:00:00.0799+00'::timestamp with time zone, '4c258fbb-7ab4-ca0e-1a48-23111d989887'::uuid)))", + "Rows Removed by Index Recheck": 0, + "Shared Hit Blocks": 6, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + } + ] + }, + "Planning": { + "Shared Hit Blocks": 0, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + }, + "Planning Time": 0.019, + "Triggers": [], + "Execution Time": 0.02 + } + }, + { + "chat_size": 80000, + "query": "offset", + "latency_ms": { + "p50": 6.9243, + "p95": 12.6501, + "p99": 15.0282, + "mean": 7.8992 + }, + "raw_latency_ms": [ + 6.9314, + 6.6215, + 6.6125, + 7.0876, + 6.4968, + 6.9243, + 6.571, + 6.2754, + 6.1013, + 6.1353, + 6.0583, + 6.721, + 6.1335, + 6.7827, + 10.0007, + 10.1573, + 9.4869, + 12.6501, + 10.1362, + 15.0282, + 12.1204, + 9.08, + 6.7563, + 6.2658, + 6.9835, + 8.125, + 7.2746, + 7.5422, + 7.3887, + 6.5264 + ], + "successful_queries": 30, + "failed_queries": 0, + "observed_sequential_qps": 126.569, + "explain": { + "Plan": { + "Node Type": "Limit", + "Parallel Aware": false, + "Async Capable": false, + "Startup Cost": 9467.91, + "Total Cost": 9468.02, + "Plan Rows": 1, + "Plan Width": 162, + "Actual Startup Time": 11.335, + "Actual Total Time": 11.345, + "Actual Rows": 50, + "Actual Loops": 1, + "Shared Hit Blocks": 2524, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0, + "Plans": [ + { + "Node Type": "Index Scan", + "Parent Relationship": "Outer", + "Parallel Aware": false, + "Async Capable": false, + "Scan Direction": "Forward", + "Index Name": "messages_chat_created_id_idx", + "Relation Name": "messages", + "Alias": "messages", + "Startup Cost": 0.42, + "Total Cost": 9467.91, + "Plan Rows": 79610, + "Plan Width": 162, + "Actual Startup Time": 0.008, + "Actual Total Time": 8.54, + "Actual Rows": 79950, + "Actual Loops": 1, + "Index Cond": "(chat_id = '00000000-0000-0000-0000-000000000001'::uuid)", + "Rows Removed by Index Recheck": 0, + "Shared Hit Blocks": 2524, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + } + ] + }, + "Planning": { + "Shared Hit Blocks": 0, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + }, + "Planning Time": 0.092, + "Triggers": [], + "Execution Time": 11.357 + } + }, + { + "chat_size": 15000, + "query": "keyset", + "latency_ms": { + "p50": 0.2069, + "p95": 0.2373, + "p99": 0.2455, + "mean": 0.2108 + }, + "raw_latency_ms": [ + 0.2373, + 0.2455, + 0.2286, + 0.2179, + 0.227, + 0.2261, + 0.202, + 0.1996, + 0.1972, + 0.1978, + 0.2108, + 0.1955, + 0.1995, + 0.196, + 0.1958, + 0.2084, + 0.1987, + 0.193, + 0.2089, + 0.2119, + 0.2058, + 0.2095, + 0.1917, + 0.1995, + 0.1935, + 0.2069, + 0.2285, + 0.2295, + 0.2328, + 0.2282 + ], + "successful_queries": 30, + "failed_queries": 0, + "observed_sequential_qps": 4736.312, + "explain": { + "Plan": { + "Node Type": "Limit", + "Parallel Aware": false, + "Async Capable": false, + "Startup Cost": 0.42, + "Total Cost": 79.7, + "Plan Rows": 50, + "Plan Width": 162, + "Actual Startup Time": 0.004, + "Actual Total Time": 0.014, + "Actual Rows": 50, + "Actual Loops": 1, + "Shared Hit Blocks": 6, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0, + "Plans": [ + { + "Node Type": "Index Scan", + "Parent Relationship": "Outer", + "Parallel Aware": false, + "Async Capable": false, + "Scan Direction": "Forward", + "Index Name": "messages_chat_created_id_idx", + "Relation Name": "messages", + "Alias": "messages", + "Startup Cost": 0.42, + "Total Cost": 1218.15, + "Plan Rows": 768, + "Plan Width": 162, + "Actual Startup Time": 0.004, + "Actual Total Time": 0.01, + "Actual Rows": 50, + "Actual Loops": 1, + "Index Cond": "((chat_id = '00000000-0000-0000-0000-000000000002'::uuid) AND (ROW(created_at, id) > ROW('2026-01-01 00:00:00.0949+00'::timestamp with time zone, '83309d4e-6a9c-bf24-ec2c-d0ad8d47e31e'::uuid)))", + "Rows Removed by Index Recheck": 0, + "Shared Hit Blocks": 6, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + } + ] + }, + "Planning": { + "Shared Hit Blocks": 0, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + }, + "Planning Time": 0.049, + "Triggers": [], + "Execution Time": 0.022 + } + }, + { + "chat_size": 15000, + "query": "offset", + "latency_ms": { + "p50": 1.3274, + "p95": 6.6483, + "p99": 6.7603, + "mean": 2.32 + }, + "raw_latency_ms": [ + 5.0241, + 4.5037, + 4.6073, + 4.7289, + 6.3138, + 6.6483, + 6.7603, + 1.871, + 1.3498, + 1.3344, + 1.2695, + 1.2741, + 1.3163, + 1.3274, + 1.2907, + 1.2879, + 1.3007, + 1.478, + 1.2978, + 1.2856, + 1.3245, + 1.2953, + 1.3345, + 1.3287, + 1.2874, + 1.2853, + 1.298, + 1.379, + 1.3168, + 1.4797 + ], + "successful_queries": 30, + "failed_queries": 0, + "observed_sequential_qps": 430.747, + "explain": { + "Plan": { + "Node Type": "Limit", + "Parallel Aware": false, + "Async Capable": false, + "Startup Cost": 4412.7, + "Total Cost": 4412.83, + "Plan Rows": 50, + "Plan Width": 162, + "Actual Startup Time": 7.498, + "Actual Total Time": 7.508, + "Actual Rows": 50, + "Actual Loops": 1, + "Shared Hit Blocks": 476, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 328, + "Temp Written Blocks": 329, + "Plans": [ + { + "Node Type": "Sort", + "Parent Relationship": "Outer", + "Parallel Aware": false, + "Async Capable": false, + "Startup Cost": 4375.45, + "Total Cost": 4414.49, + "Plan Rows": 15617, + "Plan Width": 162, + "Actual Startup Time": 5.713, + "Actual Total Time": 6.979, + "Actual Rows": 14950, + "Actual Loops": 1, + "Sort Key": [ + "created_at", + "id" + ], + "Sort Method": "external merge", + "Sort Space Used": 2624, + "Sort Space Type": "Disk", + "Shared Hit Blocks": 476, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 328, + "Temp Written Blocks": 329, + "Plans": [ + { + "Node Type": "Bitmap Heap Scan", + "Parent Relationship": "Outer", + "Parallel Aware": false, + "Async Capable": false, + "Relation Name": "messages", + "Alias": "messages", + "Startup Cost": 653.45, + "Total Cost": 3287.66, + "Plan Rows": 15617, + "Plan Width": 162, + "Actual Startup Time": 0.546, + "Actual Total Time": 1.806, + "Actual Rows": 15000, + "Actual Loops": 1, + "Recheck Cond": "(chat_id = '00000000-0000-0000-0000-000000000002'::uuid)", + "Rows Removed by Index Recheck": 0, + "Exact Heap Blocks": 366, + "Lossy Heap Blocks": 0, + "Shared Hit Blocks": 476, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0, + "Plans": [ + { + "Node Type": "Bitmap Index Scan", + "Parent Relationship": "Outer", + "Parallel Aware": false, + "Async Capable": false, + "Index Name": "messages_chat_created_id_idx", + "Startup Cost": 0.0, + "Total Cost": 649.54, + "Plan Rows": 15617, + "Plan Width": 0, + "Actual Startup Time": 0.503, + "Actual Total Time": 0.503, + "Actual Rows": 15000, + "Actual Loops": 1, + "Index Cond": "(chat_id = '00000000-0000-0000-0000-000000000002'::uuid)", + "Shared Hit Blocks": 110, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + } + ] + } + ] + } + ] + }, + "Planning": { + "Shared Hit Blocks": 0, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + }, + "Planning Time": 0.071, + "Triggers": [], + "Execution Time": 7.708 + } + }, + { + "chat_size": 4000, + "query": "keyset", + "latency_ms": { + "p50": 0.2088, + "p95": 0.2822, + "p99": 0.3122, + "mean": 0.2174 + }, + "raw_latency_ms": [ + 0.2822, + 0.2479, + 0.3122, + 0.2194, + 0.212, + 0.2153, + 0.2106, + 0.2297, + 0.2096, + 0.2075, + 0.2083, + 0.2098, + 0.2088, + 0.206, + 0.2078, + 0.2039, + 0.2222, + 0.2058, + 0.2023, + 0.2045, + 0.2015, + 0.2246, + 0.2021, + 0.2044, + 0.2014, + 0.2063, + 0.2127, + 0.201, + 0.2134, + 0.2276 + ], + "successful_queries": 30, + "failed_queries": 0, + "observed_sequential_qps": 4590.519, + "explain": { + "Plan": { + "Node Type": "Limit", + "Parallel Aware": false, + "Async Capable": false, + "Startup Cost": 0.42, + "Total Cost": 79.8, + "Plan Rows": 41, + "Plan Width": 162, + "Actual Startup Time": 0.006, + "Actual Total Time": 0.014, + "Actual Rows": 50, + "Actual Loops": 1, + "Shared Hit Blocks": 5, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0, + "Plans": [ + { + "Node Type": "Index Scan", + "Parent Relationship": "Outer", + "Parallel Aware": false, + "Async Capable": false, + "Scan Direction": "Forward", + "Index Name": "messages_chat_created_id_idx", + "Relation Name": "messages", + "Alias": "messages", + "Startup Cost": 0.42, + "Total Cost": 79.8, + "Plan Rows": 41, + "Plan Width": 162, + "Actual Startup Time": 0.005, + "Actual Total Time": 0.01, + "Actual Rows": 50, + "Actual Loops": 1, + "Index Cond": "((chat_id = '00000000-0000-0000-0000-000000000003'::uuid) AND (ROW(created_at, id) > ROW('2026-01-01 00:00:00.0989+00'::timestamp with time zone, '3ca7f544-85f6-3d47-6ce5-72ab53f46142'::uuid)))", + "Rows Removed by Index Recheck": 0, + "Shared Hit Blocks": 5, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + } + ] + }, + "Planning": { + "Shared Hit Blocks": 0, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + }, + "Planning Time": 0.081, + "Triggers": [], + "Execution Time": 0.021 + } + }, + { + "chat_size": 4000, + "query": "offset", + "latency_ms": { + "p50": 0.5051, + "p95": 0.657, + "p99": 0.7066, + "mean": 0.5265 + }, + "raw_latency_ms": [ + 0.4957, + 0.4786, + 0.5126, + 0.5663, + 0.5825, + 0.5162, + 0.4861, + 0.5071, + 0.7066, + 0.657, + 0.5481, + 0.5051, + 0.489, + 0.4827, + 0.5018, + 0.5004, + 0.483, + 0.4886, + 0.4746, + 0.4971, + 0.4819, + 0.6243, + 0.559, + 0.5098, + 0.5098, + 0.4855, + 0.4931, + 0.5078, + 0.627, + 0.5188 + ], + "successful_queries": 30, + "failed_queries": 0, + "observed_sequential_qps": 1897.228, + "explain": { + "Plan": { + "Node Type": "Limit", + "Parallel Aware": false, + "Async Capable": false, + "Startup Cost": 2991.44, + "Total Cost": 2991.44, + "Plan Rows": 1, + "Plan Width": 162, + "Actual Startup Time": 1.111, + "Actual Total Time": 1.117, + "Actual Rows": 50, + "Actual Loops": 1, + "Shared Hit Blocks": 131, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0, + "Plans": [ + { + "Node Type": "Sort", + "Parent Relationship": "Outer", + "Parallel Aware": false, + "Async Capable": false, + "Startup Cost": 2982.0, + "Total Cost": 2991.44, + "Plan Rows": 3777, + "Plan Width": 162, + "Actual Startup Time": 0.79, + "Actual Total Time": 0.976, + "Actual Rows": 3950, + "Actual Loops": 1, + "Sort Key": [ + "created_at", + "id" + ], + "Sort Method": "quicksort", + "Sort Space Used": 1128, + "Sort Space Type": "Memory", + "Shared Hit Blocks": 131, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0, + "Plans": [ + { + "Node Type": "Bitmap Heap Scan", + "Parent Relationship": "Outer", + "Parallel Aware": false, + "Async Capable": false, + "Relation Name": "messages", + "Alias": "messages", + "Startup Cost": 161.69, + "Total Cost": 2757.59, + "Plan Rows": 3777, + "Plan Width": 162, + "Actual Startup Time": 0.152, + "Actual Total Time": 0.46, + "Actual Rows": 4000, + "Actual Loops": 1, + "Recheck Cond": "(chat_id = '00000000-0000-0000-0000-000000000003'::uuid)", + "Rows Removed by Index Recheck": 0, + "Exact Heap Blocks": 99, + "Lossy Heap Blocks": 0, + "Shared Hit Blocks": 131, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0, + "Plans": [ + { + "Node Type": "Bitmap Index Scan", + "Parent Relationship": "Outer", + "Parallel Aware": false, + "Async Capable": false, + "Index Name": "messages_chat_created_id_idx", + "Startup Cost": 0.0, + "Total Cost": 160.74, + "Plan Rows": 3777, + "Plan Width": 0, + "Actual Startup Time": 0.139, + "Actual Total Time": 0.139, + "Actual Rows": 4000, + "Actual Loops": 1, + "Index Cond": "(chat_id = '00000000-0000-0000-0000-000000000003'::uuid)", + "Shared Hit Blocks": 32, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + } + ] + } + ] + } + ] + }, + "Planning": { + "Shared Hit Blocks": 0, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + }, + "Planning Time": 0.068, + "Triggers": [], + "Execution Time": 1.129 + } + }, + { + "chat_size": 1000, + "query": "keyset", + "latency_ms": { + "p50": 0.1998, + "p95": 0.235, + "p99": 0.2685, + "mean": 0.205 + }, + "raw_latency_ms": [ + 0.2064, + 0.2084, + 0.1998, + 0.2078, + 0.2144, + 0.1987, + 0.1991, + 0.1996, + 0.1965, + 0.2004, + 0.1998, + 0.2007, + 0.1957, + 0.1992, + 0.2052, + 0.1958, + 0.1978, + 0.1942, + 0.1949, + 0.2148, + 0.1981, + 0.1933, + 0.1977, + 0.1944, + 0.2685, + 0.235, + 0.2088, + 0.2044, + 0.2183, + 0.203 + ], + "successful_queries": 30, + "failed_queries": 0, + "observed_sequential_qps": 4868.845, + "explain": { + "Plan": { + "Node Type": "Limit", + "Parallel Aware": false, + "Async Capable": false, + "Startup Cost": 0.42, + "Total Cost": 8.44, + "Plan Rows": 1, + "Plan Width": 162, + "Actual Startup Time": 0.005, + "Actual Total Time": 0.013, + "Actual Rows": 50, + "Actual Loops": 1, + "Shared Hit Blocks": 5, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0, + "Plans": [ + { + "Node Type": "Index Scan", + "Parent Relationship": "Outer", + "Parallel Aware": false, + "Async Capable": false, + "Scan Direction": "Forward", + "Index Name": "messages_chat_created_id_idx", + "Relation Name": "messages", + "Alias": "messages", + "Startup Cost": 0.42, + "Total Cost": 8.44, + "Plan Rows": 1, + "Plan Width": 162, + "Actual Startup Time": 0.004, + "Actual Total Time": 0.009, + "Actual Rows": 50, + "Actual Loops": 1, + "Index Cond": "((chat_id = '00000000-0000-0000-0000-000000000004'::uuid) AND (ROW(created_at, id) > ROW('2026-01-01 00:00:00.0999+00'::timestamp with time zone, '7fa13929-f6d0-fc18-76f9-46306abe42ca'::uuid)))", + "Rows Removed by Index Recheck": 0, + "Shared Hit Blocks": 5, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + } + ] + }, + "Planning": { + "Shared Hit Blocks": 0, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + }, + "Planning Time": 0.061, + "Triggers": [], + "Execution Time": 0.019 + } + }, + { + "chat_size": 1000, + "query": "offset", + "latency_ms": { + "p50": 0.2825, + "p95": 0.517, + "p99": 0.5368, + "mean": 0.3155 + }, + "raw_latency_ms": [ + 0.2628, + 0.2779, + 0.2633, + 0.2621, + 0.273, + 0.2787, + 0.2618, + 0.2817, + 0.2825, + 0.2827, + 0.2667, + 0.2641, + 0.2825, + 0.2986, + 0.3225, + 0.5368, + 0.3892, + 0.4551, + 0.3943, + 0.517, + 0.3484, + 0.2773, + 0.2941, + 0.2827, + 0.377, + 0.2994, + 0.303, + 0.2738, + 0.2835, + 0.2713 + ], + "successful_queries": 30, + "failed_queries": 0, + "observed_sequential_qps": 3164.696, + "explain": { + "Plan": { + "Node Type": "Limit", + "Parallel Aware": false, + "Async Capable": false, + "Startup Cost": 1370.91, + "Total Cost": 1447.05, + "Plan Rows": 50, + "Plan Width": 162, + "Actual Startup Time": 0.128, + "Actual Total Time": 0.136, + "Actual Rows": 50, + "Actual Loops": 1, + "Shared Hit Blocks": 33, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0, + "Plans": [ + { + "Node Type": "Index Scan", + "Parent Relationship": "Outer", + "Parallel Aware": false, + "Async Capable": false, + "Scan Direction": "Forward", + "Index Name": "messages_chat_created_id_idx", + "Relation Name": "messages", + "Alias": "messages", + "Startup Cost": 0.42, + "Total Cost": 1518.62, + "Plan Rows": 997, + "Plan Width": 162, + "Actual Startup Time": 0.005, + "Actual Total Time": 0.101, + "Actual Rows": 950, + "Actual Loops": 1, + "Index Cond": "(chat_id = '00000000-0000-0000-0000-000000000004'::uuid)", + "Rows Removed by Index Recheck": 0, + "Shared Hit Blocks": 33, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + } + ] + }, + "Planning": { + "Shared Hit Blocks": 0, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + }, + "Planning Time": 0.062, + "Triggers": [], + "Execution Time": 0.145 + } + } + ] + }, + { + "name": "covering", + "database": "lab2_research_e09aa1b4_covering", + "seed_seconds": 1.1557, + "table_bytes": 20021248, + "indexes_bytes": 28950528, + "write_runs": [ + { + "commit_wall_ms": 15.6168, + "execution_ms": 13.013, + "wal_bytes": 715344, + "shared_dirtied_blocks": 74 + }, + { + "commit_wall_ms": 44.015, + "execution_ms": 42.11, + "wal_bytes": 729608, + "shared_dirtied_blocks": 77 + }, + { + "commit_wall_ms": 14.7893, + "execution_ms": 12.95, + "wal_bytes": 719000, + "shared_dirtied_blocks": 75 + }, + { + "commit_wall_ms": 13.9626, + "execution_ms": 12.09, + "wal_bytes": 704008, + "shared_dirtied_blocks": 70 + }, + { + "commit_wall_ms": 13.266, + "execution_ms": 11.369, + "wal_bytes": 700848, + "shared_dirtied_blocks": 69 + }, + { + "commit_wall_ms": 64.6203, + "execution_ms": 61.422, + "wal_bytes": 700376, + "shared_dirtied_blocks": 70 + }, + { + "commit_wall_ms": 11.2113, + "execution_ms": 9.845, + "wal_bytes": 700848, + "shared_dirtied_blocks": 69 + }, + { + "commit_wall_ms": 11.6234, + "execution_ms": 10.102, + "wal_bytes": 707616, + "shared_dirtied_blocks": 72 + }, + { + "commit_wall_ms": 11.3013, + "execution_ms": 9.977, + "wal_bytes": 700744, + "shared_dirtied_blocks": 69 + }, + { + "commit_wall_ms": 60.1216, + "execution_ms": 59.042, + "wal_bytes": 707768, + "shared_dirtied_blocks": 71 + } + ], + "write_commit_ms": { + "p50": 13.9626, + "p95": 64.6203, + "p99": 64.6203, + "mean": 26.0528 + }, + "reads": [ + { + "chat_size": 80000, + "query": "keyset", + "latency_ms": { + "p50": 0.1993, + "p95": 0.3393, + "p99": 0.404, + "mean": 0.2336 + }, + "raw_latency_ms": [ + 0.2973, + 0.2685, + 0.3393, + 0.3388, + 0.2843, + 0.3033, + 0.2897, + 0.2492, + 0.2006, + 0.1993, + 0.1923, + 0.1936, + 0.1787, + 0.1749, + 0.1877, + 0.1749, + 0.2028, + 0.1818, + 0.1763, + 0.1728, + 0.1942, + 0.1722, + 0.1774, + 0.1911, + 0.1755, + 0.2407, + 0.3043, + 0.271, + 0.2699, + 0.404 + ], + "successful_queries": 30, + "failed_queries": 0, + "observed_sequential_qps": 4272.262, + "explain": { + "Plan": { + "Node Type": "Limit", + "Parallel Aware": false, + "Async Capable": false, + "Startup Cost": 0.42, + "Total Cost": 7.34, + "Plan Rows": 50, + "Plan Width": 162, + "Actual Startup Time": 0.006, + "Actual Total Time": 0.015, + "Actual Rows": 50, + "Actual Loops": 1, + "Shared Hit Blocks": 5, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0, + "Plans": [ + { + "Node Type": "Index Only Scan", + "Parent Relationship": "Outer", + "Parallel Aware": false, + "Async Capable": false, + "Scan Direction": "Forward", + "Index Name": "messages_chat_covering_idx", + "Relation Name": "messages", + "Alias": "messages", + "Startup Cost": 0.42, + "Total Cost": 2212.08, + "Plan Rows": 15983, + "Plan Width": 162, + "Actual Startup Time": 0.006, + "Actual Total Time": 0.011, + "Actual Rows": 50, + "Actual Loops": 1, + "Index Cond": "((chat_id = '00000000-0000-0000-0000-000000000001'::uuid) AND (ROW(created_at, id) > ROW('2026-01-01 00:00:00.0799+00'::timestamp with time zone, '4c258fbb-7ab4-ca0e-1a48-23111d989887'::uuid)))", + "Rows Removed by Index Recheck": 0, + "Heap Fetches": 0, + "Shared Hit Blocks": 5, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + } + ] + }, + "Planning": { + "Shared Hit Blocks": 0, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + }, + "Planning Time": 0.035, + "Triggers": [], + "Execution Time": 0.024 + } + }, + { + "chat_size": 80000, + "query": "offset", + "latency_ms": { + "p50": 6.7655, + "p95": 7.1888, + "p99": 7.3155, + "mean": 6.8453 + }, + "raw_latency_ms": [ + 6.7905, + 6.9868, + 7.1641, + 6.7145, + 6.6758, + 6.662, + 6.7611, + 6.7655, + 6.5623, + 6.5497, + 6.7386, + 7.0508, + 7.3155, + 6.9717, + 6.9465, + 7.09, + 7.1888, + 7.1567, + 6.6796, + 7.0895, + 7.0182, + 6.9527, + 6.6477, + 6.5414, + 6.8389, + 6.5921, + 6.9738, + 6.6531, + 6.5765, + 6.7053 + ], + "successful_queries": 30, + "failed_queries": 0, + "observed_sequential_qps": 146.073, + "explain": { + "Plan": { + "Node Type": "Limit", + "Parallel Aware": false, + "Async Capable": false, + "Startup Cost": 10853.18, + "Total Cost": 10859.97, + "Plan Rows": 50, + "Plan Width": 162, + "Actual Startup Time": 11.598, + "Actual Total Time": 11.608, + "Actual Rows": 50, + "Actual Loops": 1, + "Shared Hit Blocks": 2002, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0, + "Plans": [ + { + "Node Type": "Index Only Scan", + "Parent Relationship": "Outer", + "Parallel Aware": false, + "Async Capable": false, + "Scan Direction": "Forward", + "Index Name": "messages_chat_covering_idx", + "Relation Name": "messages", + "Alias": "messages", + "Startup Cost": 0.42, + "Total Cost": 10891.62, + "Plan Rows": 80183, + "Plan Width": 162, + "Actual Startup Time": 0.005, + "Actual Total Time": 8.823, + "Actual Rows": 79950, + "Actual Loops": 1, + "Index Cond": "(chat_id = '00000000-0000-0000-0000-000000000001'::uuid)", + "Rows Removed by Index Recheck": 0, + "Heap Fetches": 0, + "Shared Hit Blocks": 2002, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + } + ] + }, + "Planning": { + "Shared Hit Blocks": 0, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + }, + "Planning Time": 0.04, + "Triggers": [], + "Execution Time": 11.616 + } + }, + { + "chat_size": 15000, + "query": "keyset", + "latency_ms": { + "p50": 0.2027, + "p95": 0.2262, + "p99": 0.2397, + "mean": 0.206 + }, + "raw_latency_ms": [ + 0.2262, + 0.2397, + 0.205, + 0.2123, + 0.1969, + 0.2053, + 0.1981, + 0.2071, + 0.2027, + 0.2019, + 0.2212, + 0.2054, + 0.2026, + 0.1926, + 0.217, + 0.204, + 0.2045, + 0.2001, + 0.2007, + 0.201, + 0.2068, + 0.2013, + 0.2023, + 0.2004, + 0.1986, + 0.2043, + 0.203, + 0.1992, + 0.2018, + 0.2174 + ], + "successful_queries": 30, + "failed_queries": 0, + "observed_sequential_qps": 4840.044, + "explain": { + "Plan": { + "Node Type": "Limit", + "Parallel Aware": false, + "Async Capable": false, + "Startup Cost": 0.42, + "Total Cost": 7.36, + "Plan Rows": 50, + "Plan Width": 162, + "Actual Startup Time": 0.005, + "Actual Total Time": 0.014, + "Actual Rows": 50, + "Actual Loops": 1, + "Shared Hit Blocks": 5, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0, + "Plans": [ + { + "Node Type": "Index Only Scan", + "Parent Relationship": "Outer", + "Parallel Aware": false, + "Async Capable": false, + "Scan Direction": "Forward", + "Index Name": "messages_chat_covering_idx", + "Relation Name": "messages", + "Alias": "messages", + "Startup Cost": 0.42, + "Total Cost": 103.22, + "Plan Rows": 740, + "Plan Width": 162, + "Actual Startup Time": 0.005, + "Actual Total Time": 0.01, + "Actual Rows": 50, + "Actual Loops": 1, + "Index Cond": "((chat_id = '00000000-0000-0000-0000-000000000002'::uuid) AND (ROW(created_at, id) > ROW('2026-01-01 00:00:00.0949+00'::timestamp with time zone, '83309d4e-6a9c-bf24-ec2c-d0ad8d47e31e'::uuid)))", + "Rows Removed by Index Recheck": 0, + "Heap Fetches": 0, + "Shared Hit Blocks": 5, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + } + ] + }, + "Planning": { + "Shared Hit Blocks": 0, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + }, + "Planning Time": 0.043, + "Triggers": [], + "Execution Time": 0.021 + } + }, + { + "chat_size": 15000, + "query": "offset", + "latency_ms": { + "p50": 1.374, + "p95": 1.5291, + "p99": 1.5962, + "mean": 1.3926 + }, + "raw_latency_ms": [ + 1.4307, + 1.4245, + 1.5962, + 1.4651, + 1.3905, + 1.4193, + 1.5291, + 1.3768, + 1.3905, + 1.4379, + 1.374, + 1.376, + 1.3632, + 1.3709, + 1.4246, + 1.3796, + 1.3833, + 1.3908, + 1.3711, + 1.3649, + 1.3535, + 1.3539, + 1.3552, + 1.349, + 1.361, + 1.3386, + 1.3488, + 1.3593, + 1.3514, + 1.3469 + ], + "successful_queries": 30, + "failed_queries": 0, + "observed_sequential_qps": 717.922, + "explain": { + "Plan": { + "Node Type": "Limit", + "Parallel Aware": false, + "Async Capable": false, + "Startup Cost": 2024.08, + "Total Cost": 2029.92, + "Plan Rows": 43, + "Plan Width": 162, + "Actual Startup Time": 2.174, + "Actual Total Time": 2.182, + "Actual Rows": 50, + "Actual Loops": 1, + "Shared Hit Blocks": 378, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0, + "Plans": [ + { + "Node Type": "Index Only Scan", + "Parent Relationship": "Outer", + "Parallel Aware": false, + "Async Capable": false, + "Scan Direction": "Forward", + "Index Name": "messages_chat_covering_idx", + "Relation Name": "messages", + "Alias": "messages", + "Startup Cost": 0.42, + "Total Cost": 2029.92, + "Plan Rows": 14943, + "Plan Width": 162, + "Actual Startup Time": 0.004, + "Actual Total Time": 1.656, + "Actual Rows": 14950, + "Actual Loops": 1, + "Index Cond": "(chat_id = '00000000-0000-0000-0000-000000000002'::uuid)", + "Rows Removed by Index Recheck": 0, + "Heap Fetches": 0, + "Shared Hit Blocks": 378, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + } + ] + }, + "Planning": { + "Shared Hit Blocks": 0, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + }, + "Planning Time": 0.048, + "Triggers": [], + "Execution Time": 2.19 + } + }, + { + "chat_size": 4000, + "query": "keyset", + "latency_ms": { + "p50": 0.1897, + "p95": 0.2183, + "p99": 0.2226, + "mean": 0.1935 + }, + "raw_latency_ms": [ + 0.2042, + 0.1914, + 0.1933, + 0.1903, + 0.1881, + 0.2226, + 0.1908, + 0.1906, + 0.193, + 0.1909, + 0.2183, + 0.1887, + 0.1887, + 0.1891, + 0.1897, + 0.2016, + 0.1895, + 0.1887, + 0.1882, + 0.1892, + 0.2019, + 0.1897, + 0.1883, + 0.1885, + 0.1879, + 0.1982, + 0.1983, + 0.1892, + 0.1875, + 0.1883 + ], + "successful_queries": 30, + "failed_queries": 0, + "observed_sequential_qps": 5160.995, + "explain": { + "Plan": { + "Node Type": "Limit", + "Parallel Aware": false, + "Async Capable": false, + "Startup Cost": 0.42, + "Total Cost": 9.32, + "Plan Rows": 45, + "Plan Width": 162, + "Actual Startup Time": 0.004, + "Actual Total Time": 0.013, + "Actual Rows": 50, + "Actual Loops": 1, + "Shared Hit Blocks": 5, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0, + "Plans": [ + { + "Node Type": "Index Only Scan", + "Parent Relationship": "Outer", + "Parallel Aware": false, + "Async Capable": false, + "Scan Direction": "Forward", + "Index Name": "messages_chat_covering_idx", + "Relation Name": "messages", + "Alias": "messages", + "Startup Cost": 0.42, + "Total Cost": 9.32, + "Plan Rows": 45, + "Plan Width": 162, + "Actual Startup Time": 0.004, + "Actual Total Time": 0.009, + "Actual Rows": 50, + "Actual Loops": 1, + "Index Cond": "((chat_id = '00000000-0000-0000-0000-000000000003'::uuid) AND (ROW(created_at, id) > ROW('2026-01-01 00:00:00.0989+00'::timestamp with time zone, '3ca7f544-85f6-3d47-6ce5-72ab53f46142'::uuid)))", + "Rows Removed by Index Recheck": 0, + "Heap Fetches": 0, + "Shared Hit Blocks": 5, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + } + ] + }, + "Planning": { + "Shared Hit Blocks": 0, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + }, + "Planning Time": 0.026, + "Triggers": [], + "Execution Time": 0.019 + } + }, + { + "chat_size": 4000, + "query": "offset", + "latency_ms": { + "p50": 0.508, + "p95": 0.7336, + "p99": 0.8249, + "mean": 0.5293 + }, + "raw_latency_ms": [ + 0.5041, + 0.5104, + 0.5184, + 0.512, + 0.5033, + 0.5045, + 0.5045, + 0.5029, + 0.511, + 0.4992, + 0.5117, + 0.4985, + 0.5143, + 0.4954, + 0.5082, + 0.4949, + 0.5114, + 0.4978, + 0.5138, + 0.4957, + 0.508, + 0.4949, + 0.5196, + 0.497, + 0.5098, + 0.4977, + 0.5486, + 0.8249, + 0.7336, + 0.632 + ], + "successful_queries": 30, + "failed_queries": 0, + "observed_sequential_qps": 1888.336, + "explain": { + "Plan": { + "Node Type": "Limit", + "Parallel Aware": false, + "Async Capable": false, + "Startup Cost": 514.62, + "Total Cost": 514.76, + "Plan Rows": 1, + "Plan Width": 162, + "Actual Startup Time": 0.605, + "Actual Total Time": 0.614, + "Actual Rows": 50, + "Actual Loops": 1, + "Shared Hit Blocks": 103, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0, + "Plans": [ + { + "Node Type": "Index Only Scan", + "Parent Relationship": "Outer", + "Parallel Aware": false, + "Async Capable": false, + "Scan Direction": "Forward", + "Index Name": "messages_chat_covering_idx", + "Relation Name": "messages", + "Alias": "messages", + "Startup Cost": 0.42, + "Total Cost": 514.62, + "Plan Rows": 3783, + "Plan Width": 162, + "Actual Startup Time": 0.005, + "Actual Total Time": 0.474, + "Actual Rows": 3950, + "Actual Loops": 1, + "Index Cond": "(chat_id = '00000000-0000-0000-0000-000000000003'::uuid)", + "Rows Removed by Index Recheck": 0, + "Heap Fetches": 0, + "Shared Hit Blocks": 103, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + } + ] + }, + "Planning": { + "Shared Hit Blocks": 0, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + }, + "Planning Time": 0.048, + "Triggers": [], + "Execution Time": 0.625 + } + }, + { + "chat_size": 1000, + "query": "keyset", + "latency_ms": { + "p50": 0.1999, + "p95": 0.2138, + "p99": 0.2153, + "mean": 0.2028 + }, + "raw_latency_ms": [ + 0.2033, + 0.2018, + 0.2092, + 0.2134, + 0.1999, + 0.2019, + 0.1978, + 0.1956, + 0.212, + 0.1998, + 0.199, + 0.1997, + 0.202, + 0.2108, + 0.1981, + 0.1999, + 0.1938, + 0.1989, + 0.2117, + 0.2138, + 0.2048, + 0.1965, + 0.2067, + 0.2068, + 0.1985, + 0.199, + 0.1949, + 0.1968, + 0.2153, + 0.2018 + ], + "successful_queries": 30, + "failed_queries": 0, + "observed_sequential_qps": 4925.03, + "explain": { + "Plan": { + "Node Type": "Limit", + "Parallel Aware": false, + "Async Capable": false, + "Startup Cost": 0.42, + "Total Cost": 4.44, + "Plan Rows": 1, + "Plan Width": 162, + "Actual Startup Time": 0.004, + "Actual Total Time": 0.014, + "Actual Rows": 50, + "Actual Loops": 1, + "Shared Hit Blocks": 5, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0, + "Plans": [ + { + "Node Type": "Index Only Scan", + "Parent Relationship": "Outer", + "Parallel Aware": false, + "Async Capable": false, + "Scan Direction": "Forward", + "Index Name": "messages_chat_covering_idx", + "Relation Name": "messages", + "Alias": "messages", + "Startup Cost": 0.42, + "Total Cost": 4.44, + "Plan Rows": 1, + "Plan Width": 162, + "Actual Startup Time": 0.004, + "Actual Total Time": 0.01, + "Actual Rows": 50, + "Actual Loops": 1, + "Index Cond": "((chat_id = '00000000-0000-0000-0000-000000000004'::uuid) AND (ROW(created_at, id) > ROW('2026-01-01 00:00:00.0999+00'::timestamp with time zone, '7fa13929-f6d0-fc18-76f9-46306abe42ca'::uuid)))", + "Rows Removed by Index Recheck": 0, + "Heap Fetches": 0, + "Shared Hit Blocks": 5, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + } + ] + }, + "Planning": { + "Shared Hit Blocks": 0, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + }, + "Planning Time": 0.052, + "Triggers": [], + "Execution Time": 0.02 + } + }, + { + "chat_size": 1000, + "query": "offset", + "latency_ms": { + "p50": 0.2774, + "p95": 0.3663, + "p99": 0.4765, + "mean": 0.2948 + }, + "raw_latency_ms": [ + 0.2676, + 0.2789, + 0.2774, + 0.2675, + 0.2674, + 0.3249, + 0.3167, + 0.3663, + 0.4765, + 0.3109, + 0.3213, + 0.3049, + 0.2712, + 0.269, + 0.2758, + 0.3097, + 0.3083, + 0.3037, + 0.2809, + 0.2744, + 0.2719, + 0.2951, + 0.2722, + 0.2711, + 0.2714, + 0.2699, + 0.2692, + 0.2675, + 0.2922, + 0.2889 + ], + "successful_queries": 30, + "failed_queries": 0, + "observed_sequential_qps": 3388.315, + "explain": { + "Plan": { + "Node Type": "Limit", + "Parallel Aware": false, + "Async Capable": false, + "Startup Cost": 125.16, + "Total Cost": 132.09, + "Plan Rows": 50, + "Plan Width": 162, + "Actual Startup Time": 0.143, + "Actual Total Time": 0.151, + "Actual Rows": 50, + "Actual Loops": 1, + "Shared Hit Blocks": 28, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0, + "Plans": [ + { + "Node Type": "Index Only Scan", + "Parent Relationship": "Outer", + "Parallel Aware": false, + "Async Capable": false, + "Scan Direction": "Forward", + "Index Name": "messages_chat_covering_idx", + "Relation Name": "messages", + "Alias": "messages", + "Startup Cost": 0.42, + "Total Cost": 151.49, + "Plan Rows": 1090, + "Plan Width": 162, + "Actual Startup Time": 0.003, + "Actual Total Time": 0.116, + "Actual Rows": 950, + "Actual Loops": 1, + "Index Cond": "(chat_id = '00000000-0000-0000-0000-000000000004'::uuid)", + "Rows Removed by Index Recheck": 0, + "Heap Fetches": 0, + "Shared Hit Blocks": 28, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + } + ] + }, + "Planning": { + "Shared Hit Blocks": 0, + "Shared Read Blocks": 0, + "Shared Dirtied Blocks": 0, + "Shared Written Blocks": 0, + "Local Hit Blocks": 0, + "Local Read Blocks": 0, + "Local Dirtied Blocks": 0, + "Local Written Blocks": 0, + "Temp Read Blocks": 0, + "Temp Written Blocks": 0 + }, + "Planning Time": 0.039, + "Triggers": [], + "Execution Time": 0.157 + } + } + ] + } + ], + "databases": [ + "lab2_research_e09aa1b4_chat_only", + "lab2_research_e09aa1b4_keyset", + "lab2_research_e09aa1b4_covering" + ], + "backup_source": "lab2_research_e09aa1b4_keyset", + "before_backup": { + "counts": { + "users": 1, + "chats": 4, + "chat_members": 4, + "messages": 100000, + "sessions": 1, + "schema_migrations": 1, + "app_settings": 1 + }, + "all_messages_sha256": "dfdcdff4be5c439c47e7d26869631c0242760c92e0706d5977ccbad9d2d2ab7f", + "selected_messages": [ + [ + "7bb1fec0-75f7-3359-0707-a34b46f176e9", + "00000000-0000-0000-0000-000000000001", + "11111111-1111-4111-8111-111111111111", + "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx:1", + "2026-01-01 00:00:00.000001+00:00" + ], + [ + "7db39161-2ccb-46b3-0e44-acfd673d8fad", + "00000000-0000-0000-0000-000000000001", + "11111111-1111-4111-8111-111111111111", + "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx:500", + "2026-01-01 00:00:00.000500+00:00" + ], + [ + "5c88fd17-f50a-b61f-355c-031cb79944a9", + "00000000-0000-0000-0000-000000000001", + "11111111-1111-4111-8111-111111111111", + "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx:80000", + "2026-01-01 00:00:00.080000+00:00" + ], + [ + "666950e5-a708-152a-411b-ce0ad25ac71b", + "00000000-0000-0000-0000-000000000002", + "11111111-1111-4111-8111-111111111111", + "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx:80001", + "2026-01-01 00:00:00.080001+00:00" + ], + [ + "15c2c27f-473a-ec26-9e9c-2716b128f3ea", + "00000000-0000-0000-0000-000000000002", + "11111111-1111-4111-8111-111111111111", + "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx:95000", + "2026-01-01 00:00:00.095000+00:00" + ], + [ + "d1d9c2f9-e7cf-1922-c139-76c555b5bac8", + "00000000-0000-0000-0000-000000000003", + "11111111-1111-4111-8111-111111111111", + "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx:99000", + "2026-01-01 00:00:00.099000+00:00" + ], + [ + "def7ad13-3c77-47ce-172f-39ecad05bab1", + "00000000-0000-0000-0000-000000000004", + "11111111-1111-4111-8111-111111111111", + "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx:100000", + "2026-01-01 00:00:00.100000+00:00" + ] + ] + } + }, + "after_snapshot_write": { + "source_messages_after_dump": 100001, + "expected_messages_missing_from_snapshot": 1 + }, + "backup_restore": { + "backup_seconds": 0.5288, + "dump_bytes": 3004503, + "dump_sha256": "f5ae26a1ed569f5027d5fafa26001a3429e90a18db1589e394d1a368aa990f46", + "new_container_and_volume": true, + "provision_seconds": 1.3216, + "restore_seconds": 0.6135, + "provision_plus_restore_seconds": 1.9351, + "verification": { + "counts": { + "users": 1, + "chats": 4, + "chat_members": 4, + "messages": 100000, + "sessions": 1, + "schema_migrations": 1, + "app_settings": 1 + }, + "all_messages_sha256": "dfdcdff4be5c439c47e7d26869631c0242760c92e0706d5977ccbad9d2d2ab7f", + "selected_messages": [ + [ + "7bb1fec0-75f7-3359-0707-a34b46f176e9", + "00000000-0000-0000-0000-000000000001", + "11111111-1111-4111-8111-111111111111", + "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx:1", + "2026-01-01 00:00:00.000001+00:00" + ], + [ + "7db39161-2ccb-46b3-0e44-acfd673d8fad", + "00000000-0000-0000-0000-000000000001", + "11111111-1111-4111-8111-111111111111", + "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx:500", + "2026-01-01 00:00:00.000500+00:00" + ], + [ + "5c88fd17-f50a-b61f-355c-031cb79944a9", + "00000000-0000-0000-0000-000000000001", + "11111111-1111-4111-8111-111111111111", + "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx:80000", + "2026-01-01 00:00:00.080000+00:00" + ], + [ + "666950e5-a708-152a-411b-ce0ad25ac71b", + "00000000-0000-0000-0000-000000000002", + "11111111-1111-4111-8111-111111111111", + "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx:80001", + "2026-01-01 00:00:00.080001+00:00" + ], + [ + "15c2c27f-473a-ec26-9e9c-2716b128f3ea", + "00000000-0000-0000-0000-000000000002", + "11111111-1111-4111-8111-111111111111", + "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx:95000", + "2026-01-01 00:00:00.095000+00:00" + ], + [ + "d1d9c2f9-e7cf-1922-c139-76c555b5bac8", + "00000000-0000-0000-0000-000000000003", + "11111111-1111-4111-8111-111111111111", + "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx:99000", + "2026-01-01 00:00:00.099000+00:00" + ], + [ + "def7ad13-3c77-47ce-172f-39ecad05bab1", + "00000000-0000-0000-0000-000000000004", + "11111111-1111-4111-8111-111111111111", + "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx:100000", + "2026-01-01 00:00:00.100000+00:00" + ] + ], + "orphan_messages": 0 + }, + "all_counts_and_samples_equal": true, + "all_messages_checksum_equal": true, + "after_backup_canary_intentionally_absent": true + }, + "status": "PASS" +} diff --git a/evidence/research.png b/evidence/research.png new file mode 100644 index 0000000000000000000000000000000000000000..8425bbf782a54ebb7b765f0c3dbb409314093d5c GIT binary patch literal 123802 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 literal 0 HcmV?d00001 diff --git a/evidence/smoke.txt b/evidence/smoke.txt new file mode 100644 index 0000000..ee602dc --- /dev/null +++ b/evidence/smoke.txt @@ -0,0 +1,2 @@ +python3 tests/smoke.py --base-url "http://localhost:8082" +PASS: lab2 public API scenario; infrastructure and grading evidence remain separate. diff --git a/evidence/student-tests.txt b/evidence/student-tests.txt new file mode 100644 index 0000000..89258ec --- /dev/null +++ b/evidence/student-tests.txt @@ -0,0 +1,17 @@ +python3 -m unittest discover -s student-tests -p 'test_*.py' -v +test_100_messages_10_clients (test_api.APItests.test_100_messages_10_clients) ... ok +test_authentication_before_access_and_foreign_chat (test_api.APItests.test_authentication_before_access_and_foreign_chat) ... ok +test_bad_password_unknown_username_and_basic_only_for_login (test_api.APItests.test_bad_password_unknown_username_and_basic_only_for_login) ... ok +test_chat_rollback_and_membership_validation (test_api.APItests.test_chat_rollback_and_membership_validation) ... ok +test_empty_message_unicode_and_sender (test_api.APItests.test_empty_message_unicode_and_sender) ... ok +test_logout_revokes_only_current_session (test_api.APItests.test_logout_revokes_only_current_session) ... ok +test_malformed_json_and_types (test_api.APItests.test_malformed_json_and_types) ... ok +test_multiple_pages_bad_limits_and_cross_resource_cursor (test_api.APItests.test_multiple_pages_bad_limits_and_cross_resource_cursor) ... ok +test_racing_registration (test_api.APItests.test_racing_registration) ... ok +test_read_after_write_during_pagination (test_api.APItests.test_read_after_write_during_pagination) ... ok +test_unicode_password_128_codepoints_and_colon (test_api.APItests.test_unicode_password_128_codepoints_and_colon) ... ok + +---------------------------------------------------------------------- +Ran 11 tests in 6.839s + +OK diff --git a/infra/SCHEMA.md b/infra/SCHEMA.md new file mode 100644 index 0000000..d7ca936 --- /dev/null +++ b/infra/SCHEMA.md @@ -0,0 +1,14 @@ +# Схема и транзакционные границы до реализации запросов + +- `users`: UUID PK, уникальный username, display_name, scrypt hash (соль и параметры в строке), created_at. Длина и шаблон username проверяются также CHECK в PostgreSQL. +- `chats`: UUID PK, title, created_at, last_message_at для монотонного порядка сообщений одного чата. +- `chat_members`: составной PK (chat_id,user_id), FK на chats/users; индекс (user_id,chat_id) для списка доступных чатов. +- `messages`: UUID PK, chat_id/sender_id/text/created_at; составной FK (chat_id,sender_id) на членство. Индекс (chat_id,created_at,id) поддерживает WHERE chat_id=? AND (created_at,id)>(?,?) ORDER BY created_at,id LIMIT ?. +- `sessions`: SHA-256 случайного 256-битного токена как PK; FK user_id; абсолютное expires_at. Оригинал токена только у клиента. Источник истины — PostgreSQL; logout удаляет строку, expiry сравнивается с часами БД. +- `app_settings`: постоянный секрет подписи cursor. Миграции — schema_migrations с SHA-256 файлов; применение под advisory lock и одной транзакцией на запуск миграций. + +Транзакции: регистрация и unique username; создание чата и всех участников; обновление last_message_at и вставка сообщения; создание или отзыв сессии. Исключение внутри контекста соединения откатывает всю операцию. Отказ неизвестного участника не оставляет чат. Все значения параметризованы. + +Пул: 1–8 соединений, максимум 32 ожидающих, ожидание 2 с; connect_timeout=2 с, statement_timeout=2 с, lock_timeout=1 с, idle-in-transaction=5 с. История читается из PostgreSQL без кэша, поэтому подтверждённая запись не скрывается устаревшим cache hit. + +Valkey: cache-aside только неизменяемого публичного User, TTL 300 с. Сессия всегда проверяется в PostgreSQL до чтения кэша; logout/expiry не зависят от Valkey. При отказе/flush/restart — запрос профиля в PostgreSQL и последующее заполнение. Обновлений/удалений пользователей в контракте нет; для их добавления потребуется инвалидация. Пароли, их хеши, оригиналы токенов в кэш не попадают. diff --git a/migrations/001_initial.sql b/migrations/001_initial.sql new file mode 100644 index 0000000..9733384 --- /dev/null +++ b/migrations/001_initial.sql @@ -0,0 +1,37 @@ +CREATE TABLE users ( + id uuid PRIMARY KEY, + username text NOT NULL UNIQUE CHECK (username ~ '^[a-z0-9_]{3,32}$'), + display_name text NOT NULL CHECK (char_length(display_name) BETWEEN 1 AND 100 AND display_name !~ '^\s*$'), + password_hash text NOT NULL, + created_at timestamptz NOT NULL DEFAULT clock_timestamp() +); +CREATE TABLE chats ( + id uuid PRIMARY KEY, + title text NOT NULL CHECK (char_length(title) BETWEEN 1 AND 100 AND title !~ '^\s*$'), + created_at timestamptz NOT NULL DEFAULT clock_timestamp(), + last_message_at timestamptz NOT NULL DEFAULT '-infinity' +); +CREATE TABLE chat_members ( + chat_id uuid NOT NULL REFERENCES chats(id), + user_id uuid NOT NULL REFERENCES users(id), + PRIMARY KEY (chat_id, user_id) +); +CREATE INDEX chat_members_user_chat_idx ON chat_members(user_id, chat_id); +CREATE INDEX chats_created_id_idx ON chats(created_at,id); +CREATE TABLE messages ( + id uuid PRIMARY KEY, + chat_id uuid NOT NULL, + sender_id uuid NOT NULL, + text text NOT NULL CHECK (char_length(text) BETWEEN 1 AND 4000 AND text !~ '^\s*$'), + created_at timestamptz NOT NULL, + FOREIGN KEY (chat_id,sender_id) REFERENCES chat_members(chat_id,user_id) +); +CREATE INDEX messages_chat_created_id_idx ON messages(chat_id,created_at,id); +CREATE TABLE sessions ( + token_hash bytea PRIMARY KEY CHECK (octet_length(token_hash)=32), + user_id uuid NOT NULL REFERENCES users(id), + created_at timestamptz NOT NULL DEFAULT clock_timestamp(), + expires_at timestamptz NOT NULL +); +CREATE INDEX sessions_expires_idx ON sessions(expires_at); +CREATE TABLE app_settings (name text PRIMARY KEY, value text NOT NULL); diff --git a/requirements.txt b/requirements.txt new file mode 100644 index 0000000..fd3a926 --- /dev/null +++ b/requirements.txt @@ -0,0 +1,5 @@ +psycopg==3.3.6 +psycopg-binary==3.3.6 +psycopg-pool==3.3.1 +redis==6.4.0 +typing_extensions==4.16.0 diff --git a/research/README.md b/research/README.md new file mode 100644 index 0000000..221cdd0 --- /dev/null +++ b/research/README.md @@ -0,0 +1,23 @@ +# Трек 2: план запроса, стоимость записи, backup и восстановление + +Гипотеза: индекс только `chat_id` не может быстро продолжить позднюю страницу; составной `(chat_id,created_at,id)` устранит фильтрацию всей истории и сортировку. `INCLUDE(sender_id,text)` может дать Index Only Scan, но увеличит размер индекса и цену записи. OFFSET останется линейным даже с правильным индексом. + +```sh +make up +make research +# Рисунок необязателен для выполнения эксперимента: +.venv/bin/python -m pip install -r research/requirements.txt +.venv/bin/python research/summarize.py +``` + +Скрипт использует три новые временные базы в PostgreSQL текущего Compose-проекта. Рабочую `messenger` не очищает и её индексы не меняет. Каждая исследовательская БД содержит одинаковые 100 000 синтетических сообщений в чатах размером 80 000 / 15 000 / 4 000 / 1 000. Все FK, PK и CHECK соответствуют рабочей миграции. Индекс истории — единственная структурная разница: chat_only, keyset, covering. `text` имеет примерно 100 ASCII-символов; идентификаторы и исходные данные детерминированы. Исследовательский пользователь не предназначен для входа через API. + +Измерения выполняются драйвером psycopg из отдельного процесса внутри API-контейнера, PostgreSQL — в другом контейнере. На оба выделено по 1 CPU и 512 MiB. Для каждого индекса, размера чата и варианта keyset/OFFSET: 3 прогрева и 30 последовательных чтений по 50 строк возле конца исходной истории. Сохраняются все задержки, p50/p95/p99 nearest-rank, фактические последовательные QPS, ошибки, EXPLAIN (ANALYZE, BUFFERS, FORMAT JSON). Это измерения SQL, не HTTP-пропускной способности. + +Стоимость записи: 10 транзакций по 1000 строк, EXPLAIN (ANALYZE, BUFFERS, WAL) реального INSERT и настоящий COMMIT каждой транзакции. Сохраняются SQL execution time, WAL bytes, dirtied blocks, wall time с COMMIT. После этого только исследовательские write-строки удаляются, выполняется VACUUM ANALYZE; чтение и backup снова используют ровно 100 000 исходных сообщений. Таблицы всех трёх вариантов проходят одинаковую процедуру. Время включает сбор плана, поэтому не является чистой оценкой одиночного INSERT. + +Backup: `pg_dump -Fc` базы с рабочим составным индексом, файл `backups/lab2-research.dump` исключён из Git. После dump добавляется canary-запись. Затем создаются НОВЫЙ контейнер PostgreSQL и НОВЫЙ volume; `pg_restore --exit-on-error` загружает снимок. Сверяются количества всех таблиц, 7 выбранных сообщений разных чатов, SHA-256 всей истории и отсутствие сообщений без членства. Canary после снимка ожидаемо не восстанавливается. Время подготовки пустого сервера и самого restore учитывается отдельно. + +Все временные исследовательские БД, целевой контейнер и его volume удаляются в finally. Рабочий volume не удаляется. Dump остаётся локально для повторного изучения, не содержит реальных данных. Доказательства: `evidence/research.json`, `explain-plans.json`, CSV, таблица и рисунок. + +Ограничения: один компьютер, последовательный клиент, фиксированный порядок вариантов, прогретые страницы, 30 чтений и 10 write-batch. Перцентили малыми выборками не задают SLA; результаты не доказывают HTTP capacity или влияние конкурентных записей. Измеряется локальный логический backup без сетевого копирования и восстановления настроек ОС/ролей. RPO — момент снимка, а не ноль; для восстановления более поздних COMMIT потребуются WAL-архив и PITR. Новое хранилище запущено на том же хосте, отказ самого хоста не моделируется. Размеры CPU/RAM заданы явно, отдельное профилирование CPU не проводилось. diff --git a/research/requirements.txt b/research/requirements.txt new file mode 100644 index 0000000..0cb4092 --- /dev/null +++ b/research/requirements.txt @@ -0,0 +1,3 @@ +# Optional: plotting only; SQL experiment itself uses the API container's driver. +matplotlib==3.10.9 +numpy==2.4.4 diff --git a/research/run.py b/research/run.py new file mode 100644 index 0000000..129a435 --- /dev/null +++ b/research/run.py @@ -0,0 +1,103 @@ +"""Measure indexes, back up, restore to a NEW PostgreSQL container+volume, verify.""" +import datetime as dt +import hashlib +import json +import os +from pathlib import Path +import subprocess +import sys +import time +import uuid + +ROOT=Path(__file__).resolve().parents[1] +IMAGE='postgres:17.9-bookworm@sha256:47f917f7409eacd22fc5dfb1dee634e1b55cf0c01d1a7eb701be2227a03e0641' + + +def execute(command,**kwargs): + return subprocess.run(command,cwd=ROOT,check=True,capture_output=True,**kwargs) + + +def compose(*args,**kwargs): + return execute(['docker','compose',*args],**kwargs) + + +def main(): + prefix='lab2_research_'+uuid.uuid4().hex[:8] + target='mtusi-lab2-restore-'+uuid.uuid4().hex[:8] + volume=target+'-data' + worker=(ROOT/'research/worker.py').read_text() + def action(name,**variables): + flags=[] + for key,value in {'RESEARCH_ACTION':name,'RESEARCH_PREFIX':prefix,**variables}.items(): + flags.extend(['-e',key+'='+value]) + return json.loads(compose('exec','-T',*flags,'api','python','-',input=worker,text=True).stdout) + report={'date_utc':dt.datetime.now(dt.timezone.utc).isoformat(), + 'source_sha256':{str(p.relative_to(ROOT)):hashlib.sha256(p.read_bytes()).hexdigest() for p in [ROOT/'src/store.py',ROOT/'migrations/001_initial.sql',ROOT/'research/worker.py']}, + 'method':'Isolated skewed PostgreSQL datasets; 30 sequential reads after 3 warmups; 10 committed INSERT batches of 1000 rows; fresh restore volume.', + 'limitations':['Local single-host measurements; warm buffers; no concurrent HTTP capacity claim.', + 'EXPLAIN insert wall times include plan collection and COMMIT; 10 batches do not establish a write SLA.', + 'Logical backup is a snapshot, not PITR or HA; the post-dump canary is intentionally absent after restore.']} + print('Benchmarking 100000 messages, 4 skewed chats, 3 indexes and 2 queries...',flush=True) + try: + report['query_experiment']=action('benchmark') + source=report['query_experiment']['backup_source'] + backup_dir=ROOT/'backups' + backup_dir.mkdir(mode=0o700,exist_ok=True) + dump=backup_dir/'lab2-research.dump' + started=time.perf_counter() + with dump.open('wb') as output: + subprocess.run(['docker','compose','exec','-T','postgres','pg_dump','-U','messenger','-d',source,'-Fc'],cwd=ROOT,stdout=output,stderr=subprocess.PIPE,check=True) + dump.chmod(0o600) + backup_seconds=time.perf_counter()-started + report['after_snapshot_write']=action('canary',RESEARCH_SOURCE=source) + cid=compose('ps','-q','postgres',text=True).stdout.strip() + inspect=json.loads(execute(['docker','inspect',cid],text=True).stdout)[0] + networks=list(inspect['NetworkSettings']['Networks']) + assert len(networks)==1 + provision_start=time.perf_counter() + execute(['docker','volume','create',volume],text=True) + execute(['docker','run','-d','--name',target,'--network',networks[0], + '--cpus=1','--memory=512m','--memory-swap=512m','--pids-limit=128', + '--mount','type=volume,source='+volume+',target=/var/lib/postgresql/data', + '--mount','type=bind,source='+str(ROOT/'secrets/db_password')+',target=/run/secrets/db_password,readonly', + '-e','POSTGRES_DB=messenger','-e','POSTGRES_USER=messenger','-e','POSTGRES_PASSWORD_FILE=/run/secrets/db_password',IMAGE],text=True) + deadline=time.monotonic()+30 + while True: + status=subprocess.run(['docker','exec',target,'pg_isready','-h','127.0.0.1','-U','messenger','-d','messenger'],capture_output=True) + if status.returncode==0: + break + if time.monotonic()>deadline: + raise RuntimeError('new restore PostgreSQL did not become ready') + time.sleep(.2) + provisioning=time.perf_counter()-provision_start + started=time.perf_counter() + with dump.open('rb') as input_file: + subprocess.run(['docker','exec','-i',target,'pg_restore','--exit-on-error','--no-owner','--no-privileges','-U','messenger','-d','messenger'],stdin=input_file,stdout=subprocess.PIPE,stderr=subprocess.PIPE,check=True) + restore_seconds=time.perf_counter()-started + verified=action('verify',RESTORE_HOST=target) + expected=report['query_experiment']['before_backup'] + assert verified['counts']==expected['counts'] + assert verified['all_messages_sha256']==expected['all_messages_sha256'] + assert verified['selected_messages']==expected['selected_messages'] + assert verified['orphan_messages']==0 + assert verified['counts']['messages']==100000 + report['backup_restore']={'backup_seconds':round(backup_seconds,4),'dump_bytes':dump.stat().st_size, + 'dump_sha256':hashlib.sha256(dump.read_bytes()).hexdigest(), + 'new_container_and_volume':True,'provision_seconds':round(provisioning,4), + 'restore_seconds':round(restore_seconds,4),'provision_plus_restore_seconds':round(provisioning+restore_seconds,4), + 'verification':verified,'all_counts_and_samples_equal':True,'all_messages_checksum_equal':True, + 'after_backup_canary_intentionally_absent':True} + report['status']='PASS' + destination=ROOT/'evidence/research.json' + destination.write_text(json.dumps(report,ensure_ascii=False,indent=2)+'\n') + print('PASS: restored 100000 messages to a new PostgreSQL container/volume; counts, 7 samples, complete SHA256 and foreign keys verified.',flush=True) + execute([sys.executable,'research/summarize.py'],text=True) + finally: + subprocess.run(['docker','rm','-f',target],capture_output=True) + # This volume was created by this experiment and contains synthetic data only. + subprocess.run(['docker','volume','rm',volume],capture_output=True) + action('cleanup') + + +if __name__=='__main__': + main() diff --git a/research/summarize.py b/research/summarize.py new file mode 100644 index 0000000..0384db4 --- /dev/null +++ b/research/summarize.py @@ -0,0 +1,56 @@ +"""Export raw-backed CSV, plans, a readable comparison and optional figures.""" +import csv +import json +from pathlib import Path +import statistics + +ROOT=Path(__file__).resolve().parents[1] +r=json.loads((ROOT/'evidence/research.json').read_text()) +experiment=r['query_experiment'] +rows=[] +plans=[] +lines=['# План запроса и восстановление','', '| Индекс | Сообщений в чате | Запрос | p50, мс | p95, мс | p99, мс | Sequential QPS |','| --- | ---: | --- | ---: | ---: | ---: | ---: |'] +for variant in experiment['variants']: + for read in variant['reads']: + row={'index':variant['name'],'chat_size':read['chat_size'],'query':read['query'],**read['latency_ms'],'qps':read['observed_sequential_qps']} + rows.append(row) + lines.append('| '+' | '.join(str(row[k]) for k in ('index','chat_size','query','p50','p95','p99','qps'))+' |') + plans.append({'index':variant['name'],'chat_size':read['chat_size'],'query':read['query'],'explain_analyze_buffers':read['explain']}) +lines.extend(['','| Индекс | Индексы messages, MiB | INSERT 1000 + COMMIT p50, мс | p95, мс | Средний WAL на 1000 строк, bytes |','| --- | ---: | ---: | ---: | ---: |']) +for v in experiment['variants']: + lines.append(f"| {v['name']} | {v['indexes_bytes']/1024**2:.3f} | {v['write_commit_ms']['p50']} | {v['write_commit_ms']['p95']} | {statistics.mean(w['wal_bytes'] for w in v['write_runs']):.0f} |") +b=r['backup_restore'] +lines.extend(['',f"Backup: {b['dump_bytes']} bytes, {b['backup_seconds']} с. Новый PostgreSQL/volume: {b['provision_seconds']} с. Restore: {b['restore_seconds']} с. Provision + restore: {b['provision_plus_restore_seconds']} с.",'', + 'Сверены количества всех таблиц, 7 выбранных сообщений, SHA-256 всей истории из 100 000 сообщений, отсутствие нарушенных связей. Запись после снимка ожидаемо отсутствует в восстановленной БД.']) +(ROOT/'evidence/research-summary.md').write_text('\n'.join(lines)+'\n') +(ROOT/'evidence/explain-plans.json').write_text(json.dumps(plans,ensure_ascii=False,indent=2)+'\n') +with (ROOT/'evidence/query-measurements.csv').open('w',newline='') as f: + writer=csv.DictWriter(f,fieldnames=list(rows[0]),lineterminator='\n') + writer.writeheader(); writer.writerows(rows) +try: + import matplotlib + matplotlib.use('Agg') + import matplotlib.pyplot as plt +except ImportError: + print('Tables/plans saved; install research/requirements.txt to build optional figures.') +else: + colors={'chat_only':'#d77a4b','keyset':'#227cba','covering':'#319667'} + fig,axes=plt.subplots(1,3,figsize=(15,5),constrained_layout=True) + for kind,style in [('keyset','-'),('offset','--')]: + for name,color in colors.items(): + selected=sorted((row for row in rows if row['index']==name and row['query']==kind),key=lambda x:x['chat_size']) + axes[0].plot([x['chat_size'] for x in selected],[x['p95'] for x in selected],style,marker='o',color=color,label=name+' / '+kind) + axes[0].set(xscale='log',yscale='log',xlabel='Сообщений в чате',ylabel='p95, мс',title='Чтение поздней страницы') + axes[0].legend(fontsize=7) + names=list(colors) + axes[1].bar(names,[v['write_commit_ms']['p50'] for v in experiment['variants']],color=list(colors.values())) + axes[1].set(ylabel='мс',title='1000 INSERT + COMMIT, p50') + axes[2].bar(names,[v['indexes_bytes']/1024**2 for v in experiment['variants']],color=list(colors.values())) + axes[2].set(ylabel='MiB',title='Размер всех индексов messages') + for ax in axes: + ax.spines[['top','right']].set_visible(False) + ax.grid(axis='y',alpha=.2); ax.set_axisbelow(True) + fig.suptitle('PostgreSQL: 100 000 сообщений, неравномерные чаты, 1 CPU / 512 MiB',weight='bold') + fig.savefig(ROOT/'evidence/research.png',dpi=160) + plt.close(fig) +print('\n'.join(lines)) diff --git a/research/worker.py b/research/worker.py new file mode 100644 index 0000000..00c8018 --- /dev/null +++ b/research/worker.py @@ -0,0 +1,156 @@ +"""Controlled SQL measurements on isolated databases, never the application DB.""" +import datetime as dt +import hashlib +import json +import math +import os +from pathlib import Path +import statistics +import sys +import time +import uuid + +import psycopg +from psycopg import sql +from psycopg.conninfo import make_conninfo + +BASE=Path(os.environ['DATABASE_URL_FILE']).read_text().strip() +SIZES=[80000,15000,4000,1000] +USER=uuid.UUID('11111111-1111-4111-8111-111111111111') +START=dt.datetime(2026,1,1,tzinfo=dt.timezone.utc) + + +def stats(values): + ordered=sorted(values) + def pct(p): + return round(ordered[math.ceil(p*len(ordered))-1],4) + return {'p50':pct(.5),'p95':pct(.95),'p99':pct(.99),'mean':round(statistics.mean(values),4)} + + +def fingerprint(connection): + counts={table:connection.execute(sql.SQL('SELECT count(*) FROM {}').format(sql.Identifier(table))).fetchone()[0] + for table in ('users','chats','chat_members','messages','sessions','schema_migrations','app_settings')} + digest=hashlib.sha256() + with connection.cursor(name='fingerprint') as cursor: + cursor.execute('SELECT id,chat_id,sender_id,text,created_at FROM messages ORDER BY id') + for row in cursor: + digest.update((json.dumps(row,default=str,separators=(',',':'))+'\n').encode()) + samples=[] + for offset in (1,500,80000,80001,95000,99000,100000): + row=connection.execute('SELECT id,chat_id,sender_id,text,created_at FROM messages WHERE id=md5(%s)::uuid',('research-message-'+str(offset),)).fetchone() + samples.append([str(v) if isinstance(v,(uuid.UUID,dt.datetime)) else v for v in row]) + return {'counts':counts,'all_messages_sha256':digest.hexdigest(),'selected_messages':samples} + + +def benchmark(): + prefix=os.environ['RESEARCH_PREFIX'] + report={'postgres_version':None,'dataset_messages':sum(SIZES),'chat_sizes':SIZES,'read_repeats':30,'warmup_queries':3, + 'write_batches':10,'write_batch_size':1000,'limits':{'postgres_cpus':1,'postgres_memory_mib':512,'client_cpus':1,'client_memory_mib':512}, + 'variants':[]} + databases=[] + for variant in ('chat_only','keyset','covering'): + name=prefix+'_'+variant + with psycopg.connect(BASE,autocommit=True) as admin: + admin.execute(sql.SQL('CREATE DATABASE {}').format(sql.Identifier(name))) + databases.append(name) + dsn=make_conninfo(BASE,dbname=name) + with psycopg.connect(dsn,autocommit=True) as c: + report['postgres_version']=c.execute('SHOW server_version').fetchone()[0] + migration=(Path('/app/migrations/001_initial.sql')).read_text() + c.execute('CREATE TABLE schema_migrations(version text PRIMARY KEY,sha256 text NOT NULL,applied_at timestamptz NOT NULL DEFAULT clock_timestamp())') + c.execute(migration) + c.execute('INSERT INTO schema_migrations(version,sha256) VALUES (%s,%s)',('001_initial.sql',hashlib.sha256(migration.encode()).hexdigest())) + c.execute("INSERT INTO app_settings(name,value) VALUES ('cursor_key',%s)",('00'*32,)) + if variant=='chat_only': + c.execute('DROP INDEX messages_chat_created_id_idx') + c.execute('CREATE INDEX messages_chat_only_idx ON messages(chat_id)') + elif variant=='covering': + c.execute('DROP INDEX messages_chat_created_id_idx') + c.execute('CREATE INDEX messages_chat_covering_idx ON messages(chat_id,created_at,id) INCLUDE (sender_id,text)') + c.execute('INSERT INTO users(id,username,display_name,password_hash) VALUES (%s,%s,%s,%s)',(USER,'research_user','Synthetic fixture','research-only-not-a-real-password')) + c.execute("INSERT INTO sessions(token_hash,user_id,expires_at) VALUES (%s,%s,clock_timestamp()+interval '1 hour')",(hashlib.sha256(b'synthetic-not-a-session-token').digest(),USER)) + offset=0 + seeded=time.perf_counter() + for index,size in enumerate(SIZES,1): + cid=uuid.UUID(int=index) + c.execute('INSERT INTO chats(id,title) VALUES (%s,%s)',(cid,'Synthetic chat '+str(index))) + c.execute('INSERT INTO chat_members(chat_id,user_id) VALUES (%s,%s)',(cid,USER)) + c.execute("INSERT INTO messages(id,chat_id,sender_id,text,created_at) SELECT md5('research-message-'||g)::uuid,%s,%s,repeat('x',100)||':'||g,%s::timestamptz+g*interval '1 microsecond' FROM generate_series(%s,%s) g",(cid,USER,START,offset+1,offset+size)) + offset+=size + seed_s=time.perf_counter()-seeded + c.execute('VACUUM (ANALYZE) messages') + writes=[] + for batch in range(10): + started=time.perf_counter() + with c.transaction(): + plan=c.execute("EXPLAIN (ANALYZE, BUFFERS, WAL, FORMAT JSON) INSERT INTO messages(id,chat_id,sender_id,text,created_at) SELECT md5(%s||g)::uuid,%s,%s,'write-'||repeat('x',100)||':'||g,clock_timestamp()+g*interval '1 microsecond' FROM generate_series(1,1000) g",('write-'+str(batch)+'-',uuid.UUID(int=1),USER)).fetchone()[0][0] + writes.append({'commit_wall_ms':round((time.perf_counter()-started)*1000,4),'execution_ms':plan['Execution Time'], + 'wal_bytes':plan['Plan'].get('WAL Bytes',0),'shared_dirtied_blocks':plan['Plan'].get('Shared Dirtied Blocks',0)}) + c.execute("DELETE FROM messages WHERE text LIKE 'write-%'") + c.execute('VACUUM (ANALYZE) messages') + row={'name':variant,'database':name,'seed_seconds':round(seed_s,4), + 'table_bytes':c.execute("SELECT pg_table_size('messages')").fetchone()[0], + 'indexes_bytes':c.execute("SELECT pg_indexes_size('messages')").fetchone()[0], + 'write_runs':writes,'write_commit_ms':stats([w['commit_wall_ms'] for w in writes]),'reads':[]} + offset=0 + for index,size in enumerate(SIZES,1): + cid=uuid.UUID(int=index) + cursor_at=offset+size-100 + cursor_time=START+dt.timedelta(microseconds=cursor_at) + cursor_id=uuid.UUID(hashlib.md5(('research-message-'+str(cursor_at)).encode()).hexdigest()) + for kind in ('keyset','offset'): + if kind=='keyset': + query='SELECT id,chat_id,sender_id,text,created_at FROM messages WHERE chat_id=%s AND (created_at,id)>(%s,%s) ORDER BY created_at,id LIMIT 50' + parameters=(cid,cursor_time,cursor_id) + else: + query='SELECT id,chat_id,sender_id,text,created_at FROM messages WHERE chat_id=%s ORDER BY created_at,id OFFSET %s LIMIT 50' + parameters=(cid,size-100) + for _ in range(3): + assert len(c.execute(query,parameters).fetchall())==50 + timings=[] + total_started=time.perf_counter() + for _ in range(30): + started=time.perf_counter() + result=c.execute(query,parameters).fetchall() + assert len(result)==50 + timings.append((time.perf_counter()-started)*1000) + total_elapsed=time.perf_counter()-total_started + plan=c.execute('EXPLAIN (ANALYZE, BUFFERS, FORMAT JSON) '+query,parameters).fetchone()[0][0] + row['reads'].append({'chat_size':size,'query':kind,'latency_ms':stats(timings),'raw_latency_ms':[round(v,4) for v in timings], + 'successful_queries':30,'failed_queries':0,'observed_sequential_qps':round(30/total_elapsed,3),'explain':plan}) + offset+=size + report['variants'].append(row) + report['databases']=databases + report['backup_source']=prefix+'_keyset' + # Keep the production-index database immutable until the dump starts. + with psycopg.connect(make_conninfo(BASE,dbname=report['backup_source'])) as connection: + report['before_backup']=fingerprint(connection) + print(json.dumps(report,ensure_ascii=False,default=str)) + + +def verify(): + dsn=make_conninfo(BASE,host=os.environ['RESTORE_HOST'],dbname='messenger') + with psycopg.connect(dsn) as connection: + report=fingerprint(connection) + orphan=connection.execute('SELECT count(*) FROM messages m LEFT JOIN chat_members cm ON (cm.chat_id,cm.user_id)=(m.chat_id,m.sender_id) WHERE cm.user_id IS NULL').fetchone()[0] + report['orphan_messages']=orphan + print(json.dumps(report,ensure_ascii=False)) + + +def canary(): + name=os.environ['RESEARCH_SOURCE'] + with psycopg.connect(make_conninfo(BASE,dbname=name)) as connection: + connection.execute("INSERT INTO messages(id,chat_id,sender_id,text,created_at) VALUES (%s,%s,%s,'AFTER_BACKUP_CANARY',clock_timestamp())",(uuid.uuid4(),uuid.UUID(int=1),USER)) + count=connection.execute('SELECT count(*) FROM messages').fetchone()[0] + print(json.dumps({'source_messages_after_dump':count,'expected_messages_missing_from_snapshot':1})) + + +def cleanup(): + prefix=os.environ['RESEARCH_PREFIX'] + with psycopg.connect(BASE,autocommit=True) as admin: + for variant in ('chat_only','keyset','covering'): + admin.execute(sql.SQL('DROP DATABASE IF EXISTS {} WITH (FORCE)').format(sql.Identifier(prefix+'_'+variant))) + print(json.dumps({'isolated_databases_removed':True})) + + +{'benchmark':benchmark,'verify':verify,'canary':canary,'cleanup':cleanup}[os.environ['RESEARCH_ACTION']]() diff --git a/scripts/bootstrap.py b/scripts/bootstrap.py new file mode 100644 index 0000000..de06c78 --- /dev/null +++ b/scripts/bootstrap.py @@ -0,0 +1,30 @@ +#!/usr/bin/env python3 +"""Generate local credentials once, without printing or committing their values.""" +import os +from pathlib import Path +import secrets + +ROOT = Path(__file__).resolve().parents[1] +folder = ROOT / 'secrets' +folder.mkdir(mode=0o700, exist_ok=True) + +def write_once(name, value): + path = folder / name + if not path.exists(): + descriptor = os.open(path, os.O_WRONLY | os.O_CREAT | os.O_EXCL, 0o600) + with os.fdopen(descriptor,'w') as file: + file.write(value + '\n') + # Parent directory is 0700 on the host; mounted files must also be readable + # by nonroot service UIDs inside their explicitly selected containers. + path.chmod(0o644) + return path.read_text().strip() + +password = write_once('db_password', secrets.token_hex(24)) +cache_password = write_once('cache_password', secrets.token_hex(24)) +write_once('database_url', f'postgresql://messenger:{password}@postgres:5432/messenger') +write_once('cache_url', f'redis://:{cache_password}@valkey:6379/0') +write_once('valkey.conf', f'bind 0.0.0.0\nprotected-mode yes\nport 6379\nrequirepass {cache_password}\nmaxmemory 64mb\nmaxmemory-policy allkeys-lru\nsave ""\nappendonly no\n') +env = ROOT / '.env' +if not env.exists(): + env.write_text((ROOT / '.env.example').read_text()) +print('PASS: local secret files ready; existing credentials preserved; values not printed') diff --git a/scripts/restart.sh b/scripts/restart.sh new file mode 100755 index 0000000..5781466 --- /dev/null +++ b/scripts/restart.sh @@ -0,0 +1,6 @@ +#!/bin/sh +set -eu +cd "$(dirname "$0")/.." +# Actual processes and all stores restart; named volumes are preserved. +docker compose restart --timeout 10 api postgres valkey +docker compose up -d --wait --wait-timeout 45 diff --git a/src/app.py b/src/app.py new file mode 100644 index 0000000..e90bd13 --- /dev/null +++ b/src/app.py @@ -0,0 +1,104 @@ +"""Lab2 entry point, retaining the HTTP transport from the Python lab1.""" +import argparse +import logging +import os +import re +import signal +import threading +from urllib.parse import urlsplit +from urllib.request import urlopen + +from http_transport import APIError, Handler, Server, invalid, page_query + + +class API(Handler): + def authorization(self): + values = self.headers.get_all('Authorization',[]) + return values[0] if len(values) == 1 else None + + def dispatch(self): + parsed = urlsplit(self.path) + path, method, store = parsed.path, self.command, self.server.store + if method == 'GET' and path == '/health/live': + return 200, {'status':'ok'} + if self.server.stopping.is_set(): + raise APIError(503,'unavailable','Сервер завершает работу') + if method == 'GET' and path == '/health/ready': + store.ready() + return 200, {'status':'ok'} + if method == 'POST' and path == '/api/v1/users': + return 201, store.user(self.json_body()) + if method == 'POST' and path == '/api/v1/auth/sessions': + if self.headers.get('Transfer-Encoding') or self.headers.get('Content-Length','0') != '0': + raise invalid('Вход не принимает тело запроса') + return 201, store.login(self.authorization()) + if not path.startswith('/api/v1/'): + raise APIError(404,'not_found','Объект не найден') + actor = store.authenticate(self.authorization()) + if method == 'DELETE' and path == '/api/v1/auth/sessions/current': + store.logout(self.authorization()) + return 204, None + if method == 'GET' and path == '/api/v1/users/me': + return 200, store.profile(actor) + if path == '/api/v1/chats': + if method == 'POST': + return 201, store.chat(actor,self.json_body()) + if method == 'GET': + return 200, store.list_chats(actor,*page_query(parsed.query)) + match = re.fullmatch(r'/api/v1/chats/([^/]+)(/messages)?',path) + if match: + cid, messages = match.groups() + chat = store.accessible(actor,cid) + if method == 'GET' and not messages: + return 200, chat + if method == 'POST' and messages: + return 201, store.message(actor,cid,self.json_body()) + if method == 'GET' and messages: + return 200, store.history(actor,cid,*page_query(parsed.query)) + raise APIError(404,'not_found','Объект не найден') + + +def main(): + parser = argparse.ArgumentParser() + parser.add_argument('--healthcheck',action='store_true') + parser.add_argument('--migrate',action='store_true') + args = parser.parse_args() + host = os.environ.get('APP_HOST','0.0.0.0') + port = int(os.environ.get('APP_PORT','8080')) + if args.healthcheck: + target = '127.0.0.1' if host == '0.0.0.0' else host + with urlopen(f'http://{target}:{port}/health/ready',timeout=3) as response: + if response.status != 200: + raise SystemExit(1) + return + logging.basicConfig(level=logging.INFO,format='%(asctime)s %(levelname)s %(message)s') + from migrate import migrate + migrate() + if args.migrate: + print('PASS: migrations applied') + return + from store import Store + store = Store() + server = Server((host,port),store,API) + deadline = threading.Timer(7.5,server.close_active) + deadline.daemon = True + def stop(signum,_frame): + if not server.stopping.is_set(): + server.stopping.set() + logging.info('shutdown_started signal=%s grace_seconds=8',signum) + deadline.start() + threading.Thread(target=server.shutdown,daemon=True).start() + signal.signal(signal.SIGTERM,stop) + signal.signal(signal.SIGINT,stop) + logging.info('started host=%s port=%s',host,port) + try: + server.serve_forever(poll_interval=.1) + finally: + server.server_close() + deadline.cancel() + store.close() + logging.info('shutdown_complete') + + +if __name__ == '__main__': + main() diff --git a/src/config.py b/src/config.py new file mode 100644 index 0000000..eb7d354 --- /dev/null +++ b/src/config.py @@ -0,0 +1,14 @@ +"""Only read secret values from files; never print DSNs or credentials.""" +import os +from pathlib import Path + + +def secret(name): + return Path(os.environ[name + '_FILE']).read_text().strip() + + +def integer(name, default, minimum=1, maximum=86400): + value = int(os.environ.get(name, str(default))) + if not minimum <= value <= maximum: + raise ValueError('Invalid configuration: ' + name) + return value diff --git a/src/http_transport.py b/src/http_transport.py new file mode 100644 index 0000000..5db85c4 --- /dev/null +++ b/src/http_transport.py @@ -0,0 +1,198 @@ +"""Reusable strict JSON/HTTP transport carried over from the Python lab1.""" +from __future__ import annotations + +import json +import logging +import re +import socket +import threading +import time +import uuid +from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer +from urllib.parse import parse_qs + +LOG = logging.getLogger('messenger') +MAX_BODY_BYTES = 65536 + + +class APIError(Exception): + def __init__(self, status: int, code: str, message: str, headers=None): + self.status, self.code, self.message = status, code, message + self.headers = headers or {} + + +def invalid(message='Неверный запрос'): + return APIError(400, 'invalid_request', message) + + +def identifier(value): + if not isinstance(value, str) or not re.fullmatch( + r'[0-9a-fA-F]{8}(?:-[0-9a-fA-F]{4}){3}-[0-9a-fA-F]{12}', value + ): + raise invalid('Ожидался UUID') + return str(uuid.UUID(value)) + + +def text(value, maximum): + if not isinstance(value, str) or not 1 <= len(value) <= maximum or not value.strip(): + raise invalid('Неверная длина или тип строки') + # Reject unpaired JSON surrogate escapes; valid supplementary Unicode is preserved. + try: + value.encode('utf-8') + except UnicodeError: + raise invalid('Неверная строка Unicode') from None + return value + + +def fields(body, required): + if not isinstance(body, dict) or set(body) != set(required): + raise invalid('Неверный набор полей JSON') + + +def page_query(query): + try: + values = parse_qs(query, keep_blank_values=True, strict_parsing=True) + except ValueError: + raise invalid('Неверная строка запроса') from None + if set(values) - {'limit', 'cursor'} or any(len(v) != 1 for v in values.values()): + raise invalid('Неизвестные или повторяющиеся параметры') + raw_limit = values.get('limit', ['50'])[0] + if not re.fullmatch(r'[0-9]+', raw_limit) or len(raw_limit) > 3: + raise invalid('Limit должен быть целым от 1 до 100') + limit = int(raw_limit) + if not 1 <= limit <= 100: + raise invalid('Limit должен быть целым от 1 до 100') + cursor = values.get('cursor', [None])[0] + if cursor == '': + raise invalid('Cursor не может быть пустым') + return limit, cursor + + +class Server(ThreadingHTTPServer): + daemon_threads = False + block_on_close = True + request_queue_size = 128 + allow_reuse_address = True + + def __init__(self, address, store, handler=None, request_logging=True): + self.store = store + self.stopping = threading.Event() + self.request_logging = request_logging + self.connections = set() + self.connections_lock = threading.Lock() + super().__init__(address, handler or Handler) + + def get_request(self): + conn, address = super().get_request() + conn.settimeout(3) + with self.connections_lock: + self.connections.add(conn) + return conn, address + + def shutdown_request(self, request): + with self.connections_lock: + self.connections.discard(request) + super().shutdown_request(request) + + def close_active(self): + """Enforce the overall shutdown deadline even for trickling clients.""" + with self.connections_lock: + for conn in list(self.connections): + try: + conn.shutdown(socket.SHUT_RDWR) + except OSError: + pass + conn.close() + + +class Handler(BaseHTTPRequestHandler): + # Close each connection: no unbounded idle keep-alive worker lifetime. + protocol_version = 'HTTP/1.0' + server_version = 'Messenger/1' + sys_version = '' + + def log_message(self, *_args): + pass + + def send_error(self, code, message=None, explain=None): + # Covers errors generated by the HTTP parser as well as business errors. + self.request_id = getattr(self, 'request_id', str(uuid.uuid4())) + mapped = {400: 'invalid_request', 404: 'not_found', 413: 'payload_too_large', 415: 'unsupported_media_type'} + self.respond(code, {'error': {'code': mapped.get(code, 'invalid_request'), + 'message': 'Неверный HTTP-запрос', 'request_id': self.request_id}}) + + def respond(self, status, body): + payload = b'' if status == 204 else json.dumps(body, ensure_ascii=False, separators=(',', ':')).encode('utf-8') + self.send_response(status) + self.send_header('Content-Type', 'application/json; charset=utf-8') + self.send_header('Content-Length', str(len(payload))) + self.send_header('X-Request-Id', self.request_id) + self.send_header('Connection', 'close') + for key, value in getattr(self, 'response_headers', {}).items(): + self.send_header(key, value) + self.end_headers() + self.wfile.write(payload) + self.close_connection = True + + def json_body(self): + media = self.headers.get_content_type() + if media != 'application/json' or self.headers.get_content_charset('utf-8').lower() != 'utf-8': + raise APIError(415, 'unsupported_media_type', 'Требуется application/json UTF-8') + lengths = self.headers.get_all('Content-Length', []) + if self.headers.get('Transfer-Encoding') or len(lengths) != 1 or not re.fullmatch(r'[0-9]+', lengths[0]): + raise invalid('Требуется один Content-Length; chunked не поддерживается') + if len(lengths[0]) > 8 or int(lengths[0]) > MAX_BODY_BYTES: + raise APIError(413, 'payload_too_large', 'JSON превышает 65536 байт') + length = int(lengths[0]) + raw = self.rfile.read(length) + if len(raw) != length: + raise invalid('Неполное тело JSON') + + def pairs(values): + result = {} + for key, value in values: + if key in result: + raise ValueError('duplicate key') + result[key] = value + return result + + def constant(_value): + raise ValueError('nonstandard number') + + try: + return json.loads(raw.decode('utf-8'), object_pairs_hook=pairs, parse_constant=constant) + except (ValueError, UnicodeError, RecursionError): + raise invalid('Неверный JSON') from None + + def dispatch(self): + raise NotImplementedError + + def handle_api(self): + self.request_id = str(uuid.uuid4()) + self.response_headers = {} + started = time.monotonic() + status = 500 + try: + status, body = self.dispatch() + except APIError as exc: + status = exc.status + self.response_headers = exc.headers + body = {'error': {'code': exc.code, 'message': exc.message, 'request_id': self.request_id}} + except (TimeoutError, ConnectionError): + status = 400 + body = {'error': {'code': 'invalid_request', 'message': 'Передача тела запроса прервана', 'request_id': self.request_id}} + except Exception: + # Never log exception text/locals: they can contain the message body. + LOG.error('internal_error request_id=%s', self.request_id) + body = {'error': {'code': 'internal_error', 'message': 'Внутренняя ошибка', 'request_id': self.request_id}} + try: + self.respond(status, body) + except (BrokenPipeError, ConnectionResetError, TimeoutError): + pass + finally: + if self.server.request_logging: + LOG.info('request request_id=%s method=%s status=%s duration_ms=%.3f', + self.request_id, self.command, status, (time.monotonic() - started) * 1000) + + do_GET = do_POST = do_PUT = do_DELETE = do_PATCH = do_OPTIONS = do_HEAD = handle_api + diff --git a/src/migrate.py b/src/migrate.py new file mode 100644 index 0000000..7553d0b --- /dev/null +++ b/src/migrate.py @@ -0,0 +1,30 @@ +"""Versioned, transactional migrations; safe under concurrent API startup.""" +import hashlib +from pathlib import Path +import secrets +import psycopg +from config import secret + +ROOT = Path(__file__).resolve().parents[1] + + +def migrate(): + with psycopg.connect(secret('DATABASE_URL'), connect_timeout=2) as connection: + connection.execute('SELECT pg_advisory_xact_lock(20260201)') + connection.execute('CREATE TABLE IF NOT EXISTS schema_migrations (version text PRIMARY KEY, sha256 text NOT NULL, applied_at timestamptz NOT NULL DEFAULT clock_timestamp())') + for file in sorted((ROOT / 'migrations').glob('*.sql')): + sql = file.read_text() + digest = hashlib.sha256(sql.encode()).hexdigest() + prior = connection.execute('SELECT sha256 FROM schema_migrations WHERE version=%s', (file.name,)).fetchone() + if prior: + if prior[0] != digest: + raise RuntimeError('Applied migration checksum changed: ' + file.name) + continue + connection.execute(sql) + connection.execute('INSERT INTO schema_migrations(version,sha256) VALUES (%s,%s)', (file.name,digest)) + connection.execute("INSERT INTO app_settings(name,value) VALUES ('cursor_key',%s) ON CONFLICT DO NOTHING", (secrets.token_hex(32),)) + + +if __name__ == '__main__': + migrate() + print('PASS: migrations applied; no duplicate data') diff --git a/src/store.py b/src/store.py new file mode 100644 index 0000000..d3721dc --- /dev/null +++ b/src/store.py @@ -0,0 +1,265 @@ +"""PostgreSQL is authoritative; Valkey caches only immutable public profiles.""" +from contextlib import contextmanager +import base64 +import datetime as dt +import hashlib +import hmac +import json +import logging +import os +import re +import secrets +import uuid + +import psycopg +from psycopg.rows import dict_row +from psycopg_pool import ConnectionPool, PoolTimeout, TooManyRequests +import redis +from redis.backoff import NoBackoff +from redis.retry import Retry + +from config import integer, secret +from http_transport import APIError, fields, identifier, invalid, text + +LOG = logging.getLogger('messenger') +USER_COLUMNS = 'id,username,display_name,created_at' +CHAT_COLUMNS = 'c.id,c.title,c.created_at,ARRAY(SELECT user_id FROM chat_members WHERE chat_id=c.id ORDER BY user_id) AS member_ids' + + +def public(row): + result = {} + for key, value in row.items(): + if isinstance(value, uuid.UUID): + value = str(value) + elif isinstance(value, dt.datetime): + value = value.astimezone(dt.timezone.utc).isoformat(timespec='microseconds').replace('+00:00','Z') + elif isinstance(value, list): + value = [str(item) for item in value] + result[key] = value + return result + + +def password_hash(password, salt=None): + salt = salt if salt is not None else secrets.token_bytes(16) + derived = hashlib.scrypt(password.encode('utf-8'), salt=salt, n=16384, r=8, p=1, dklen=32, maxmem=64*1024*1024) + return 'scrypt$16384$8$1$' + salt.hex() + '$' + derived.hex() + + +def password_valid(password, encoded): + parts = encoded.split('$') + return hmac.compare_digest(password_hash(password, bytes.fromhex(parts[4])), encoded) + + +def unauthorized(basic=False): + challenge = 'Basic realm="messenger", charset="UTF-8"' if basic else 'Bearer realm="messenger"' + return APIError(401, 'unauthorized', 'Неверные или отсутствующие учётные данные', {'WWW-Authenticate': challenge}) + + +class Store: + def __init__(self): + if os.environ.get('SESSION_STORE','postgres') != 'postgres': + raise ValueError('SESSION_STORE must be postgres') + self.ttl = integer('SESSION_TTL_SECONDS', 3600) + self.cache_ttl = integer('PROFILE_CACHE_TTL_SECONDS', 300) + self.pool = ConnectionPool(secret('DATABASE_URL'), min_size=1, + max_size=integer('DB_POOL_MAX', 8, maximum=32), + max_waiting=32, timeout=2, reconnect_timeout=3, + check=ConnectionPool.check_connection, + kwargs={'connect_timeout': 2, 'row_factory': dict_row, + 'options': '-c statement_timeout=2000 -c lock_timeout=1000 -c idle_in_transaction_session_timeout=5000'}, + open=True) + self.cache = redis.Redis.from_url(secret('CACHE_URL'), decode_responses=True, + socket_connect_timeout=.2, socket_timeout=.2, + max_connections=16, retry=Retry(NoBackoff(), 0)) + with self.connection() as connection: + self.cursor_key = bytes.fromhex(connection.execute("SELECT value FROM app_settings WHERE name='cursor_key'").fetchone()['value']) + self.dummy_hash = password_hash('not-an-existing-password') + + @contextmanager + def connection(self): + try: + with self.pool.connection() as connection: + yield connection + except (psycopg.OperationalError, psycopg.InterfaceError, PoolTimeout, TooManyRequests, + psycopg.errors.QueryCanceled, psycopg.errors.LockNotAvailable): + raise APIError(503, 'unavailable', 'Хранилище временно недоступно') from None + + def close(self): + self.pool.close() + self.cache.close() + + def ready(self): + with self.connection() as connection: + connection.execute('SELECT 1') + + def user(self, body): + fields(body, ('username','display_name','password')) + name = body['username'] + if not isinstance(name, str) or not re.fullmatch(r'[a-z0-9_]{3,32}', name): + raise invalid('Неверный username') + display = text(body['display_name'], 100) + password = text(body['password'], 128) + if len(password) < 12: + raise invalid('Пароль должен содержать 12–128 символов') + encoded = password_hash(password) + try: + with self.connection() as connection: + user = connection.execute('INSERT INTO users(id,username,display_name,password_hash) VALUES (%s,%s,%s,%s) RETURNING ' + USER_COLUMNS, + (uuid.uuid4(),name,display,encoded)).fetchone() + return public(user) + except psycopg.errors.UniqueViolation: + raise APIError(409, 'conflict', 'Username занят') from None + + def profile(self, actor): + key = 'profile:v1:' + actor + try: + value = self.cache.get(key) + if value is not None: + result = json.loads(value) + if set(result) == {'id','username','display_name','created_at'} and result['id'] == actor: + return result + except (redis.RedisError, ValueError, TypeError): + LOG.info('profile_cache_fallback') + with self.connection() as connection: + result = public(connection.execute('SELECT ' + USER_COLUMNS + ' FROM users WHERE id=%s', (actor,)).fetchone()) + try: + self.cache.setex(key, self.cache_ttl, json.dumps(result)) + except redis.RedisError: + LOG.info('profile_cache_write_skipped') + return result + + def login(self, authorization): + try: + scheme, value = authorization.split(' ', 1) + if scheme.lower() != 'basic': + raise ValueError + decoded = base64.b64decode(value, validate=True).decode('utf-8') + username, separator, password = decoded.partition(':') + if not separator or not re.fullmatch(r'[a-z0-9_]{3,32}',username) or not 12 <= len(password) <= 128: + raise ValueError + password.encode('utf-8') + except (ValueError, AttributeError, UnicodeError): + raise unauthorized(True) from None + with self.connection() as connection: + user = connection.execute('SELECT id,password_hash FROM users WHERE username=%s', (username,)).fetchone() + valid = password_valid(password, user['password_hash'] if user else self.dummy_hash) + if not valid or user is None: + raise unauthorized(True) + token = secrets.token_urlsafe(32) + with self.connection() as connection: + session = connection.execute("INSERT INTO sessions(token_hash,user_id,expires_at) VALUES (%s,%s,clock_timestamp() + %s * interval '1 second') RETURNING expires_at", + (hashlib.sha256(token.encode()).digest(),user['id'],self.ttl)).fetchone() + return {'token': token, 'token_type': 'Bearer', 'expires_at': public(session)['expires_at'], 'user': self.profile(str(user['id']))} + + @staticmethod + def token_hash(authorization): + try: + scheme, token = authorization.split(' ', 1) + if scheme.lower() != 'bearer' or not re.fullmatch(r'[A-Za-z0-9_-]{43}', token): + raise ValueError + return hashlib.sha256(token.encode()).digest() + except (ValueError, AttributeError): + raise unauthorized() from None + + def authenticate(self, authorization): + digest = self.token_hash(authorization) + with self.connection() as connection: + session = connection.execute('SELECT user_id FROM sessions WHERE token_hash=%s AND expires_at > clock_timestamp()', (digest,)).fetchone() + if session is None: + raise unauthorized() + return str(session['user_id']) + + def logout(self, authorization): + digest = self.token_hash(authorization) + with self.connection() as connection: + revoked = connection.execute('DELETE FROM sessions WHERE token_hash=%s AND expires_at > clock_timestamp() RETURNING user_id', (digest,)).fetchone() + if revoked is None: + raise unauthorized() + + def chat(self, actor, body): + fields(body, ('title','member_ids')) + title = text(body['title'],100) + members = body['member_ids'] + if not isinstance(members,list) or not 1 <= len(members) <= 100: + raise invalid('Ожидался список участников длиной 1–100') + members = [identifier(member) for member in members] + if actor not in members or len(set(members)) != len(members): + raise invalid('Неверный список участников') + cid = uuid.uuid4() + try: + with self.connection() as connection: + # Deliberately rely on FK inside the SAME transaction: any bad + # member rolls back the chat and all earlier memberships. + connection.execute('INSERT INTO chats(id,title) VALUES (%s,%s)', (cid,title)) + with connection.cursor() as cursor: + cursor.executemany('INSERT INTO chat_members(chat_id,user_id) VALUES (%s,%s)', [(cid,member) for member in members]) + return public(connection.execute('SELECT ' + CHAT_COLUMNS + ' FROM chats c WHERE c.id=%s', (cid,)).fetchone()) + except psycopg.errors.ForeignKeyViolation: + raise invalid('Неверный список участников') from None + + def accessible(self, actor, cid, connection=None): + cid = identifier(cid) + if connection is None: + with self.connection() as connection: + return self.accessible(actor,cid,connection) + chat = connection.execute('SELECT ' + CHAT_COLUMNS + ' FROM chats c WHERE c.id=%s AND EXISTS (SELECT 1 FROM chat_members WHERE chat_id=c.id AND user_id=%s)', (cid,actor)).fetchone() + if chat is None: + raise APIError(404, 'not_found', 'Объект не найден') + return public(chat) + + def message(self, actor, cid, body): + fields(body, ('text',)) + value = text(body['text'],4000) + with self.connection() as connection: + self.accessible(actor,cid,connection) + timestamp = connection.execute("UPDATE chats SET last_message_at=greatest(clock_timestamp(),last_message_at + interval '1 microsecond') WHERE id=%s RETURNING last_message_at", (cid,)).fetchone()['last_message_at'] + result = connection.execute('INSERT INTO messages(id,chat_id,sender_id,text,created_at) VALUES (%s,%s,%s,%s,%s) RETURNING id,chat_id,sender_id,text,created_at', (uuid.uuid4(),cid,actor,value,timestamp)).fetchone() + return public(result) + + def encode_cursor(self, scope, row): + raw = json.dumps([scope,row['created_at'],row['id']], separators=(',',':')).encode() + return base64.urlsafe_b64encode(raw + hmac.digest(self.cursor_key, raw, 'sha256')).decode().rstrip('=') + + def decode_cursor(self, scope, cursor): + try: + if not cursor or len(cursor) > 2048: + raise ValueError + data = base64.b64decode(cursor + '=' * (-len(cursor) % 4), altchars=b'-_',validate=True) + raw, signature = data[:-32], data[-32:] + if not hmac.compare_digest(hmac.digest(self.cursor_key,raw,'sha256'),signature): + raise ValueError + resource, timestamp, uid = json.loads(raw) + if resource != scope or not isinstance(timestamp,str): + raise ValueError + return dt.datetime.fromisoformat(timestamp.replace('Z','+00:00')), identifier(uid) + except (ValueError, TypeError, UnicodeError, APIError): + raise invalid('Неверный cursor для данного ресурса') from None + + def history(self, actor, cid, limit, cursor): + scope = 'messages:' + identifier(cid) + after = self.decode_cursor(scope,cursor) if cursor is not None else None + with self.connection() as connection: + self.accessible(actor,cid,connection) + query = 'SELECT id,chat_id,sender_id,text,created_at FROM messages WHERE chat_id=%s' + values = [cid] + if after: + query += ' AND (created_at,id) > (%s,%s)' + values.extend(after) + query += ' ORDER BY created_at,id LIMIT %s' + rows = connection.execute(query, (*values,limit+1)).fetchall() + items = [public(row) for row in rows[:limit]] + return {'items':items, 'next_cursor':self.encode_cursor(scope,items[-1]) if len(rows)>limit else None} + + def list_chats(self, actor, limit, cursor): + scope = 'chats:' + actor + after = self.decode_cursor(scope,cursor) if cursor is not None else None + query = 'SELECT ' + CHAT_COLUMNS + ' FROM chats c JOIN chat_members mine ON mine.chat_id=c.id WHERE mine.user_id=%s' + values = [actor] + if after: + query += ' AND (c.created_at,c.id) > (%s,%s)' + values.extend(after) + query += ' ORDER BY c.created_at,c.id LIMIT %s' + with self.connection() as connection: + rows = connection.execute(query, (*values,limit+1)).fetchall() + items = [public(row) for row in rows[:limit]] + return {'items':items, 'next_cursor':self.encode_cursor(scope,items[-1]) if len(rows)>limit else None} diff --git a/student-tests/clean_clone.py b/student-tests/clean_clone.py new file mode 100644 index 0000000..25b7355 --- /dev/null +++ b/student-tests/clean_clone.py @@ -0,0 +1,52 @@ +"""Verify the committed tree using a fresh clone and isolated Compose volumes.""" +import datetime as dt +import json +import os +from pathlib import Path +import socket +import subprocess +import sys +import tempfile +import uuid + +ROOT=Path(__file__).resolve().parents[1] + + +def main(): + project='mtusi-lab2-clean-'+uuid.uuid4().hex[:8] + with socket.socket() as s: + s.bind(('127.0.0.1',0)) + port=s.getsockname()[1] + report={'date_utc':dt.datetime.now(dt.timezone.utc).isoformat(), + 'source_commit':subprocess.check_output(['git','rev-parse','HEAD'],cwd=ROOT,text=True).strip(), + 'fresh_project_and_volumes':True} + with tempfile.TemporaryDirectory(prefix='mtusi-lab2-clean-') as directory: + clone=Path(directory)/'repo' + subprocess.run(['git','clone','--no-local',str(ROOT),str(clone)],check=True) + assert not subprocess.check_output(['git','status','--porcelain'],cwd=clone) + environment={**os.environ,'COMPOSE_PROJECT_NAME':project,'HOST_PORT':str(port),'BASE_URL':'http://127.0.0.1:'+str(port)} + def run(*command): + subprocess.run(command,cwd=clone,env=environment,check=True) + run(sys.executable,'scripts/bootstrap.py') + try: + run('docker','compose','build','--no-cache') + run('docker','compose','up','-d','--wait','--wait-timeout','60') + run('make','check','test','student-test','PYTHON='+sys.executable,'BASE_URL='+environment['BASE_URL']) + run(sys.executable,'student-tests/infrastructure.py') + report['checks']={'build_from_source':True,'public_smoke':True,'own_http_tests':True, + 'infrastructure_and_public_persistence':True} + report['infrastructure']=json.loads((clone/'evidence/infrastructure.json').read_text()) + api_id=subprocess.check_output(['docker','compose','ps','-q','api'],cwd=clone,env=environment,text=True).strip() + user=subprocess.check_output(['docker','exec',api_id,'id','-u'],text=True).strip() + assert user=='10001' + report['checks']['api_uid_10001']=True + report['status']='PASS' + finally: + # Only this fresh disposable test project's volumes are removed. + subprocess.run(['docker','compose','down','--volumes','--remove-orphans'],cwd=clone,env=environment,check=True) + (ROOT/'evidence/clean-clone.json').write_text(json.dumps(report,ensure_ascii=False,indent=2)+'\n') + print(json.dumps(report,ensure_ascii=False,indent=2)) + + +if __name__=='__main__': + main() diff --git a/student-tests/infrastructure.py b/student-tests/infrastructure.py new file mode 100644 index 0000000..7d2df06 --- /dev/null +++ b/student-tests/infrastructure.py @@ -0,0 +1,161 @@ +"""Explicit, recoverable failure tests for THIS Compose project only.""" +import datetime as dt +import hashlib +import json +import os +from pathlib import Path +import subprocess +import sys +import time +import uuid + +ROOT=Path(__file__).resolve().parents[1] +sys.path.insert(0,str(ROOT/'tests')) +from client import Client + + +def compose(*args,input=None): + return subprocess.run(['docker','compose',*args],cwd=ROOT,input=input,text=True,capture_output=True,check=True).stdout.strip() + + +def internal(code): + return json.loads(compose('exec','-T','api','python','-',input=code)) + + +def ready(client): + deadline=time.monotonic()+30 + while True: + try: + client.call('GET','/health/ready',schema='Health') + return + except AssertionError: + if time.monotonic()>deadline: + raise + time.sleep(.2) + + +def main(): + base=os.environ.get('BASE_URL','http://localhost:8082') + client=Client(base,timeout=8) + alice,bob,eve,chat=client.bootstrap() + report={'date_utc':dt.datetime.now(dt.timezone.utc).isoformat(),'checks':{}} + checks=report['checks'] + def state_counts(): + return internal("""import json,os,psycopg +from pathlib import Path +with psycopg.connect(Path(os.environ['DATABASE_URL_FILE']).read_text().strip()) as c: + print(json.dumps({name:c.execute('SELECT count(*) FROM '+name).fetchone()[0] for name in ('chats','chat_members')})) +""") + prior=state_counts() + client.call('POST','/api/v1/chats',400,actor=alice,body={'title':'Rollback probe','member_ids':[alice['id'],bob['id'],str(uuid.uuid4())]}) + assert prior==state_counts() + checks['failed_chat_transaction_leaves_no_chat_or_members']=True + client.call('GET','/api/v1/users/me',actor=alice,schema='User') + cache=internal('''import json,os,redis +from pathlib import Path +r=redis.Redis.from_url(Path(os.environ['CACHE_URL_FILE']).read_text().strip(),decode_responses=True) +keys=r.keys('profile:v1:*') +values=[json.loads(r.get(k)) for k in keys] +assert keys and all(set(v)=={'id','username','display_name','created_at'} for v in values) +print(json.dumps({'cached_profiles':len(keys),'all_profiles_public_fields_only':True,'positive_ttl':all(r.ttl(k)>0 for k in keys)})) +''') + assert cache['positive_ttl'] + checks['valkey_really_caches_profiles']=cache + checks['password_kdf_and_hashed_tokens']=internal('''import json,os,psycopg +from pathlib import Path +with psycopg.connect(Path(os.environ['DATABASE_URL_FILE']).read_text().strip()) as c: + p=c.execute("SELECT bool_and(password_hash LIKE 'scrypt$16384$8$1$%') FROM users").fetchone()[0] + t=c.execute('SELECT bool_and(octet_length(token_hash)=32) FROM sessions').fetchone()[0] + print(json.dumps({'all_passwords_scrypt':p,'all_token_digests_32_bytes':t})) +''') + assert all(checks['password_kdf_and_hashed_tokens'].values()) + try: + compose('stop','valkey') + started=time.monotonic() + me=client.call('GET','/api/v1/users/me',actor=alice,schema='User')['json'] + assert me==alice['user'] + client.call('GET','/api/v1/users/me',401,headers={'X-User-Id':alice['id']}) + message=client.message(alice,chat,'cache outage synthetic')['json'] + page=client.call('GET','/api/v1/chats/'+chat['id']+'/messages',actor=bob,schema='MessagePage')['json'] + assert message in page['items'] + # Revocation remains authoritative while the cache is down. + client.call('DELETE','/api/v1/auth/sessions/current',204,actor=alice) + client.call('GET','/api/v1/users/me',401,actor=alice) + checks['cache_outage']={'fallback_profile_and_history':True,'anonymous_rejected':True,'logout_effective':True,'scenario_seconds':round(time.monotonic()-started,3)} + finally: + compose('up','-d','--wait','valkey') + client.call('GET','/api/v1/users/me',401,actor=alice) + client.call('GET','/api/v1/users/me',actor=bob,schema='User') + checks['cache_restart_no_revoked_session_resurrection']=True + internal('''import json,os,redis +from pathlib import Path +r=redis.Redis.from_url(Path(os.environ['CACHE_URL_FILE']).read_text().strip()) +r.flushdb() +print(json.dumps({'flushed':True})) +''') + assert client.call('GET','/api/v1/users/me',actor=bob,schema='User')['json']==bob['user'] + checks['cache_flush_repopulates_from_postgres']=True + try: + compose('stop','postgres') + started=time.monotonic() + unavailable=client.call('GET','/api/v1/users/me',503,actor=bob) + elapsed=time.monotonic()-started + assert elapsed<7 + assert unavailable['json']['error']['code']=='unavailable' + client.call('GET','/health/live',schema='Health') + client.call('GET','/health/ready',503) + client.call('GET','/api/v1/users/me',401) + checks['postgres_outage']={'authenticated_request_503_seconds':round(elapsed,3),'live_200':True,'ready_503':True,'no_anonymous_trust':True} + finally: + compose('up','-d','--wait','postgres') + ready(client) + assert client.call('GET','/api/v1/users/me',actor=bob,schema='User')['json']==bob['user'] + checks['postgres_recovery_same_session']=True + # A second API container uses the same PostgreSQL and Valkey, short TTL only. + name='mtusi-lab2-short-ttl-'+uuid.uuid4().hex[:8] + try: + compose('run','-d','--no-deps','--name',name,'-p','127.0.0.1::8080','-e','SESSION_TTL_SECONDS=2','api') + mapping=subprocess.check_output(['docker','port',name,'8080/tcp'],text=True).strip() + short=Client('http://127.0.0.1:'+mapping.rsplit(':',1)[1]) + ready(short) + actor=short.user('expiry') + short.call('GET','/api/v1/users/me',actor=actor,schema='User') + time.sleep(2.2) + short.call('GET','/api/v1/users/me',401,actor=actor) + checks['expiry_ttl_2_seconds']=True + finally: + subprocess.run(['docker','rm','-f',name],capture_output=True) + migrations_before=internal('''import json,os,psycopg +from pathlib import Path +with psycopg.connect(Path(os.environ['DATABASE_URL_FILE']).read_text().strip()) as c: + print(json.dumps({'migrations':c.execute('SELECT count(*) FROM schema_migrations').fetchone()[0],'users':c.execute('SELECT count(*) FROM users').fetchone()[0]})) +''') + compose('exec','-T','api','python','src/app.py','--migrate') + migrations_after=internal('''import json,os,psycopg +from pathlib import Path +with psycopg.connect(Path(os.environ['DATABASE_URL_FILE']).read_text().strip()) as c: + print(json.dumps({'migrations':c.execute('SELECT count(*) FROM schema_migrations').fetchone()[0],'users':c.execute('SELECT count(*) FROM users').fetchone()[0]})) +''') + assert migrations_before==migrations_after + checks['repeat_migration_does_not_duplicate_data']=migrations_after + # Actual process start times around the public all-service restart scenario. + def states(): + values={} + for service in ('api','postgres','valkey'): + cid=compose('ps','-q',service) + values[service]=json.loads(subprocess.check_output(['docker','inspect',cid],text=True))[0]['State']['StartedAt'] + return values + before=states() + started=time.monotonic() + completed=subprocess.run(['make','test-persistence','ACTION_SCRIPT=scripts/restart.sh','BASE_URL='+base],cwd=ROOT,text=True,capture_output=True,check=True) + (ROOT/'evidence/persistence.txt').write_text(completed.stdout+completed.stderr) + after=states() + assert all(before[s]!=after[s] for s in before) + checks['full_stack_persistence']={'api_and_all_stores_restarted':True,'before':before,'after':after,'elapsed_seconds':round(time.monotonic()-started,3)} + report['status']='PASS' + (ROOT/'evidence/infrastructure.json').write_text(json.dumps(report,ensure_ascii=False,indent=2)+'\n') + print(json.dumps(report,ensure_ascii=False,indent=2)) + + +if __name__=='__main__': + main() diff --git a/student-tests/test_api.py b/student-tests/test_api.py new file mode 100644 index 0000000..ac350c1 --- /dev/null +++ b/student-tests/test_api.py @@ -0,0 +1,152 @@ +"""Independent HTTP checks against the real PostgreSQL/Valkey Compose stack.""" +from concurrent.futures import ThreadPoolExecutor +import base64 +import json +import os +from pathlib import Path +import sys +import threading +import unittest +from urllib.parse import quote +import uuid + +ROOT = Path(__file__).resolve().parents[1] +sys.path.insert(0, str(ROOT / 'tests')) +from client import Client + + +def basic(username,password): + return 'Basic ' + base64.b64encode((username + ':' + password).encode()).decode() + + +class APItests(unittest.TestCase): + @classmethod + def setUpClass(cls): + cls.base = os.environ.get('BASE_URL','http://localhost:8082') + cls.c = Client(cls.base) + cls.c.call('GET','/health/ready',schema='Health') + + def setUp(self): + self.alice,self.bob,self.eve,self.chat = self.c.bootstrap() + self.path = '/api/v1/chats/' + self.chat['id'] + + def test_malformed_json_and_types(self): + for raw in (b'{',b'null',b'[]',b'{} {}',b'\xff',b'{"username":NaN}',b'{"username":"one","username":"two"}'): + self.c.call('POST','/api/v1/users',400,raw=raw,headers={'Content-Type':'application/json'}) + valid = dict(self.alice['registration']) + for field, value in [('username',True),('username','ab'),('display_name',None),('display_name',123),('password',False),('password','a'*11),('password','a'*129)]: + self.c.call('POST','/api/v1/users',400,body={**valid,field:value}) + self.c.call('POST','/api/v1/users',400,body={**valid,'unexpected':'x'}) + self.c.call('POST','/api/v1/users',415,raw=b'{}',headers={'Content-Type':'text/plain'}) + self.c.call('POST','/api/v1/users',413,raw=b'x'*65537,headers={'Content-Type':'application/json'}) + raw=json.dumps({**valid,'display_name':'\ud800'}).encode() + self.c.call('POST','/api/v1/users',400,raw=raw,headers={'Content-Type':'application/json'}) + + def test_empty_message_unicode_and_sender(self): + for body in ({'text':''},{'text':'\t\n\u2003'},{'text':None},{'text':123},{'text':'🐍'*4001},{'text':'x','sender_id':self.eve['id']}): + self.c.call('POST',self.path+'/messages',400,body=body,actor=self.alice) + message=self.c.message(self.alice,self.chat,'🐍'*4000)['json'] + self.assertEqual(message['sender_id'],self.alice['id']) + self.assertEqual(message['text'],'🐍'*4000) + + def test_authentication_before_access_and_foreign_chat(self): + for suffix in ('','/messages'): + self.c.call('GET',self.path+suffix,404,actor=self.eve) + self.c.call('POST',self.path+'/messages',404,body={'text':'x'},actor=self.eve) + self.c.call('GET','/api/v1/chats/not-a-uuid?limit=0',401) + self.c.call('GET','/api/v1/users/me',401,headers={'X-User-Id':self.alice['id']}) + me=self.c.call('GET','/api/v1/users/me',actor=self.alice,headers={'X-User-Id':self.eve['id']},schema='User')['json'] + self.assertEqual(me,self.alice['user']) + + def test_bad_password_unknown_username_and_basic_only_for_login(self): + known=self.alice['registration'] + for authorization in ('Basic not-base64','Bearer '+self.alice['token'],basic(known['username'],'Wrong-password-123'),basic('unknown_'+uuid.uuid4().hex[:10],'Wrong-password-123')): + response=self.c.call('POST','/api/v1/auth/sessions',401,headers={'Authorization':authorization}) + self.assertEqual(response['headers']['WWW-Authenticate'],'Basic realm="messenger", charset="UTF-8"') + self.assertEqual(response['json']['error']['message'],'Неверные или отсутствующие учётные данные') + self.c.call('GET','/api/v1/users/me',401,headers={'Authorization':basic(known['username'],known['password'])}) + self.c.call('POST','/api/v1/auth/sessions',400,body={},headers={'Authorization':basic(known['username'],known['password'])}) + + def test_unicode_password_128_codepoints_and_colon(self): + username='unicode_'+uuid.uuid4().hex[:12] + password='😀'*126+':я' + user=self.c.call('POST','/api/v1/users',201,body={'username':username,'display_name':'🐍'*100,'password':password},schema='User')['json'] + session=self.c.call('POST','/api/v1/auth/sessions',201,headers={'Authorization':basic(username,password)},schema='Session')['json'] + self.assertEqual(session['user'],user) + self.assertNotIn('password',user) + self.assertNotIn('password_hash',user) + self.assertGreaterEqual(len(base64.urlsafe_b64decode(session['token']+'=')),32) + + def test_logout_revokes_only_current_session(self): + credentials=self.alice['registration'] + session=self.c.call('POST','/api/v1/auth/sessions',201,headers={'Authorization':basic(credentials['username'],credentials['password'])},schema='Session')['json'] + other={'id':self.alice['id'],'token':session['token']} + self.c.call('DELETE','/api/v1/auth/sessions/current',204,actor=self.alice) + self.c.call('GET','/api/v1/users/me',401,actor=self.alice) + self.c.call('DELETE','/api/v1/auth/sessions/current',401,actor=self.alice) + self.c.call('GET','/api/v1/users/me',actor=other,schema='User') + + def test_chat_rollback_and_membership_validation(self): + before=self.c.call('GET','/api/v1/chats',actor=self.alice,schema='ChatPage')['json'] + for members in ([],[self.alice['id'],self.alice['id']],[self.bob['id']],[self.alice['id'],self.bob['id'],str(uuid.uuid4())],None,[self.alice['id'],1]): + self.c.call('POST','/api/v1/chats',400,body={'title':'ROLLBACK','member_ids':members},actor=self.alice) + self.assertEqual(before,self.c.call('GET','/api/v1/chats',actor=self.alice,schema='ChatPage')['json']) + + def test_multiple_pages_bad_limits_and_cross_resource_cursor(self): + expected=[self.c.message(self.alice,self.chat,str(i))['json'] for i in range(13)] + found=[] + cursor=saved=None + while True: + path=self.path+'/messages?limit='+('2' if cursor is None else '3') + if cursor: + path+='&cursor='+quote(cursor,safe='') + page=self.c.call('GET',path,actor=self.bob,schema='MessagePage')['json'] + found.extend(page['items']) + cursor=page['next_cursor'] + saved=saved or cursor + if cursor is None: + break + self.assertEqual(found,expected) + other=self.c.call('POST','/api/v1/chats',201,body={'title':'Other','member_ids':[self.alice['id']]},actor=self.alice,schema='Chat')['json'] + self.c.call('GET','/api/v1/chats/'+other['id']+'/messages?cursor='+quote(saved,safe=''),400,actor=self.alice) + for query in ('limit=0','limit=101','limit=1.5','limit=true','limit=-1','limit=1&limit=2','cursor=','cursor=bad'): + self.c.call('GET',self.path+'/messages?'+query,400,actor=self.alice) + + def test_read_after_write_during_pagination(self): + expected=[self.c.message(self.alice,self.chat,str(i))['json'] for i in range(3)] + first=self.c.call('GET',self.path+'/messages?limit=2',actor=self.alice,schema='MessagePage')['json'] + late=self.c.message(self.bob,self.chat,'late')['json'] + rest=self.c.call('GET',self.path+'/messages?cursor='+quote(first['next_cursor'],safe=''),actor=self.alice,schema='MessagePage')['json'] + self.assertEqual(first['items']+rest['items'],expected+[late]) + + def test_100_messages_10_clients(self): + actors=[self.alice,self.bob]+[self.c.user('writer') for _ in range(8)] + chat=self.c.call('POST','/api/v1/chats',201,body={'title':'Concurrency','member_ids':[a['id'] for a in actors]},actor=self.alice,schema='Chat')['json'] + barrier=threading.Barrier(10) + def worker(index): + local=Client(self.base) + barrier.wait() + return [local.message(actors[index],chat,f'{index}:{i}')['json'] for i in range(10)] + with ThreadPoolExecutor(max_workers=10) as pool: + sent=[m for values in pool.map(worker,range(10)) for m in values] + page=self.c.call('GET','/api/v1/chats/'+chat['id']+'/messages?limit=100',actor=self.alice,schema='MessagePage')['json'] + self.assertEqual(len(page['items']),100) + self.assertEqual(len({m['id'] for m in page['items']}),100) + self.assertEqual({m['id'] for m in sent},{m['id'] for m in page['items']}) + self.assertIsNone(page['next_cursor']) + + def test_racing_registration(self): + username='race_'+uuid.uuid4().hex[:12] + barrier=threading.Barrier(10) + def register(_): + local=Client(self.base) + barrier.wait() + return local.call('POST','/api/v1/users',[201,409],body={'username':username,'display_name':'Concurrent','password':'Long-password-123'},schema='User')['status'] + with ThreadPoolExecutor(max_workers=10) as pool: + statuses=list(pool.map(register,range(10))) + self.assertEqual(statuses.count(201),1) + self.assertEqual(statuses.count(409),9) + + +if __name__ == '__main__': + unittest.main()