Как настроить ротацию логов в Redis

Redis — высокопроизводительная in-memory база данных, активно используемая для кэширования, хранения сессий, реализации очередей и других задач. При интенсивной эксплуатации Redis генерирует обширные логи, особенно в режиме детального логирования (debug или verbose). Без правильной настройки ротации эти логи могут быстро заполнить диск, вызвав сбои в работе системы и недоступность самого сервера Redis. Управление размером и сроком хранения лог-файлов — критически важный аспект администрирования.

Зачем нужна ротация логов в Redis

Логи — основной источник информации о состоянии и поведении Redis. Они фиксируют запуск и остановку сервера, изменения конфигурации, медленные запросы (slow log), сетевые ошибки, действия по синхронизации и многое другое. Однако в условиях высокой нагрузки объём записываемых данных может достигать десятков мегабайт в час. Без контроля такие файлы разрастаются до гигабайт, что создаёт риски:

• Исчерпание свободного места на диске, особенно если логи пишутся на корневой раздел;
• Замедление работы системы из-за постоянной записи больших объёмов данных;
• Сложности при анализе: поиск конкретного события в многогигабайтном файле практически невозможен;
• Нарушение политик безопасности и аудита, если логи не сохраняются должным образом.

Ротация решает эти проблемы. Она автоматически переименовывает текущий лог-файл, создаёт новый пустой файл для записи и, при необходимости, сжимает старые логи или удаляет их по истечении заданного срока. Это позволяет поддерживать чистоту, безопасность и эффективность ведения журналов.

Как работает логирование в Redis: особенности и режимы

Прежде чем настраивать ротацию, важно понимать, как именно Redis работает с логами. Поведение определяется параметрами в конфигурационном файле redis.conf.
Основные директивы:

• logfile — указывает путь к файлу лога. Если не задан, Redis пишет в stdout (стандартный вывод);
• loglevel — уровень детализации: debug, verbose, notice (по умолчанию), warning;
• syslog-enabled — перенаправляет логи в системный syslog;
• syslog-ident — идентификатор процесса в syslog;
• syslog-facility — категория syslog (local0–local7).

Если logfile не указан, Redis выводит сообщения в терминал. Это удобно при разработке, но неприемлемо в production. Поэтому всегда задавайте явный путь, например:

logfile /var/log/redis/redis-server.log

Уровень debug даёт максимальную детализацию, но может генерировать огромные объёмы данных. В рабочих средах рекомендуется использовать notice или warning, а debug включать временно при диагностике проблем.
Когда Redis пишет в файл, он открывает его один раз при старте и продолжает писать в тот же дескриптор. Это означает, что если вы вручную переименуете файл (например, через mv old.log old.log.1), Redis продолжит писать в старый, уже переименованный файл, так как дескриптор остаётся прежним. Именно поэтому необходим механизм, который после переименования сигнализирует Redis о необходимости пересоздания файла.

Какие данные попадают в логи?

Redis записывает в лог следующую информацию:

• Старт и остановка сервера;
• Изменения конфигурации (например, команды CONFIG SET);
• События репликации: подключение мастеров и слейвов;
• Фоновые процессы: RDB-снапшоты, AOF-перезапись;
• Ошибки сети, памяти, сериализации;
• Медленные команды (если slowlog включён);
• Предупреждения о высокой нагрузке или нехватке ресурсов.

Объём зависит от активности клиентов. Например, команда BIGKEYS или массовое удаление ключей может породить сотни строк лога.

Настройка logrotate для Redis: пошаговая инструкция

Logrotate — стандартный инструмент Linux для управления лог-файлами. Он работает по расписанию (обычно ежедневно через cron) и применяет заданные правила к указанным файлам.
Для настройки создайте конфигурационный файл в директории /etc/logrotate.d/. Назовите его, например, redis-server.

Шаг 1: Создание конфигурационного файла

Откройте редактор:

sudo nano /etc/logrotate.d/redis-server

Добавьте следующее содержимое:

Шаг 2: Пример конфигурации

/var/log/redis/*.log {
 daily
 missingok
 rotate 7
 compress
 delaycompress
 notifempty
 create 644 redis redis
 postrotate
 /bin/kill -USR1 `cat /var/run/redis/redis-server.pid 2>/dev/null` 2>/dev/null || true
 endscript
}

Шаг 3: Проверка синтаксиса и тестирование

Проверьте конфигурацию:

sudo logrotate -d /etc/logrotate.d/redis-server

Флаг -d включает режим отладки — logrotate покажет, что будет сделано, но не применит изменения.
Для принудительного запуска (без ожидания расписания):

sudo logrotate -f /etc/logrotate.d/redis-server

Убедитесь, что:

• Создался файл вроде redis-server.log.1.gz;
• Новый redis-server.log существует и доступен для записи;
• Redis продолжает работать и писать в новый файл.

Как Redis обрабатывает сигналы при ротации логов

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

• SIGUSR1 — основной сигнал для пересоздания лог-файла. Рекомендуется официальной документацией.
• SIGHUP — также может использоваться, но в некоторых версиях Redis он перезагружает конфигурацию, что может быть нежелательно.

Когда logrotate переименовывает старый лог и создаёт новый, Redis всё ещё пишет в старый файл (по дескриптору). Отправка SIGUSR1 заставляет процесс:

1. Закрыть текущий файловый дескриптор лога;
2. Открыть файл по пути из logfile заново;
3. Продолжить запись в свежий файл.

Это происходит без остановки сервера и потери данных.

Альтернатива: copytruncate

Если по какой-то причине нельзя использовать сигналы (например, нет доступа к PID), можно применить опцию copytruncate:

copytruncate
postrotate
 # ничего не делаем
endscript

Она работает так:

• logrotate копирует содержимое текущего лога во временный файл;
• Очищает исходный файл на месте (обрезает до нуля);
• Сжимает копию.

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

Распространённые ошибки и как их избежать

Ошибка 1: Логи не ротируются

Возможные причины:

• Файл /etc/logrotate.d/redis-server не существует или содержит синтаксические ошибки;
• Права на файл слишком открытые (logrotate требует 644);
• Конфигурация logrotate не включена в cron (проверьте /etc/cron.daily/logrotate).

Решение: запустите logrotate -d для диагностики.

Ошибка 2: Redis перестаёт писать в лог

Часто возникает при использовании copytruncate или при сбое в отправке сигнала. Redis продолжает писать в старый, уже переименованный файл, но так как он сжат — данные теряются.
Решение: всегда используйте SIGUSR1 и убедитесь, что PID-файл доступен и содержит корректный идентификатор процесса.

Ошибка 3: Нет прав на создание файла

Если в конфиге указано create 644 redis redis, но владелец директории /var/log/redis/ — root, logrotate может не создать новый файл.
Решение: выполните

sudo chown -R redis:redis /var/log/redis/

или измените пользователя в create на root, если Redis запущен от root (не рекомендуется).

Ошибка 4: Логи пишутся в systemd journal

Если Redis запущен через systemd без указания logfile, логи идут в stdout и попадают в journald. В этом случае logrotate их не видит.
Решение: либо настройте ротацию через journalctl (с помощью SystemMaxUse), либо задайте logfile в redis.conf.

Лучшие практики и дополнительные рекомендации

• Регулярный мониторинг размера логов. Настройте алерты в Zabbix, Prometheus или другом мониторинге при превышении порога (например, 500 МБ).
• Централизованное хранение логов. Используйте rsyslog или Fluentd для отправки логов Redis в центральный сборщик (например, ELK или Loki).
• Тестирование ротации в staging-среде. Перед внедрением на продакшен проверьте поведение на тестовом сервере.
• Регулярная проверка конфигурации. После обновления Redis или ОС убедитесь, что пути к PID и логам не изменились.
• Использование Ansible/Puppet для автоматизации. Развертывание конфигурации logrotate должно быть частью IaC.

Пример Ansible-плейбука (фрагмент)

- name: Ensure Redis log directory exists
 file:
 path: /var/log/redis
 state: directory
 owner: redis
 group: redis
 mode: '0755'
- name: Deploy logrotate config for Redis
 copy:
 src: redis-server
 dest: /etc/logrotate.d/redis-server
 owner: root
 group: root
 mode: '0644'

Что делать с медленными запросами?

Slow log в Redis — отдельный механизм (SLOWLOG GET). Он хранится в памяти и не пишется в файл лога. Для анализа медленных команд используйте:

redis-cli slowlog get 10

Если нужно сохранять медленные запросы долгосрочно — настройте скрипт, который периодически выгружает их в отдельный файл, и добавьте этот файл в logrotate.

Экспертное мнение

Ротация логов — не просто техническая процедура, а элемент культуры надёжности. Хорошая практика предполагает не только настройку logrotate, но и регулярную проверку её работоспособности. Рекомендуется раз в месяц проводить тестовую ротацию и проверять, что все компоненты реагируют корректно.
Выбор стратегии зависит от окружения. В контейнеризованных средах (Docker, Kubernetes) логи часто направляются в stdout, а управление осуществляется через sidecar-логеры или политики retention в k8s. В виртуальных машинах и bare metal — предпочтителен классический logrotate.
Ключевой принцип: логи должны быть доступны, читаемы и контролируемы по объёму. Никогда не допускайте ситуации, когда нехватка места на диске приводит к падению Redis. Это нарушает SLA и может повлечь финансовые потери.

Вопросы и ответы

/var/log/redis/redis-6379.log
/var/log/redis/redis-6380.log {
 daily
 rotate 5
 ...
}

Заключение

Настройка ротации логов в Redis — обязательная мера для любой production-системы. Поскольку Redis не имеет встроенного механизма управления размером лог-файлов, администратор должен полагаться на внешние инструменты, в первую очередь logrotate. Корректная конфигурация с использованием сигнала SIGUSR1 гарантирует, что логи будут ротироваться без потерь и простоев.

• Redis не ротирует логи самостоятельно — используйте logrotate.
• Всегда отправляйте SIGUSR1 после ротации для пересоздания файла.
• Избегайте copytruncate в боевых системах.
• Контролируйте права и владельцев файлов в директории логов.
• Интегрируйте настройку в процессы автоматизации и мониторинга.