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

Журнал Redis: где лежит, как читать и как найти ошибки

Если Redis не запускается, останавливается сам или сайт пишет об ошибке Redis, причину ищут в журнале. В Ubuntu Redis пишет его в файл /var/log/redis/redis-server.log. В journalctl попадают только строки самой службы и ошибки, которые случились до открытия этого файла. Здесь — как прочитать журнал, найти в нём важное и посмотреть, какие команды присылает сайт.

≈ 13 мин чтения
Содержание 12

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

  1. Подключитесь к серверу по SSH (как подключиться).
  2. Посмотрите последние 20 строк журнала:
    sudo tail -n 20 /var/log/redis/redis-server.log
  3. Если Redis запустился без ошибок, после последней строки Redis is starting есть строка Ready to accept connections. Если порт выключен строкой port 0, вместо неё — The server is now ready to accept connections at и путь к сокету.
  4. Найдите предупреждения — строки со знаком #, без строк запуска и остановки:
    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

    Пустой ответ — предупреждений нет. Что значат строки — в разделе какие строки важны.

  5. Если 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 oO0OoO0OoO0OoRedis начал запускаться
Redis version=7.0.15, bits=64, … pid=812, just startedверсия Redis и номер процесса
Configuration loadedredis.conf прочитан без ошибок
Running mode=standalone, port=6379.Redis работает один, без кластера, порт 6379
Server initializedRedis готовится загрузить данные
DB loaded from disk: 0.012 secondsданные загружены из снимка dump.rdb
DB loaded from append only file: 0.012 secondsданные загружены из AOF — сохранение на диск
Ready to accept connectionsRedis готов принимать подключения по порту
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 socketRedis не может создать сокетRedis через сокет
=== REDIS BUG REPORT START: Cut & paste starting from here ===Redis упал из-за ошибки в самом RedisRedis остановился сам

Redis остановился сам

  1. Посмотрите, когда 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 прервался.

  2. Проверьте, не остановила ли Redis система, когда кончилась память:
    sudo journalctl --dmesg --no-pager | grep -i 'killed process'

    Если в ответе есть redis-server — память кончилась: Out of memory: Killed process и сколько памяти отдать Redis.

  3. Найдите отчёт о падении:
    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только строки со знаком #
  1. Посмотреть уровень: redis-cli CONFIG GET loglevel.
  2. Поменять до перезапуска: redis-cli CONFIG SET loglevel verbose — действует сразу.
  3. Вернуть: redis-cli CONFIG SET loglevel notice.

Если на Redis стоит пароль, пишите redis-cli --askpass вместо redis-cli. Чтобы уровень сохранился после перезапуска, поменяйте строку loglevel в redis.conf — перезапуск или CONFIG SET.

verbose пишет строку на каждое подключение. Если сайт подключается к Redis на каждой странице, журнал растёт быстро. Включайте verbose только на время поиска причины и потом верните notice.

Где лежит журнал

  • Путь задаёт строка 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 50

Redis открывает файл журнала заново на каждую строку. Поэтому после переименования он сразу пишет в новый файл, перезапускать 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"команда и её аргументы

Записать полминуты команд в файл и посчитать, каких команд больше всего:

  1. Если на Redis стоит пароль, введите его один раз — на экране он не появится:
    read -rs REDISCLI_AUTH
    export REDISCLI_AUTH
  2. Запишите команды за 30 секунд:
    timeout 30 redis-cli MONITOR > ~/monitor.txt
  3. Посчитайте:
    awk '{print $4}' ~/monitor.txt | sort | uniq -c | sort -rn | head

    В первом столбце — сколько раз пришла команда, во втором — её название.

  4. Удалите файл и пароль из памяти терминала:
    rm ~/monitor.txt
    unset REDISCLI_AUTH
MONITOR замедляет Redis. В документации Redis пример: с одним запущенным MONITOR Redis обработал больше чем на 50 % меньше команд в секунду. Запускайте MONITOR на полминуты-минуту и не оставляйте работать.
В выводе MONITOR видны ключи и их значения: сессии посетителей, кеш страниц. Не пересылайте его посторонним. Пароль из команды AUTH MONITOR заменяет на (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 byeRedis прервалсяRedis остановился сам

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

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