Зачем вообще нужна maxmemory-policy и что происходит без неё
maxmemory задаёт предел памяти под данные, maxmemory-policy описывает действие Redis при достижении предела. Пока лимит равен нулю, датасет растёт вместе с нагрузкой и в какой-то момент забирает всю доступную RAM хоста. Дальше срабатывает OOM-killer ядра, и процесс уходит вместе с данными, которые не успели попасть в RDB или AOF.
Лимит держите ниже объёма RAM: часть памяти уходит на фрагментацию, буферы клиентов, буфер репликации и copy-on-write при сохранении RDB. Схема работы простая: задайте maxmemory, выберите политику и убедитесь, что evicted_keys растёт, когда датасет упирается в лимит.
Набор политик зависит от версии. LFU как политика вытеснения появилась в Redis 4.0, тогда же стали доступны значения allkeys-lfu и volatile-lfu (What's New in Redis 4.0, Overview of Redis key eviction policies). Проверка на своём сервере занимает секунду: redis-cli CONFIG GET maxmemory-policy вернёт текущее значение, а попытка redis-cli CONFIG SET maxmemory-policy allkeys-lfu на ветке старше 4.0 закончится ошибкой.
Выбор привязан к типу данных:
- кэш: данные восстановимы из источника, потерю ключей можно пережить;
- сессии: потеря ключа означает разлогин пользователя;
- очереди, счётчики, блокировки, данные-источник истины: потеря ключа означает потерю задачи или записи.
Проверить текущие настройки:
redis-cli CONFIG GET maxmemory
redis-cli CONFIG GET maxmemory-policy
Ответ приходит парой: имя параметра и значение. Значение 0 у maxmemory означает отсутствие лимита, noeviction в maxmemory-policy — отсутствие вытеснения.
Обзор всех политик вытеснения Redis: что делает каждая
Восемь значений делятся на две группы: allkeys-* работают со всем пространством ключей, volatile-* только с ключами, у которых выставлен TTL через EXPIRE, PEXPIRE или SET с параметром EX.
- noeviction: не удаляет ничего. При достижении лимита команды, добавляющие данные, получают ошибку о нехватке памяти (OOM), чтение и удаление работают.
- allkeys-lru: удаляет любой ключ, к которому дольше всего не обращались.
- allkeys-lfu: удаляет любой ключ с наименьшей частотой обращений, доступна с Redis 4.0.
- allkeys-random: удаляет случайный ключ из всего пространства.
- volatile-lru: удаляет ключ с TTL, к которому дольше всего не обращались.
- volatile-lfu: удаляет ключ с TTL с наименьшей частотой обращений.
- volatile-random: удаляет случайный ключ среди ключей с TTL.
- volatile-ttl: удаляет ключ с TTL, у которого ближайший срок истечения.
Ограничение volatile-группы стоит запомнить: если TTL не выставлен ни у одного ключа, вытеснять нечего, и запись упирается в лимит. Проверка наличия TTL: redis-cli INFO keyspace показывает по каждой базе число ключей в поле keys и число ключей с истечением в поле expires. Если expires равен нулю или в разы меньше keys, volatile-политика вам не подходит.
Сравнительная таблица политик: поведение при заполнении памяти и пригодность для задач
| Политика | Какие ключи | Критерий выбора | Кэш | Сессии | Очереди и источник истины | Ключевой риск |
|---|---|---|---|---|---|---|
| noeviction | не вытесняет | нет | плохо: запись падает у лимита | да, с запасом памяти и алертом | да | отказ приложения при нехватке памяти |
| allkeys-lru | все | давность обращения | да, базовый вариант | риск разлогина | нет | вытеснит и важные ключи без TTL |
| allkeys-lfu | все | частота обращений | да, при устойчивом ядре горячих ключей | риск разлогина | нет | новые ключи с низким счётчиком уходят первыми |
| allkeys-random | все | случайно | редко | нет | нет | непредсказуемая потеря ключей |
| volatile-lru | только с TTL | давность обращения | да, если у кэша есть TTL | подходит, если у сессий TTL не выставлен | нет | без TTL вытеснения не будет |
| volatile-lfu | только с TTL | частота обращений | да | как у volatile-lru | нет | без TTL вытеснения не будет |
| volatile-random | только с TTL | случайно | редко | нет | нет | без TTL вытеснения не будет |
| volatile-ttl | только с TTL | ближайшее истечение | условно | нет | нет | удаляет то, что вот-вот истекло, без учёта частоты |
Читать таблицу просто: для кэша берите allkeys-lru или allkeys-lfu, для сессий держите отдельный инстанс, для очередей и данных, которые нельзя терять, оставляйте noeviction и следите за памятью. Таблица задаёт направление, финальное решение проверяйте на стенде с реальным профилем ключей.
LRU и LFU: в чём разница и когда выбирать LFU
LRU вытесняет то, к чему давно не обращались. LFU вытесняет то, к чему обращаются редко. Первая метрика — время, вторая — количество обращений.
Аналогия простая: LRU забывает старое, LFU забывает редкое. Ключ, запрошенный тысячу раз час назад, при allkeys-lru может уйти раньше, чем ключ, запрошенный один раз минуту назад.
LFU выигрывает при устойчивом ядре горячих ключей и длинном хвосте редких. LRU выигрывает там, где важна свежесть: лента, которую читают один раз, кэш страниц с коротким TTL, поток новых объектов.
LFU в Redis хранит счётчик частоты с затуханием: счётчик растёт при обращениях и снижается со временем. Счётчик занимает 8 бит на ключ с максимумом 255 и увеличивается вероятностно с логарифмическим поведением, вероятность вычисляется как 1/(old_value*lfu_log_factor+1), поэтому поведение регулируют два параметра: lfu-log-factor задаёт скорость роста счётчика, lfu-decay-time — время в минутах, за которое счётчик уменьшается (self-documented redis.conf). По умолчанию lfu-log-factor равен 10, lfu-decay-time равен 1, а значение 0 у lfu-decay-time означает, что счётчик никогда не затухает. Свои значения смотрите командами redis-cli CONFIG GET lfu-log-factor и redis-cli CONFIG GET lfu-decay-time, документацию по ним сверяйте с версией своего инстанса.
Побочный эффект LFU: новый ключ стартует с низким счётчиком и при жёстком лимите может уйти раньше, чем наберёт обращения. Для кэша с постоянным потоком новых ключей это повод остаться на allkeys-lru.
Approximate LRU/LFU и maxmemory-samples: точность против CPU
Redis не держит полный отсортированный список всех ключей по времени или частоте доступа: такая структура съела бы память, которую мы экономим. При вытеснении берётся выборка из N случайных ключей, внутри неё выбирается худший кандидат по критерию политики, он и удаляется. Размер выборки задаёт maxmemory-samples (Overview of Redis key eviction policies).
Компромисс прямой: больше samples — точнее выбор и ближе поведение к настоящему LRU или LFU, но выше CPU на каждое вытеснение. Меньше samples — дешевле, но вытеснение может уносить не самые холодные ключи.
Текущее значение: redis-cli CONFIG GET maxmemory-samples.
Менять параметр вслепую не стоит. Сначала оцените evicted_keys, hit ratio по формуле keyspace_hits / (keyspace_hits + keyspace_misses), нагрузку CPU через redis-cli INFO cpu и жалобы приложения на промахи. Рост samples помогает, когда памяти впритык и нужно сохранить горячий набор. Если ключи вытесняются чаще, чем нужно, причина обычно в размере maxmemory и в отсутствии TTL, а не в точности выборки.
Как выбрать политику под кэш, сессии и очереди: матрица решений
| Тип данных | Политика | Почему | Что проверить |
|---|---|---|---|
| HTTP-кэш, фрагменты страниц, результаты запросов | allkeys-lru | свежесть доступа коррелирует с пользой, потерю ключа переживаем | hit ratio и evicted_keys до и после |
| Кэш справочников с устойчиво горячим ядром | allkeys-lfu | редкие ключи уходят первыми, горячие живут дольше | lfu-decay-time и судьба новых ключей |
| Сессии пользователей | отдельный инстанс, noeviction при запасе памяти | вытеснение сессии означает разлогин | отношение used_memory к maxmemory и алерт на 80% |
| Очереди задач, блокировки, идемпотентные ключи | noeviction | удаление задачи означает потерю работы | рост used_memory и ошибки OOM в логах |
| Счётчики rate limit, одноразовые токены | volatile-lru или volatile-ttl | живут по TTL, потеря не критична | доля ключей с expires в INFO keyspace |
| Смешанный инстанс: кэш с TTL и данные без TTL | volatile-lru | вытесняется только кэш, остальное остаётся | нет ли ключей кэша без TTL |
Чек-лист перед сменой политики:
- определите, можно ли терять данные по каждому типу ключей в инстансе;
- проверьте наличие TTL у вытесняемых ключей: redis-cli INFO keyspace, поля keys и expires;
- выберите политику по матрице выше;
- прогоните её на стенде с копией данных или под нагрузочным тестом;
- сравните evicted_keys и hit ratio до и после изменения.
Паттерны кэширования и связку TTL с политикой вытеснения разбираем в материале о стратегиях кэширования от Redis до встроенных механизмов.
Как применить и проверить настройку без риска для прода
Способов два: правка redis.conf с перезапуском или CONFIG SET на лету. Первый даёт постоянное значение, второй быстрее, но не переживает перезапуск.
Правка файла. Откройте redis.conf, задайте лимит и политику:
maxmemory 4gb
maxmemory-policy allkeys-lru
Сделайте копию файла перед правкой: cp /etc/redis/redis.conf /etc/redis/redis.conf.bak. Путь зависит от дистрибутива и способа установки. На Debian и Ubuntu при пакетной установке конфиг обычно лежит в /etc/redis/redis.conf, точный путь виден в юните: systemctl cat redis-server, строка ExecStart с параметром запуска.
Перезапуск означает простой и загрузку датасета из RDB или AOF. На проде это делают в окно обслуживания либо переводят нагрузку на реплику. После перезапуска проверьте состояние: systemctl status redis-server и redis-cli PING, ожидаемый ответ PONG.
Применение на лету:
redis-cli CONFIG SET maxmemory-policy allkeys-lru
Если команда CONFIG не переименована и не ограничена ACL, значение применится сразу. Чтобы оно осталось в файле, выполните redis-cli CONFIG REWRITE: команда перезапишет конфиг, с которым запущен инстанс, а если исходный файл больше не существует, попробует создать его заново. Если сервер был запущен вообще без конфигурационного файла, CONFIG REWRITE вернёт ошибку (CONFIG REWRITE). Без CONFIG REWRITE после перезапуска вернётся старое значение.
Проверка результата:
redis-cli CONFIG GET maxmemory-policy
redis-cli CONFIG GET maxmemory
redis-cli INFO memory
redis-cli INFO stats
В INFO memory смотрите used_memory, used_memory_human, maxmemory, maxmemory_human и mem_fragmentation_ratio. В INFO stats — поле evicted_keys: счётчик растёт при вытеснении и остаётся на нуле, если вытеснения не было с момента старта процесса. Признак работающей настройки: used_memory держится около maxmemory, evicted_keys увеличивается, приложение не получает ошибок записи.
В кластере и при репликации настройку задают на каждом узле отдельно: CONFIG SET действует только на тот процесс, к которому вы подключились. Проверяйте каждый узел своим подключением, включая реплики.
Готовый набор параметров под кэш на Ubuntu 24.04 с Redis 7.x, включая maxmemory и maxmemory-policy allkeys-lru, разобран в статье с рабочим redis.conf для продакшена.
Мониторинг и типичные ошибки при настройке вытеснения
Минимальный набор метрик: evicted_keys, used_memory и его отношение к maxmemory, mem_fragmentation_ratio, keyspace_hits и keyspace_misses, счётчики ошибок на стороне приложения. Добавьте строку OOM в логах Redis и записи OOM-killer в dmesg -T | grep -i 'killed process'.
| Ошибка | Как проявляется | Что делать |
|---|---|---|
| maxmemory не задан | used_memory растёт без потолка, RSS приближается к объёму RAM хоста | задать лимит с запасом на фрагментацию и буферы |
| volatile-политика без TTL | evicted_keys равен нулю, запись упирается в лимит | выставить TTL ключам кэша или перейти на allkeys-* |
| noeviction на кэше | ошибки нехватки памяти при записи, ошибки в приложении | для кэша allkeys-lru или allkeys-lfu, при нехватке памяти увеличить лимит |
| смена политики сразу на проде | непредсказуемое поведение под нагрузкой после изменения | стенд, копия конфига, окно обслуживания |
| нет мониторинга evicted_keys | вытеснение идёт давно, hit ratio упал незаметно | алерты на рост evicted_keys и на used_memory/maxmemory выше 80% |
| CONFIG SET без CONFIG REWRITE | после перезапуска вернулась старая политика | CONFIG REWRITE или правка redis.conf |
Если промахи растут из-за инвалидации, а не из-за вытеснения, смотрите разбор стратегий инвалидации и защиты от Cache Stampede.
Финальный чек-лист перед выходом в прод:
- maxmemory задан и оставляет запас под фрагментацию и буферы;
- политика соответствует типу данных в инстансе;
- у ключей, которые должны вытесняться, есть TTL;
- значение сохранено в redis.conf или зафиксировано через CONFIG REWRITE;
- метрики evicted_keys, used_memory и hit ratio собираются;
- алерты на OOM и на приближение used_memory к maxmemory настроены.
Начните с двух команд: redis-cli CONFIG GET maxmemory и redis-cli CONFIG GET maxmemory-policy. Если maxmemory равен нулю, это первое, что стоит исправить, ещё до выбора политики.