Медленные команды в Redis: SLOWLOG и монитор задержек LATENCY
Redis выполняет команды по одной: пока идёт медленная команда, остальные ждут, и сайт тормозит. Журнал SLOWLOG показывает команды, которые выполнялись дольше 10 миллисекунд, а монитор задержек LATENCY — когда и из-за чего Redis задерживался. Здесь — как их читать и что делать с тем, что нашли.
Содержание 11
- Что сделать прямо сейчас
- Как читать ответ SLOWLOG GET
- Какие команды попадают в журнал
- Что делать с медленными командами
- Какие команды занимают больше всего времени
- Монитор задержек LATENCY
- Сколько ждёт сайт: redis-cli --latency
- Задержки самого сервера: redis-cli --intrinsic-latency
- Ошибки и как их исправить
- Источники
- Что почитать дальше
Что сделать прямо сейчас
- Подключитесь к серверу по SSH (как подключиться).
- Посмотрите последние медленные команды:
redis-cli SLOWLOG GET 10Если на Redis стоит пароль, пишите
redis-cli --askpassвместоredis-cli. - Ответ
(empty array)— с момента запуска Redis ни одна команда не выполнялась дольше 10 мс, медленных команд нет. Если сайт всё равно тормозит — что проверить. - Если записи есть, сравните с примером:
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 мс. Как прочитать остальное — ниже. - Найдите команду в таблице что делать с медленными командами.
Как читать ответ 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-than | 10000 | записывать команды, которые выполнялись 10 000 микросекунд — 10 мс — и дольше |
slowlog-max-len | 128 | хранить 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 пуст.
-@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 commandstatscmdstat_get:calls=182044,usec=210331,usec_per_call=1.16,rejected_calls=0,failed_calls=0calls— сколько раз вызывали команду с момента запуска;usec— сколько микросекунд она выполнялась в сумме;usec_per_call— сколько в среднем занимает один вызов, в микросекундах;failed_calls— сколько вызовов закончились ошибкой.
Разброс по вызовам — в INFO latencystats:
redis-cli INFO latencystatslatency_percentiles_usec_get:p50=1.003,p99=3.007,p99.9=10.015p99=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 LATEST1) 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 --latencyredis-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 refused | Redis не запущен | разбор |
Все разборы — в разделе Ошибки Redis. Всё сверено с Redis 7.0.15 — эта версия ставится из пакетов Ubuntu 24.04. В Ubuntu 26.04 ставится Redis 8.0.5.
Источники
- Документация Redis: SLOWLOG GET — на английском: шесть полей записи, время в микросекундах.
- Документация Redis: Latency monitoring — на английском: события command, fast-command, fork, aof-…, expire-cycle, eviction-cycle; 160 записей на событие; порог в миллисекундах; монитор выключен по умолчанию.
- Документация Redis: Redis CLI — на английском: --latency, --latency-history, --intrinsic-latency запускать на сервере с Redis.
- Файл redis.conf в Ubuntu 24.04 — slowlog-log-slower-than 10000, slowlog-max-len 128, время без передачи по сети, latency-monitor-threshold 0, latency-tracking.
- Исходный код Redis 7.0.15: slowlog.c — SLOWLOG GET по умолчанию 10, -1 — все, обрезка аргументов и строк.
- Исходный код Redis 7.0.15: latency.c — формат ответа LATENCY LATEST, подкоманды HISTORY, DOCTOR, RESET; совет DOCTOR при событии fast-command.
- Исходный код Redis 7.0.15: server.c — строки INFO commandstats и INFO latencystats.
- Исходный код Redis 7.0.15: config.c — что обнуляет CONFIG RESETSTAT.
- Исходный код Redis 7.0.15: redis-cli.c — PING каждые 10 мс в --latency, интервал 15 секунд в --latency-history, строки вывода --intrinsic-latency.
- Описания команд Redis 7.0.15 — SLOWLOG и LATENCY с флагом ADMIN; сложность KEYS, DEL, UNLINK, HGETALL, SMEMBERS, FLUSHALL.
Сверено 5 ноября 2026 года.
Что почитать дальше
- redis-cliкак найти ключи и самые большие из них.
- Память Redis: INFO memoryсколько памяти занимает Redis.
- Настройки RedisCONFIG SET и CONFIG REWRITE.