Files
mtusi2026lab2/evidence/cache/hits.md
T
ricoromaandClaude Opus 5.5 25a60d36cd docs: add membership-cache evidence and report
Evidence from cae4b09: cache hits against chats table reads, Valkey
stop/pause/restart and FLUSHALL, restart hook with Valkey, Valkey ports
and password from .env, and a fresh make test_isolated run (103 tests).
REPORT.md describes the role of Valkey, the service table and the new
level 4 rows. The cache-read check now counts seq_scan + idx_scan: the
small chats table is read by sequential scan.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-01 21:31:55 +03:00

5.2 KiB
Raw Blame History

Кэш карточки чата: запись, попадания, срок, ключи по базе

Спеки chat-cache «Чтение из кэша», «Срок записи», «Временная база»; «Повторное чтение чата» (тест test_chat_cache.py)
Change membership-cache, задача 6.1
Дата 2026-10-01 18:22 UTC (разделы 1–3), 18:25 UTC (раздел 4)
Commit cae4b09
Стенд make run_docker: postgres, valkey, migrate, api; API на 127.0.0.1:8080
Хост Docker Desktop 29.8.1, macOS arm64; ВМ Docker: 12 CPU, 7 GiB RAM; лимиты контейнерам не задавались
Клиент разовый stdlib-скрипт; пароли и токены синтетические и в файл не попадают; valkey-cli в контейнере берёт пароль из VALKEYCLI_AUTH

1. Запись после создания

Проверка Значение
POST /chats (alice, участники [bob, alice]) 201
ключ messenger:v1:messenger:chat:2d2efce9…
EXISTS сразу после ответа 201 1 — чат записан в кэш после commit
TTL 3600 с ([cache] chat_ttl_seconds = 3600)
значение (вид) {"id": "<uuid чата>", "title": "<строка, 4 симв.>", "member_ids": ["<uuid 1>", "<uuid 2>"], "created_at": "2026-…-…T…:…:….398672Z"}
порядок member_ids в значении как при создании: да

Название чата заменено описанием: в evidence нет пользовательских текстов.

2. 50 чтений карточки

Перед замером ключ удалён (DEL), чтобы первое чтение было промахом. Читает bob, участник чата.

Счётчики Postgres сняты через 11 с после запросов: простаивающее соединение пула сбрасывает статистику таблиц не сразу, а до 10 с спустя. Таблица chats занимает 4 страницы, и поиск по id Postgres делает последовательным сканированием (EXPLAIN — Seq Scan on chats), поэтому считаются оба счётчика.

Счётчик таблицы chats (pg_stat_user_tables) До После Прирост
seq_scan 278 279 1
idx_scan 1464 1464 0
все чтения таблицы 1742 1743 1
Счётчик Valkey (INFO stats) До После Прирост
keyspace_hits 3 52 49
keyspace_misses 0 1 1

Все 50 ответов — 200 и совпадают с ответом на создание: да. Медиана ответа — 1,6 мс. После чтений TTL ключа — 3589 с: чтения срок не продлевают.

3. Для сравнения: те же 50 чтений без кэша

docker compose stop valkey, затем те же запросы.

Счётчик таблицы chats До После Прирост
seq_scan 279 329 50
idx_scan 1464 1464 0
все чтения таблицы 1743 1793 50

Все 50 ответов — 200 и те же: да. Медиана ответа — 1,7 мс.

4. Ключи по базе: после make test_isolated

Рабочий стенд запущен; make test_isolated прогнал smoke и 103 теста на базе test_messenger с тем же Valkey (evidence/tests/test-isolated.md). Число ключей карточек по префиксу (valkey-cli --scan --pattern):

Префикс Ключей
messenger:v1:messenger:chat:* 1
messenger:v1:test_messenger:chat:* 50

Ключ рабочей базы — от make test-persistence, выполненного до прогона (Valkey перед ним перезапускался и был пуст). Карточки тестового прогона лежат под своим префиксом и рабочему API не видны.

Вывод

  • Новый чат попадает в кэш сразу после commit, со сроком 3600 с и тем же порядком участников.
  • Из 50 чтений одной карточки Postgres читает таблицу chats один раз (промах), остальные 49 — попадания в Valkey. Без кэша — 50 чтений таблицы.
  • На этом стенде таблица chats маленькая, и время ответа с кэшем почти то же (1,6 против 1,7 мс). Выигрыш здесь — снятые с Postgres запросы; замер под нагрузкой — change bench-postgres.
  • Временная база make test_isolated не смешивает свои карточки с рабочими: имя базы — часть ключа.