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>
5.2 KiB
Кэш карточки чата: запись, попадания, срок, ключи по базе
| Спеки | 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 запросы; замер под нагрузкой — changebench-postgres. - Временная база
make test_isolatedне смешивает свои карточки с рабочими: имя базы — часть ключа.