Журнал Redis: где лежит, как читать и как найти ошибки
Если Redis не запускается, останавливается сам или сайт пишет об ошибке Redis, причину ищут в журнале. В Ubuntu Redis пишет его в файл /var/log/redis/redis-server.log. В journalctl попадают только строки самой службы и ошибки, которые случились до открытия этого файла. Здесь — как прочитать журнал, найти в нём важное и посмотреть, какие команды присылает сайт.
Содержание 12
Что сделать прямо сейчас
- Подключитесь к серверу по SSH (как подключиться).
- Посмотрите последние 20 строк журнала:
sudo tail -n 20 /var/log/redis/redis-server.log - Если Redis запустился без ошибок, после последней строки
Redis is startingесть строкаReady to accept connections. Если порт выключен строкойport 0, вместо неё —The server is now ready to accept connections atи путь к сокету. - Найдите предупреждения — строки со знаком
#, без строк запуска и остановки:sudo grep ' # ' /var/log/redis/redis-server.log | grep -v -E 'Redis is starting|Redis version=|Configuration loaded|Server initialized|User requested shutdown|ready to exit' | tail -n 20Пустой ответ — предупреждений нет. Что значат строки — в разделе какие строки важны.
- Если Redis не запускается, а свежих строк в файле нет, смотрите журнал службы:
sudo journalctl -u redis-server -n 30 --no-pager
Без sudo журнал не прочитать: папка /var/log/redis открыта только пользователю redis и группе adm.
Как читать строку журнала
Пример строки:
812:M 05 Nov 2026 07:20:00.105 * Ready to accept connections| Часть | Что значит |
|---|---|
812 | номер процесса Redis (PID) |
M | кто пишет: M — главный Redis, S — реплика, C — дочерний процесс, который сохраняет данные на диск, X — Sentinel |
05 Nov 2026 07:20:00.105 | дата и время сервера с тысячными долями секунды, месяц по-английски |
* | уровень строки: . — debug, - — verbose, * — notice, # — warning |
Ready to accept connections | само сообщение |
Строки в начале каждого запуска, до Configuration loaded включительно, идут с буквой C: Redis пишет их, пока ещё не закончил запуск. Так устроен код Redis, ошибки тут нет.
Знаком # Redis отмечает не только предупреждения, но и строки запуска и остановки. Поэтому в команде из начала страницы они убраны через grep -v.
Строку такого вида пишет обработчик сигналов, когда Redis просят остановиться:
812:signal-handler (1793863200) Received SIGTERM scheduling shutdown...В скобках — время в секундах с 1 января 1970 года. Перевести в дату: date -d @1793863200.
Время в журнале — по часовому поясу сервера. Узнать пояс: timedatectl.
Какие строки важны
Строки запуска и остановки:
| Строка | Что значит |
|---|---|
Supervised by systemd. Please make sure you set appropriate values for TimeoutStartSec and TimeoutStopSec in your service unit. | Redis запущен службой systemd, так в Ubuntu |
oO0OoO0OoO0Oo Redis is starting oO0OoO0OoO0Oo | Redis начал запускаться |
Redis version=7.0.15, bits=64, … pid=812, just started | версия Redis и номер процесса |
Configuration loaded | redis.conf прочитан без ошибок |
Running mode=standalone, port=6379. | Redis работает один, без кластера, порт 6379 |
Server initialized | Redis готовится загрузить данные |
DB loaded from disk: 0.012 seconds | данные загружены из снимка dump.rdb |
DB loaded from append only file: 0.012 seconds | данные загружены из AOF — сохранение на диск |
Ready to accept connections | Redis готов принимать подключения по порту |
The server is now ready to accept connections at /run/redis/redis-server.sock | готов принимать подключения через сокет — Redis через сокет |
Received SIGTERM scheduling shutdown... | Redis попросили остановиться, например sudo systemctl stop redis-server или restart |
User requested shutdown... | Redis начал останавливаться |
Saving the final RDB snapshot before exiting. и DB saved on disk | перед выходом Redis сохранил данные в dump.rdb |
Redis is now ready to exit, bye bye... | Redis остановился штатно |
Предупреждения и ошибки:
| Строка | Что значит | Что делать |
|---|---|---|
WARNING Memory overcommit must be enabled! … | сохранение на диск может не сработать | разбор |
Can't save in background: fork: и пояснение системы | не хватило памяти, чтобы начать сохранение | разбор |
Background saving error | сохранение на диск не удалось, сайт получит ошибку MISCONF | разбор |
Warning: Could not create server TCP listening socket | адреса из bind нет на сервере или порт занят | Address already in use и bind |
Failed opening Unix socket | Redis не может создать сокет | Redis через сокет |
=== REDIS BUG REPORT START: Cut & paste starting from here === | Redis упал из-за ошибки в самом Redis | Redis остановился сам |
Redis остановился сам
- Посмотрите, когда Redis запускался и останавливался:
sudo grep -n -E 'Redis is starting|bye bye' /var/log/redis/redis-server.log | tail -n 10Строка
bye bye, за нейRedis is starting— штатный перезапуск. Две строкиRedis is startingподряд, безbye byeмежду ними, — Redis прервался. - Проверьте, не остановила ли Redis система, когда кончилась память:
sudo journalctl --dmesg --no-pager | grep -i 'killed process'Если в ответе есть
redis-server— память кончилась: Out of memory: Killed process и сколько памяти отдать Redis. - Найдите отчёт о падении:
sudo grep -n 'REDIS BUG REPORT' /var/log/redis/redis-server.logЕсли строки есть, Redis упал из-за ошибки в самом Redis. Проверьте, есть ли обновление пакета:
sudo apt update, затемapt list --upgradable | grep redis. Сохраните отчёт от строки START до строки END: в нём записано, на чём Redis упал.
В службе Redis в Ubuntu стоит Restart=always: если Redis прервался, systemd запускает его заново. Поэтому после падения Redis снова работает, а в журнале видны два запуска подряд.
Журнал службы: journalctl
Redis в Ubuntu запускает systemd командой /usr/bin/redis-server /etc/redis/redis.conf --supervised systemd --daemonize no. Свои строки Redis пишет в файл из строки logfile, а в журнал службы попадают:
- строки systemd: служба запущена, остановлена, завершилась с ошибкой;
- ошибки, которые Redis выводит до открытия своего файла журнала. Главная из них —
*** FATAL CONFIG FILE ERROR (Redis 7.0.15) ***, ошибка в redis.conf: разбор.
| Команда | Что покажет |
|---|---|
sudo journalctl -u redis-server -n 30 --no-pager | последние 30 строк |
sudo journalctl -u redis-server --since today --no-pager | всё за сегодня |
sudo journalctl -u redis-server -f | новые строки по мере появления, выход — Ctrl+C |
Следить за файлом журнала так же: sudo tail -f /var/log/redis/redis-server.log, выход — Ctrl+C.
Уровень журнала: loglevel
Строка loglevel в redis.conf решает, сколько Redis пишет в журнал:
| Значение | Что пишет |
|---|---|
debug | всё подряд, очень много строк — для разработчиков Redis |
verbose | то же, что notice, и ещё каждое подключение (Accepted 127.0.0.1:51234) и каждые 5 секунд число ключей в базах |
notice | так в Ubuntu: запуск, остановка, сохранение на диск, предупреждения |
warning | только строки со знаком # |
- Посмотреть уровень:
redis-cli CONFIG GET loglevel. - Поменять до перезапуска:
redis-cli CONFIG SET loglevel verbose— действует сразу. - Вернуть:
redis-cli CONFIG SET loglevel notice.
Если на Redis стоит пароль, пишите redis-cli --askpass вместо redis-cli. Чтобы уровень сохранился после перезапуска, поменяйте строку loglevel в redis.conf — перезапуск или CONFIG SET.
Где лежит журнал
- Путь задаёт строка
logfile /var/log/redis/redis-server.log. Через CONFIG SET её не поменять — только правка файла и перезапуск. - Другая папка не подойдёт: Redis в Ubuntu может писать только в /var/lib/redis, /var/log/redis и /run/redis, а папка /tmp у него своя, отдельная — журнал там не найти. С путём в другой папке Redis не запустится, а в journalctl будет
FATAL CONFIG FILE ERRORиCan't open the log file:с пояснением системы. logfile ""— Redis пишет журнал не в файл, а в журнал службы. Тогда всё смотрят через journalctl.
Старые журналы
В пакете Redis в Ubuntu есть файл /etc/logrotate.d/redis-server. По нему раз в неделю журнал переименовывается, и Redis начинает новый:
| Файл | Что в нём |
|---|---|
redis-server.log | текущая неделя |
redis-server.log.1 | прошлая неделя, не сжат |
redis-server.log.2.gz … redis-server.log.12.gz | недели раньше, сжаты |
Журналы старше 12 недель удаляются. Пустой журнал не переименовывается.
| Команда | Что делает |
|---|---|
sudo ls -lh /var/log/redis/ | список журналов и их размер |
sudo tail -n 50 /var/log/redis/redis-server.log.1 | конец журнала за прошлую неделю |
sudo zgrep ' # ' /var/log/redis/redis-server.log.2.gz | строки со знаком # в сжатом журнале |
Конец сжатого журнала:
sudo zcat /var/log/redis/redis-server.log.2.gz | tail -n 50Redis открывает файл журнала заново на каждую строку. Поэтому после переименования он сразу пишет в новый файл, перезапускать Redis не нужно. Сколько места заняли журналы: sudo du -sh /var/log/redis — команды df и du.
Какие команды присылает сайт: MONITOR
redis-cli MONITOR выводит каждую команду, которую получает Redis, пока вы не нажмёте Ctrl+C:
OK
1793863200.105381 [0 127.0.0.1:51234] "GET" "user:1"
1793863200.106002 [0 unix:/run/redis/redis-server.sock] "SET" "page:home" "…"| Часть | Что значит |
|---|---|
1793863200.105381 | время в секундах с 1970 года, до миллионных долей |
0 | номер базы — базы и ключи |
127.0.0.1:51234 | откуда пришла команда: адрес и порт программы. unix:… — через сокет, lua — из скрипта |
"GET" "user:1" | команда и её аргументы |
Записать полминуты команд в файл и посчитать, каких команд больше всего:
- Если на Redis стоит пароль, введите его один раз — на экране он не появится:
read -rs REDISCLI_AUTH export REDISCLI_AUTH - Запишите команды за 30 секунд:
timeout 30 redis-cli MONITOR > ~/monitor.txt - Посчитайте:
awk '{print $4}' ~/monitor.txt | sort | uniq -c | sort -rn | headВ первом столбце — сколько раз пришла команда, во втором — её название.
- Удалите файл и пароль из памяти терминала:
rm ~/monitor.txt unset REDISCLI_AUTH
(redacted), а команды администратора, например CONFIG, не показывает.MONITOR — команда администратора. Пользователю без прав @admin, например site из раздела отдельные пользователи, Redis ответит (error) NOPERM. Какие команды выполняются долго — медленные команды.
Ошибки и как их исправить
| Что видите | Причина | Что делать |
|---|---|---|
| файл журнала пустой или его нет | журнал недавно переименовали, а Redis ещё ничего не написал | смотрите redis-server.log.1 |
| Redis не запущен, свежих строк в файле нет | Redis остановился до открытия журнала | sudo journalctl -u redis-server -n 30 --no-pager |
в journalctl FATAL CONFIG FILE ERROR | ошибка в redis.conf | разбор |
в journalctl Can't open the log file: | путь в logfile ведёт не в /var/log/redis или в нём опечатка | верните logfile /var/log/redis/redis-server.log |
(error) NOPERM на MONITOR или CONFIG SET | у пользователя нет прав администратора | подключитесь под пользователем default — пользователи ACL |
(error) NOAUTH Authentication required. | на Redis стоит пароль | redis-cli --askpass — разбор |
две строки Redis is starting подряд без bye bye | Redis прервался | Redis остановился сам |
Все разборы — в разделе Ошибки Redis. Всё сверено с Redis 7.0.15 — эта версия ставится из пакетов Ubuntu 24.04. В Ubuntu 26.04 ставится Redis 8.0.5.
Источники
- Файл redis.conf в Ubuntu 24.04 — строки loglevel notice, logfile /var/log/redis/redis-server.log, уровни debug, verbose, notice и warning.
- Ротация журнала в пакете Ubuntu: debian/redis-server.logrotate — weekly, rotate 12, compress, delaycompress, notifempty.
- Права на папку журнала: debian/redis-tools.postinst — /var/log/redis с правами 2750, владелец redis, группа adm.
- Как в Ubuntu собирается служба redis-server: debian/bin/generate-systemd-service-files — ExecStart, Restart=always, ProtectSystem=strict, ReadWritePaths.
- Файлы пакета redis-server в Ubuntu 24.04 — /etc/logrotate.d/redis-server.
- Исходный код Redis 7.0.15: server.c — формат строки журнала, буквы M, S, C, X, знаки уровней, строки запуска и остановки, обработчик сигналов, файл журнала открывается на каждую запись.
- Исходный код Redis 7.0.15: server.h — номера уровней журнала.
- Исходный код Redis 7.0.15: config.c — loglevel меняется через CONFIG SET, logfile — нет; FATAL CONFIG FILE ERROR и Can't open the log file.
- Исходный код Redis 7.0.15: networking.c — строки Accepted на уровне verbose.
- Исходный код Redis 7.0.15: replication.c — формат строк MONITOR.
- Исходный код Redis 7.0.15: debug.c — REDIS BUG REPORT START и END.
- Документация Redis: MONITOR — на английском: какие команды не показываются, AUTH скрыт, пример со снижением скорости больше чем на 50 %.
Сверено 5 ноября 2026 года.
Что почитать дальше
- Настройки Redisгде лежит redis.conf и как применять правки.
- Медленные команды в RedisSLOWLOG и монитор задержек.
- Ошибка FATAL CONFIG FILE ERRORесли Redis не запускается после правки redis.conf.