4.9 KiB
Отчёт — лабораторная 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>, TTLSESSION_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)
Гипотеза
- Keyset
LIMIT 50на hot-чате (~70k сообщений) используетmessages_chat_history_idxи быстрее, чемOFFSET 50000. - Дополнительный индекс только на
(chat_id)не улучшает keyset, но снижает скорость INSERT (~11% на локальном прогоне). - Логический
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 сообщений.