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

Медленные команды в Redis: SLOWLOG и монитор задержек LATENCY

Redis выполняет команды по одной: пока идёт медленная команда, остальные ждут, и сайт тормозит. Журнал SLOWLOG показывает команды, которые выполнялись дольше 10 миллисекунд, а монитор задержек LATENCY — когда и из-за чего Redis задерживался. Здесь — как их читать и что делать с тем, что нашли.

≈ 10 мин чтения
Содержание 11

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

  1. Подключитесь к серверу по SSH (как подключиться).
  2. Посмотрите последние медленные команды:
    redis-cli SLOWLOG GET 10

    Если на Redis стоит пароль, пишите redis-cli --askpass вместо redis-cli.

  3. Ответ (empty array) — с момента запуска Redis ни одна команда не выполнялась дольше 10 мс, медленных команд нет. Если сайт всё равно тормозит — что проверить.
  4. Если записи есть, сравните с примером:
    1) 1) (integer) 14
       2) (integer) 1793876400
       3) (integer) 25123
       4) 1) "KEYS"
          2) "wp:*"
       5) "127.0.0.1:52344"
       6) ""

    Команда KEYS wp:* выполнялась 25 123 микросекунды — 25 мс. Как прочитать остальное — ниже.

  5. Найдите команду в таблице что делать с медленными командами.

Как читать ответ SLOWLOG GET

Каждая запись — шесть строк:

СтрокаЧто значит
1номер записи. Растёт с каждой новой записью
2когда выполнялась команда, в секундах с 1970 года. Перевести в дату: date -d @1793876400
3сколько выполнялась команда, в микросекундах. 1000 микросекунд — 1 мс
4сама команда и её аргументы
5адрес и порт, откуда подключились. 127.0.0.1 — программа на самом сервере
6имя подключения, если программа его задала командой CLIENT SETNAME. Пусто — не задала

Новые записи идут первыми. SLOWLOG GET без числа покажет 10 последних, SLOWLOG GET -1 — все.

Длинные команды Redis записывает не целиком: не больше 32 аргументов, а у строки длиннее 128 байт — только начало и пометка ... (число more bytes).

Какие команды попадают в журнал

Журнал задают две строки redis.conf:

СтрокаЧто в Ubuntu после установкиЧто значит
slowlog-log-slower-than10000записывать команды, которые выполнялись 10 000 микросекунд — 10 мс — и дольше
slowlog-max-len128хранить 128 последних записей. Новая запись вытесняет самую старую

Время в журнале — это только выполнение команды. Время на передачу ответа по сети сюда не входит. Поэтому, если сайт ждёт Redis долго, а журнал пуст, отдельные команды тут ни при чём: смотрите монитор задержек и проверку задержки.

Записывать команды от 1 мс и хранить 1000 записей:

redis-cli CONFIG SET slowlog-log-slower-than 1000
redis-cli CONFIG SET slowlog-max-len 1000
redis-cli CONFIG REWRITE

Без CONFIG REWRITE после перезапуска вернётся 10 мс и 128 записей — перезапуск или CONFIG SET. 0 в slowlog-log-slower-than записывает каждую команду, отрицательное число выключает журнал.

Другие команды журнала:

  • redis-cli SLOWLOG LEN — сколько записей сейчас в журнале;
  • redis-cli SLOWLOG RESET — очистить журнал. Журнал хранится в памяти и после перезапуска Redis пуст.
SLOWLOG и LATENCY — команды управления, они входят в категорию @admin. Пользователь сайта, созданный с -@admin, получит ошибку (error) NOPERM this user has no permissions to run the 'slowlog|get' command — смотрите журнал под пользователем default — пароль и пользователи.

Что делать с медленными командами

Команда в журналеПочему медленнаяЧто делать
KEYS * или KEYS шаблонперебирает все ключи базы. Документация Redis советует не вызывать её на рабочем сервереключи по шаблону ищут командой SCAN — по частям, не останавливая Redis: как найти ключи. Если KEYS вызывает плагин сайта, напишите его разработчикам или замените плагин
DEL большого списка, набора или хешачем больше элементов в ключе, тем дольше удалениеUNLINK вместо DEL: ключ пропадает сразу, а память освобождается в отдельном потоке
FLUSHALL или FLUSHDBудаляет все ключи разомFLUSHALL ASYNC или FLUSHDB ASYNC — удаление в отдельном потоке
HGETALL, SMEMBERS, LRANGE ключ 0 -1читают большой ключ целикомчитайте частями: HSCAN, SSCAN, LRANGE с небольшим диапазоном

Большие ключи найдёт redis-cli --bigkeys — какие ключи самые большие. Сколько памяти занимает ключ — память Redis.

Какие команды занимают больше всего времени

SLOWLOG показывает отдельные медленные вызовы. Сколько времени ушло на каждую команду в сумме, видно в INFO commandstats:

redis-cli INFO commandstats
cmdstat_get:calls=182044,usec=210331,usec_per_call=1.16,rejected_calls=0,failed_calls=0
  • calls — сколько раз вызывали команду с момента запуска;
  • usec — сколько микросекунд она выполнялась в сумме;
  • usec_per_call — сколько в среднем занимает один вызов, в микросекундах;
  • failed_calls — сколько вызовов закончились ошибкой.

Разброс по вызовам — в INFO latencystats:

redis-cli INFO latencystats
latency_percentiles_usec_get:p50=1.003,p99=3.007,p99.9=10.015

p99=3.007 — 99 вызовов GET из 100 выполнились не дольше 3 микросекунд. Если p99 у команды намного больше p50, часть вызовов медленная — ищите их в SLOWLOG.

Обнулить эти счётчики: redis-cli CONFIG RESETSTAT. Журнал SLOWLOG эта команда не трогает.

Монитор задержек LATENCY

Монитор задержек записывает не только команды, но и другие причины задержек: запуск снимка на диск, запись журнала AOF, удаление ключей с истёкшим сроком. В Ubuntu он выключен: latency-monitor-threshold 0.

Включите его на ходу и задайте порог — в миллисекундах, а не в микросекундах, как у SLOWLOG:

redis-cli CONFIG SET latency-monitor-threshold 100

Теперь Redis записывает всё, что заняло 100 мс и дольше. Документация Redis пишет, что монитор тратит очень мало памяти и времени.

Подождите, пока сайт поработает, и посмотрите последние всплески:

redis-cli LATENCY LATEST
1) 1) "command"
   2) (integer) 1793876400
   3) (integer) 120
   4) (integer) 250

В записи: событие, время последнего всплеска в секундах с 1970 года, сколько он длился в мс и сколько длился самый долгий всплеск этого события.

СобытиеЧто задержалось
commandкоманда — найдите её в SLOWLOG
fast-commandбыстрая команда вроде GET или SET. LATENCY DOCTOR в этом случае советует проверить задержку самого сервера — как проверить
forkзапуск снимка на диск — сохранение на диск
aof-write, aof-fsync-always и другие aof-…запись журнала AOF на диск
expire-cycleудаление ключей с истёкшим временем жизни
eviction-cycleудаление ключей при лимите maxmemory — maxmemory

Другие команды монитора:

  • redis-cli LATENCY HISTORY command — до 160 последних всплесков события: время и длительность в мс. Всплески в одну секунду Redis объединяет и записывает самый долгий.
  • redis-cli LATENCY DOCTOR — отчёт на английском: какие были всплески и что можно сделать. Если монитор выключен, Redis так и ответит: Latency monitoring is disabled in this Redis instance.
  • redis-cli LATENCY RESET — очистить записи.

Если монитор нужен и после перезапуска, выполните redis-cli CONFIG REWRITE. Выключить: redis-cli CONFIG SET latency-monitor-threshold 0.

Сколько ждёт сайт: redis-cli --latency

redis-cli --latency

redis-cli каждые 10 мс отправляет Redis команду PING и меряет, сколько ждал ответа. Строка обновляется на месте:

min: 0, max: 1, avg: 0.11 (1352 samples)

Числа — в миллисекундах: самое быстрое, самое долгое и среднее ожидание, в скобках — сколько раз проверил. Остановить: Ctrl+C.

В отличие от SLOWLOG, сюда входит и подключение, и передача ответа. Запустите проверку на сервере, где работает сайт: если сайт и Redis на разных серверах, так видна задержка сети между ними — redis-cli -h адрес_сервера_с_redis --askpass --latency.

redis-cli --latency-history делает то же, но каждые 15 секунд начинает новую строку — видно, в какое время задержка растёт.

Задержки самого сервера: redis-cli --intrinsic-latency

redis-cli --intrinsic-latency 30

Эта проверка меряет не Redis, а сам сервер: насколько система и виртуализация у хостера задерживают программы. redis-cli не подключается к Redis, а 30 секунд крутит короткие вычисления и записывает самую долгую задержку. Всё это время он занимает одно ядро процессора. Запускайте на том сервере, где работает Redis.

В конце redis-cli напишет две строки:

  • Max latency so far: … microseconds. — самая долгая задержка за проверку, в микросекундах;
  • Worst run took …x longer than the average latency. — во сколько раз она больше средней.

Быстрее, чем позволяет сервер, Redis отвечать не сможет. Если самая долгая задержка здесь такая же, как в redis-cli --latency, Redis ни при чём: задерживает сам VPS.

Ошибки и как их исправить

Что видитеПричинаЧто делать
сайт тормозит, а SLOWLOG GET отвечает (empty array)команды выполняются быстрее 10 мс, задержка не в Redisпроверьте redis-cli --latency, память сервера free -h — команда free — и нагрузку в htop
(error) NOPERM на SLOWLOG GET или LATENCYвошли пользователем без @adminвойдите пользователем default — пароль и пользователи
LATENCY LATEST отвечает (empty array)монитор выключен или всплесков выше порога не быловключите latency-monitor-threshold — монитор задержек
в SLOWLOG одна и та же команда KEYSплагин или код сайта перебирает все ключиобновите плагин, ищите ключи через SCAN
в LATENCY событие fork, задержки во время снимковбольшой Redis долго запускает снимоксохранение на диск, память Redis
Could not connect to Redis at 127.0.0.1:6379: Connection refusedRedis не запущенразбор

Все разборы — в разделе Ошибки 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. Когда это выгоднее своего сервера, а когда нет, — в статье Сервер для базы данных.

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