Память Redis: как читать INFO memory и что такое фрагментация
Команда INFO memory показывает, сколько памяти Redis занял под данные и сколько ему на деле выделила система. Эти числа не совпадают, и это нормально. Здесь — какие строки смотреть, когда разница между ними говорит о проблеме и как вернуть память системе.
Содержание 8
Что сделать прямо сейчас
- Подключитесь к серверу по SSH (как подключиться).
- Посмотрите главные строки:
redis-cli INFO memory | grep -E 'used_memory_human|used_memory_rss_human|used_memory_peak_human|total_system_memory_human|maxmemory_human|mem_fragmentation_ratio'Если на Redis стоит пароль, пишите
redis-cli --askpassвместоredis-cli. - Сравните ответ с примером:
used_memory_human:24.37M used_memory_rss_human:31.52M used_memory_peak_human:58.10M total_system_memory_human:1.92G maxmemory_human:256.00M mem_fragmentation_ratio:1.29Redis занял под данные 24 МБ, система выделила ему 31 МБ, больше всего было 58 МБ. Лимит — 256 МБ из 1,92 ГБ памяти сервера. Всё в порядке.
- Посмотрите, сколько памяти свободно на сервере:
free -h— как читать ответ. - Если в ответе
maxmemory_human:0B, у Redis нет лимита памяти — как его задать.
Главные строки INFO memory
| Строка | Что показывает |
|---|---|
used_memory_human | сколько памяти Redis занял под ключи, значения и свои служебные нужды — по своему счёту |
used_memory_rss_human | сколько памяти процессу Redis на деле выделила система. В htop это столбец RES — htop |
used_memory_peak_human | больше всего памяти с момента запуска |
used_memory_peak_perc | сколько процентов от пика занято сейчас |
used_memory_dataset | память под сами данные, в байтах |
used_memory_overhead | служебная память: подключения, буферы, таблицы ключей |
total_system_memory_human | вся память сервера |
maxmemory_human | лимит памяти. 0B — лимита нет |
maxmemory_policy | что Redis делает, когда дошёл до лимита — политики |
mem_fragmentation_ratio | во сколько раз память от системы больше used_memory |
mem_fragmentation_bytes | та же разница в байтах |
mem_allocator | чем Redis выделяет память. В Ubuntu 24.04 — jemalloc-5.3.0 |
Все строки раздела: redis-cli INFO memory. Строки с _human — те же числа, переведённые в КБ, МБ и ГБ.
Почему Redis занимает больше, чем данные
used_memory и used_memory_rss считают по-разному:
- used_memory считает сам Redis: сколько байт он попросил под ключи, значения и подключения.
- used_memory_rss считает система: сколько памяти занято процессом. Сюда входят и код Redis с библиотеками, и место, которое распределитель памяти держит про запас.
Поэтому rss немного больше used — так и должно быть.
Когда ключи удаляют, Redis может не отдать память системе. Пример из документации Redis: в Redis записали 5 ГБ, потом удалили 2 ГБ. used_memory станет около 3 ГБ, а rss останется около 5 ГБ. Освободившееся место Redis займёт новыми ключами, но системе его не вернёт.
Из этого два вывода:
- Память сервера планируйте по пику —
used_memory_peak_human, а не по тому, сколько занято сейчас. - Если пик был намного больше, чем занято сейчас, mem_fragmentation_ratio будет высоким. Это не беда: место займут новые ключи.
Фрагментация
Фрагментация — это пустые места между занятыми кусками памяти. Данных в Redis меньше, а система видит, что процесс занимает больше.
Посмотрите две строки:
redis-cli INFO memory | grep -E 'mem_fragmentation_ratio|mem_fragmentation_bytes'| Что в ответе | Что значит |
|---|---|
mem_fragmentation_ratio до 1.4 | всё в порядке |
больше 1.4, а mem_fragmentation_bytes — несколько мегабайт | не проблема: данных мало, а сам процесс Redis с кодом и библиотеками занимает несколько мегабайт |
больше 1.4, а mem_fragmentation_bytes — больше 10 МБ | память фрагментирована, MEMORY DOCTOR считает это проблемой — как вернуть память |
| заметно меньше 1, например 0.7 | система вытеснила часть памяти Redis в swap. Redis будет отвечать с задержками — что такое swap |
Redis может проверить память сам:
redis-cli MEMORY DOCTORОтвет — текст на английском: нет ли фрагментации, не был ли пик в полтора раза больше, чем занято сейчас, не слишком ли велики буферы подключений. Если Redis занимает меньше 5 МБ, он ничего не проверяет и отвечает, что данных слишком мало.
Как вернуть память системе
- Ничего не делайте, если сайт продолжает писать в Redis. Новые ключи займут пустые места, и used_memory_rss расти не будет.
- Попросите распределитель памяти отдать системе пустые страницы:
redis-cli MEMORY PURGEОтвет
OK. Команда работает и в Redis из пакетов Ubuntu. Затем снова посмотритеused_memory_rss_human. Если пустые места разбросаны внутри занятых страниц, команда их не вернёт. - Перезапустите Redis:
sudo systemctl restart redis-server. Новый процесс загрузит данные заново, и пустых мест от удалённых ключей в нём не будет. Пока данные загружаются, Redis отвечает ошибкой LOADING — разбор.
redis-cli CONFIG GET save и redis-cli CONFIG GET appendonly. Если в ответе "" и no, после перезапуска Redis будет пустым. Кэш наполнится заново, а сессии пропадут — посетители вылетят из аккаунтов. Сохранение на диск.Активная дефрагментация в Ubuntu не работает
В Redis есть настройка activedefrag: Redis сам переносит данные на ходу и закрывает пустые места. Она работает только с распределителем jemalloc из исходников Redis. Redis из пакетов Ubuntu собран с системным jemalloc, и включить её нельзя:
redis-cli CONFIG SET activedefrag yes(error) ERR CONFIG SET failed (possibly related to argument 'activedefrag') - Active defragmentation cannot be enabled: it requires a Redis server compiled with a modified Jemalloc…activedefrag yes в redis.conf: Redis не запустится с ошибкой FATAL CONFIG FILE ERROR — разбор. Вместо активной дефрагментации — MEMORY PURGE или перезапуск.Какие ключи занимают больше всего
Сколько ключей в каждой базе:
redis-cli INFO keyspacedb0:keys=15234,expires=15100,avg_ttl=3412345keys— сколько ключей в базе 0;expires— у скольких из них есть время жизни — время жизни ключей;avg_ttl— сколько им в среднем осталось жить, в миллисекундах.
Самые большие ключи по памяти:
redis-cli --memkeysredis-cli проходит по всем ключам и в конце пишет самый большой ключ каждого типа, например Biggest string found 'cache:page:/catalog/' has 524352 bytes. Redis при этом продолжает отвечать сайту. Подробнее — redis-cli.
Сколько занимает один ключ:
redis-cli MEMORY USAGE имя_ключаОтвет — число байт вместе с именем ключа и служебными данными, например (integer) 524352. Если такого ключа нет — (nil). У больших списков, наборов и хешей Redis меряет не все элементы, а 5 и умножает на их число. Посчитать точно: redis-cli MEMORY USAGE имя_ключа SAMPLES 0. На ключе с миллионами элементов это займёт время, и Redis в это время не отвечает сайту.
Как найти ключи по имени — redis-cli.
Ошибки и как их исправить
| Что видите | Причина | Что делать |
|---|---|---|
OOM command not allowed when used memory > 'maxmemory'. | used_memory дошёл до лимита maxmemory | поднимите лимит или смените политику — разбор |
в журнале системы Out of memory: Killed process … (redis-server) | на сервере кончилась память | задайте maxmemory — разбор |
в журнале Redis WARNING Memory overcommit must be enabled! | в системе не включён overcommit | разбор |
в журнале Redis Can't save in background: fork | для снимка на диск не хватило памяти | разбор |
used_memory_rss_human намного больше used_memory_human | фрагментация или пик был намного больше | как вернуть память |
mem_fragmentation_ratio заметно меньше 1 | часть памяти Redis в swap | уменьшите maxmemory или освободите память на сервере — команда free |
Active defragmentation cannot be enabled… | в Redis из пакетов Ubuntu активной дефрагментации нет | как вернуть память без неё |
Все разборы — в разделе Ошибки Redis. Всё сверено с Redis 7.0.15 — эта версия ставится из пакетов Ubuntu 24.04. В Ubuntu 26.04 ставится Redis 8.0.5.
Источники
- Документация Redis: INFO — на английском: строки раздела memory, что значат mem_fragmentation_ratio и used_memory_peak, ratio меньше 1 — память в swap, высокий ratio при разнице в несколько мегабайт — не проблема, строка keyspace.
- Документация Redis: Memory optimization — на английском: пример с 5 ГБ и 2 ГБ, память планировать по пику, ratio ненадёжен после большого пика.
- Документация Redis: MEMORY USAGE — на английском: SAMPLES, по умолчанию 5 элементов, SAMPLES 0 — все.
- Исходный код Redis 7.0.15: object.c — как считается mem_fragmentation_ratio, пороги MEMORY DOCTOR: 1.4 и 10 МБ, пик в 1,5 раза, меньше 5 МБ; ответы MEMORY PURGE и MEMORY USAGE.
- Исходный код Redis 7.0.15: server.c — строки ответа INFO memory и INFO keyspace.
- Исходный код Redis 7.0.15: config.c — текст ошибки Active defragmentation cannot be enabled, та же проверка при чтении redis.conf.
- Исходный код Redis 7.0.15: zmalloc.h — активная дефрагментация только с jemalloc, в котором есть JEMALLOC_FRAG_HINT.
- Сборка Redis в Ubuntu 24.04: debian/rules — Redis собран с USE_SYSTEM_JEMALLOC=yes, с системным jemalloc.
Сверено 5 ноября 2026 года.
Что почитать дальше
- maxmemory в Redisкак задать лимит памяти и что удалять при лимите.
- redis-cliкак найти самые большие ключи.
- Ошибка Out of memory: Killed processчто делать, когда на сервере кончилась память.