Поиск
Справочник

Память Redis: как читать INFO memory и что такое фрагментация

Команда INFO memory показывает, сколько памяти Redis занял под данные и сколько ему на деле выделила система. Эти числа не совпадают, и это нормально. Здесь — какие строки смотреть, когда разница между ними говорит о проблеме и как вернуть память системе.

≈ 9 мин чтения
Содержание 8

Что сделать прямо сейчас

  1. Подключитесь к серверу по SSH (как подключиться).
  2. Посмотрите главные строки:
    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.

  3. Сравните ответ с примером:
    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.29

    Redis занял под данные 24 МБ, система выделила ему 31 МБ, больше всего было 58 МБ. Лимит — 256 МБ из 1,92 ГБ памяти сервера. Всё в порядке.

  4. Посмотрите, сколько памяти свободно на сервере: free -h — как читать ответ.
  5. Если в ответе 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 МБ, он ничего не проверяет и отвечает, что данных слишком мало.

Как вернуть память системе

  1. Ничего не делайте, если сайт продолжает писать в Redis. Новые ключи займут пустые места, и used_memory_rss расти не будет.
  2. Попросите распределитель памяти отдать системе пустые страницы:
    redis-cli MEMORY PURGE

    Ответ OK. Команда работает и в Redis из пакетов Ubuntu. Затем снова посмотрите used_memory_rss_human. Если пустые места разбросаны внутри занятых страниц, команда их не вернёт.

  3. Перезапустите Redis: sudo systemctl restart redis-server. Новый процесс загрузит данные заново, и пустых мест от удалённых ключей в нём не будет. Пока данные загружаются, Redis отвечает ошибкой LOADING — разбор.
Перед перезапуском проверьте, что Redis сохраняет данные на диск: 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 keyspace
db0:keys=15234,expires=15100,avg_ttl=3412345
  • keys — сколько ключей в базе 0;
  • expires — у скольких из них есть время жизни — время жизни ключей;
  • avg_ttl — сколько им в среднем осталось жить, в миллисекундах.

Самые большие ключи по памяти:

redis-cli --memkeys

redis-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.

Источники

Сверено 5 ноября 2026 года.

Если не хочется держать базу на своём сервере. Есть облачные базы данных: MySQL, PostgreSQL или Redis без своего VPS, например в Timeweb Cloud Реклама. АО «ТАЙМВЭБ», ИНН 7810353960. erid: CQH36pWzJpoBWKF332yG5h2XQ4cVubfBmkvqAitFqcpzWs. Когда это выгоднее своего сервера, а когда нет, — в статье Сервер для базы данных.

Что почитать дальше