Files
mtusi2026lab2/REPORT.md
T
2026-10-23 14:47:53 +03:00

4.9 KiB
Raw Blame History

Отчёт — лабораторная 2

  • Автор, группа: Журавлев Алексей, БПИ2301
  • Целевая оценка: 5 — уровень 4 + трек 2 (план запроса и восстановление)
  • Commit/PR: TODO
  • Источники: lab1, skeleton lab2, PostgreSQL EXPLAIN/backup docs; помощь ИИ при реализации и экспериментах

Запуск из чистого clone

Prerequisites: Docker Desktop, Python 3.9+.

docker compose up -d --build
py -3 tests/smoke.py --base-url http://localhost:8080
py -3 -m unittest discover -s student-tests -p 'test_*.py'
RUN_INFRA_TEST=1 py -3 -m unittest student-tests.test_dependencies
chmod +x scripts/restart.sh
make test-persistence ACTION_SCRIPT=scripts/restart.sh

Windows persistence: py -3 tests/resilience.py --mode persistence --action-script scripts/restart.bat

Трек 5 (трек 2): py -3 scripts/track2_run.py → RUN_TRACK2_VERIFY=1 py -3 -m unittest student-tests.test_track2

Expiry: docker compose -f compose.yaml -f compose.ttl.yaml up -d --build → RUN_EXPIRY_TEST=1 py -3 -m unittest student-tests.test_lab2.Lab2Grade4Tests.test_session_expiry → вернуть обычный compose.

Образы: python:3.12.11-slim-bookworm, postgres:16.8-alpine, redis:7.4.2-alpine.

Архитектура

  • PostgreSQL — users/chats/messages; миграции migrations/; индекс messages_chat_history_idx (chat_id, created_at, id).
  • Redis AOF — сессии sess:<token>, TTL SESSION_TTL_SECONDS.
  • API — Bearer/Basic по контракту lab2; keyset-пагинация истории.

Доказательства уровня 3–4

Критерий Команда Результат
Smoke py -3 tests/smoke.py PASS
Persistence resilience.py + restart hook PASS
Student auth/race/rollback make student-test PASS
Redis/Postgres down RUN_INFRA_TEST=1 … test_dependencies PASS
Session expiry compose.ttl.yaml + RUN_EXPIRY_TEST=1 PASS

Трек 2 (оценка 5)

Гипотеза

  1. Keyset LIMIT 50 на hot-чате (~70k сообщений) использует messages_chat_history_idx и быстрее, чем OFFSET 50000.
  2. Дополнительный индекс только на (chat_id) не улучшает keyset, но снижает скорость INSERT (~11% на локальном прогоне).
  3. Логический pg_dump → новый volume (compose.track2-restore.yaml) восстанавливает те же counts и контрольные сообщения; RPO ограничен моментом dump (без PITR).

Методика

  • Seed: scripts/track2_seed.py — 100 000 сообщений, 70% в track2_hot, остальное в medium/small чатах.
  • Benchmark: scripts/track2_benchmark.py — EXPLAIN (ANALYZE, BUFFERS, FORMAT JSON) для keyset vs OFFSET vs лишний индекс; 500 INSERT до/после лишнего индекса.
  • Backup/restore: scripts/track2_backup_restore.py — pg_dump -Fc → postgres_restore на порту 5433 → сверка counts + 5 последних сообщений.

Стенд: Docker Desktop, один host, без CPU/RAM limits (учебный ноутбук).

Результаты (2026-10-23)

Сценарий Время / метрика Индекс
Keyset LIMIT 50 (hot) 0.35 ms messages_chat_history_idx (Index Only Scan)
OFFSET 50000 LIMIT 50 7.04 ms тот же индекс, но дороже из‑за offset
Keyset + лишний (chat_id) 9.80 ms planner выбрал худший план
INSERT 500 msg/s 20167 без лишнего индекса vs 18200 с лишним −~11% write throughput

Restore: 111 012 сообщений, dump 2.9 MiB, 7.1 s end-to-end, counts/sample match — см. evidence/track2/restore_report.json.

Ограничения

  • Один PostgreSQL instance; нет WAL archiving / PITR — при аварии между dump и restore возможна потеря записей.
  • Benchmark на синтетических однобуквенных сообщениях; абсолютные ms зависят от железа.
  • Трек 1 (кэш истории) не выбран: Redis используется только для сессий.

Отказы

Воздействие Наблюдение
restart api+postgres+redis (volumes) данные + Bearer-сессия сохраняются
stop redis ready 503, /users/me 503
stop postgres ready 503

Следующие шаги (lab3+)

Горизонтальное масштабирование API, общие сессии Redis, idempotency сообщений.