Logrotate в Linux: структура конфигов и базовая настройка ротации | AdminWiki

Logrotate в Linux: структура конфигов и базовая настройка ротации

14 ноября 2026 12 мин. чтения

Что такое logrotate и как он устроен

Logrotate ротирует, сжимает и удаляет файлы логов по расписанию. Демоном он не работает: утилита запускается из cron или systemd timer, обрабатывает конфиги, выполняет действия и завершается. Приложению не нужно ничего знать о ротации, пока вы не заставите его переоткрыть файл.

Конфигурация состоит из двух уровней: глобальный /etc/logrotate.conf с директивами по умолчанию и подключением каталога, и отдельные файлы в /etc/logrotate.d. Порядок чтения определяет, какие значения станут базовыми, а какие переопределят их внутри блока. Минимальный рабочий конфиг для сервиса содержит путь к логам, daily, rotate 7, пересоздание файла через create и переоткрытие лога приложением в postrotate. Синтаксис и логику проверяют командой logrotate -d, немедленный запуск делают командой logrotate -f.

Цикл обработки выглядит так. Logrotate читает конфиг, разворачивает маски путей, для каждого блока сверяется со state-файлом (обычно /var/lib/logrotate/status) и решает, наступил ли срок. Отсюда главная ловушка: daily означает «не чаще одного раза в сутки при очередном запуске», а не «каждый день в 00:00». Решение принимается по дате последней ротации в state-файле: файл ротируется, когда с этой даты прошло нужное число дней (1 для daily, 7 для weekly и т.д.). Конкретный момент запуска задаёт cron или таймер, а не сам logrotate.

Второй слой логики связан с файловыми дескрипторами. Приложение держит лог открытым и продолжает писать в тот же inode после переименования файла. Logrotate умеет пересоздавать файл и вызывать скрипт, но переоткрыть дескриптор может только само приложение по сигналу или команде. Без этого шага вы получите старый растущий файл с новым именем и пустой новый файл.

Имена state-файла и способ запуска отличаются между дистрибутивами и версиями. Проверьте man logrotate и юниты на конкретной машине, прежде чем переносить конфиг с другой системы. Базовое описание утилиты и её опций приведено в man-странице logrotate(8) и в русском переводе man-страницы.

Структура конфигурации: /etc/logrotate.conf и каталог /etc/logrotate.d

Глобальный файл задаёт значения по умолчанию и подключает каталог с drop-in конфигами. Типичный скелет выглядит так:

# /etc/logrotate.conf
weekly
rotate 4
create
dateext
include /etc/logrotate.d

Директива include заставляет logrotate прочитать все файлы указанного каталога. Если в include передан каталог, содержащиеся в нём файлы читаются в алфавитном порядке, прежде чем передаются на обработку для включения. Поэтому файл 00-custom обработается раньше nginx. Файлы, не являющиеся обычными (каталоги, именованные каналы), а также файлы с запрещёнными расширениями из списка tabooext пропускаются. При первоначальном запуске tabooext содержит .rpmorig, .rpmsave, ,v, .swp, .rpmnew и ~. Полный актуальный список смотрите в man-странице: переименование myapp в myapp.disabled выключает конфиг без удаления файла только там, где .disabled действительно добавлен в tabooext.

Пакетные конфиги для nginx, rsyslog, fail2ban и других сервисов уже лежат в /etc/logrotate.d. Правки в них переживут не каждое обновление пакета: .rpmnew и .dpkg-dist появляются именно из-за конфликта изменённых файлов. Для собственных сервисов создавайте отдельный файл с уникальным именем.

Порядок чтения и приоритет директив

Действует простое правило: директивы из /etc/logrotate.conf работают как значения по умолчанию, а директивы внутри блока переопределяют их. Глобально стоит weekly, в блоке указано daily, ротация пойдёт ежедневно. Обратное тоже верно: если глобально rotate 4, а в блоке нет своей директивы rotate, сохранятся четыре архива.

Один и тот же лог нельзя описывать в двух файлах. Logrotate читает конфиги последовательно и на повторном пути выдаёт ошибку duplicate log entry for file. Чаще всего причина — дублирующая запись в каталоге /etc/logrotate.d, и обычно проблему решает удаление лишнего блока. Практика: держите один файл на сервис, а общие настройки выносите в глобальный конфиг.

Внутри одного блока противоречивые директивы (например, weekly и daily одновременно) лучше не держать: поведение зависит от версии logrotate. Уберите лишнюю строку, а не надейтесь на порядок.

Проверка приоритета занимает одну команду. Запустите logrotate -d /etc/logrotate.conf и найдите в выводе строку rotating pattern для нужного блока: там будет видно, какой интервал применился и сколько архивов разрешено.

Анатомия блока конфига

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

/var/log/myapp/*.log {
    daily
    rotate 7
}

Отступы нужны только людям, парсер их игнорирует. Закрывающая скобка обязательна: её отсутствие даёт ошибку вида error: ... } expected с указанием файла и строки. Кавычки вокруг путей не требуются. Если файлов по маске несколько, каждый считается отдельным логом со своим состоянием, а sharedscripts склеивает для них один вызов скриптов.

Минимальный рабочий конфиг с ежедневной ротацией и семью копиями

Положите файл /etc/logrotate.d/myapp с правами 0644 и владельцем root. Содержимое:

/var/log/myapp/*.log {
    daily
    rotate 7
    missingok
    notifempty
    compress
    delaycompress
    create 0640 myapp myapp
    sharedscripts
    postrotate
        systemctl reload myapp.service > /dev/null 2>&1 || true
    endscript
}
  • daily: ротация не чаще одного раза в сутки, момент определяется запуском cron или таймера.
  • rotate 7: хранить семь архивов. С dateext это семь файлов с датой в имени, без неё семь нумерованных копий от .1 до .7.
  • missingok: отсутствие файла по маске не считается ошибкой. Без неё logrotate ругается в лог и завершает обработку блока.
  • notifempty: пустой лог не ротируется, лишние пустые архивы не появляются.
  • compress: архивы сжимаются gzip, на текстовых логах экономия часто в разы.
  • delaycompress: самый свежий архив остаётся несжатым на один цикл. Нужен, когда приложение ещё дописывает старый дескриптор или когда вы читаете вчерашний лог без распаковки.
  • create 0640 myapp myapp: сразу после переименования создаётся новый пустой файл с указанными правами и владельцем.
  • sharedscripts: postrotate выполняется один раз на весь блок, а не на каждый совпавший файл.

Директивы size и maxsize решают другую задачу. size 100M ротирует по размеру и игнорирует временные интервалы, maxsize 500M добавляет аварийную ротацию при превышении порога, даже если сутки ещё не прошли. Для логов, которые внезапно раздуваются от ошибок, maxsize полезнее: он ограничивает верхнюю границу файла.

Почему create и postrotate важнее, чем кажется

Ротация переименовывает файл, но не меняет файловый дескриптор процесса. Nginx, приложение на Go или Java продолжат писать в переименованный app.log.1, а новый app.log останется пустым. Через сутки картина повторяется, и место на диске не освобождается.

Решение: сигнал на переоткрытие в postrotate. Для nginx это kill -USR1 $(cat /run/nginx.pid) или nginx -s reopen. Для сервиса под systemd обычно достаточно systemctl reload myapp.service, если в юните описан корректный ExecReload. Для приложения на SIGHUP проверьте в документации, что именно делает сигнал: часть демонов по SIGHUP перечитывает конфиг и роняет соединения, если конфиг битый.

Конструкция || true в примере выше не даёт неудачному reload сорвать всю ротацию: logrotate продолжит работу, а проблему вы увидите в логах сервиса. Если падение reload критично, уберите || true и настройте доставку писем или логов об ошибках. Скрипты в postrotate выполняются через sh, поэтому пригодятся приёмы из материала про логирование и обработку ошибок в скриптах администрирования: ненулевой код выхода, понятные сообщения, отсутствие интерактива.

copytruncate: когда без него не обойтись

Часть приложений не умеет переоткрывать лог: самописные скрипты, некоторые Java-сервисы, программы с жёстко прописанным путём. Для них есть copytruncate: logrotate копирует файл в архив и обрезает оригинал до нуля, inode при этом не меняется, дескриптор остаётся валидным.

Учтите ограничения. Копирование и обрезание — две отдельные операции, поэтому строки, записанные в промежутке между ними, могут не попасть в архив. На активном логе с сотнями записей в секунду такие потери заметны. Совместное использование copytruncate и create требует отдельной проверки на вашей версии logrotate: не полагайтесь на то, что конфликт директив разрешится предсказуемо. Выбирайте copytruncate как запасной вариант, когда переоткрытие недоступно.

Если лог пишет само приложение, ротацию иногда разумнее отдать ему. В Python, например, есть RotatingFileHandler и TimedRotatingFileHandler: настройка логирования в Python описывает оба варианта вместе с поведением в контейнерах. Правило простое: один владелец файла, либо logrotate, либо приложение.

Проверка конфигурации перед применением: logrotate -d

Флаг -d включает режим отладки и подразумевает -v. Logrotate читает конфиги, разворачивает маски, сверяется со state-файлом и печатает план действий. В режиме отладки файлы журналов и state-файл не изменяются. Это безопасный способ проверить конфиг на проде.

Для точечной проверки указывайте конкретный файл, а не весь /etc/logrotate.conf: logrotate -d /etc/logrotate.d/myapp. Так вывод короче и не смешивается с чужими блоками.

Как читать вывод logrotate -d

Вывод выглядит примерно так (детали формата зависят от версии):

reading config file /etc/logrotate.d/myapp
including /etc/logrotate.d
considering log /var/log/myapp/app.log
  log does not need rotating (log has already been rotated)
rotating pattern: /var/log/myapp/*.log  after 1 days (7 rotations)

Разбор по строкам:

  • reading config file и including: какие файлы реально прочитаны. Если вашего файла здесь нет, проверьте имя и расширение, его могли отсеять по tabooext.
  • considering log: путь, который раскрылся из маски. Пустой список означает, что маска не совпала с файлами, ищите ошибку в пути.
  • rotating pattern ... after 1 days (7 rotations): применённый интервал и лимит архивов. Числа здесь показывают, что переопределения из блока сработали.
  • log does not need rotating: не ошибка, а решение по state-файлу. Срок ещё не наступил либо лог уже ротировали сегодня.
  • log needs rotating: ротация произошла бы при обычном запуске.

Ошибки синтаксиса печатаются с указанием файла и строки, например error: myapp:12 unknown option 'daly'. Опечатка в имени директивы не игнорируется молча, и это главный аргумент запускать -d после каждой правки.

Типичные ошибки синтаксиса и как их ловить

Пропущенная закрывающая скобка: сообщение } expected и номер строки, где logrotate ждал конец блока. Неизвестная директива: имя и строка в тексте ошибки, лечится сверкой с man-страницей. Повтор пути в двух файлах: duplicate log entry, ищите поиском по /etc/logrotate.d и /etc/logrotate.conf.

Отдельная категория: конфиг синтаксически верный, но бесполезный. Путь с опечаткой, маска без совпадений, rotate 0 вместо rotate 7, забытый include в глобальном файле. Такие проблемы видны только по выводу -d, поэтому читайте блок considering log целиком, а не только последнюю строку.

Права на сам конфиг тоже влияют: файл в /etc/logrotate.d не должен быть доступен на запись посторонним, иначе локальный пользователь сможет подсунуть произвольный postrotate, который выполнится от root. Держите 0644 с владельцем root.

Принудительный запуск ротации: logrotate -f

Флаг -f заставляет ротировать логи, даже если сама программа не считает это необходимым. Применяйте его в трёх случаях: тест нового конфига, срочная ротация разросшегося файла, отладка postrotate.

Ограничивайте область: logrotate -f /etc/logrotate.d/myapp затронет один блок. Запуск logrotate -f /etc/logrotate.conf пройдётся по всем логам системы, включая nginx, rsyslog и пакетные конфиги. На проде это лишний риск. Сначала -d, потом -f по одному файлу, и только затем ожидание расписания.

Для реального запуска с подробностями используйте logrotate -v /etc/logrotate.d/myapp: вывод покажет, какие файлы переименованы, сжаты и удалены.

Проверка результата после ротации

Проверяйте по шагам, иначе легко пропустить, что приложение пишет в старый дескриптор.

  1. ls -la /var/log/myapp/: появился новый app.log и архив с датой в имени (app.log-20261114) или нумерацией (app.log.1).
  2. ls -la /var/log/myapp/*.gz: со compress и delaycompress самый свежий архив остаётся несжатым, остальные получают суффикс .gz.
  3. tail -f /var/log/myapp/app.log: новые строки идут в новый файл, а не в архив.
  4. lsof | grep myapp или lsof -p $(pgrep -f myapp): дескриптор указывает на актуальный путь, а не на переименованный файл.
  5. grep myapp /var/lib/logrotate/status: в state-файле зафиксирована свежая дата. Формат строки зависит от версии, важен сам факт обновления.
  6. du -sh /var/log/myapp: размер каталога перестал расти и соответствует политике хранения.

Если архивы пустые, проверьте copytruncate и notifempty. Если приложение молчит после ротации, вернитесь к postrotate: скорее всего, дескриптор не переоткрылся.

Как logrotate запускается по расписанию

Встречаются два механизма: скрипт /etc/cron.daily/logrotate и systemd timer logrotate.timer. Проверьте, какой активен на вашей машине:

ls -l /etc/cron.daily/logrotate
systemctl status logrotate.timer
systemctl list-timers --all | grep logrotate
systemctl cat logrotate.timer

Если работают оба механизма, ротация может запускаться дважды в сутки. Вреда обычно нет, потому что state-файл не даст ротировать чаще разрешённого, но лишние запуски усложняют диагностику. Посмотрите OnCalendar в юните таймера: значение вида daily означает суточный интервал с разбросом по времени, а не ровно полночь.

Отдельно про journald. Файлы в /var/log/journal logrotate не обслуживает, у systemd-journald своя ротация по размеру и времени. Фильтры, лимиты и настройка хранения разобраны в статье про journalctl и ротацию логов systemd. Для текстовых логов вроде nginx, приложений и скриптов остаётся logrotate.

Если ротация не происходит сама, проверьте три вещи по порядку: активен ли таймер или cron-скрипт, совпадает ли путь с реальным логом, не обновлял ли state-файл кто-то ещё вручную через -f.

Типичные ошибки и диагностика

Большая часть проблем сводится к шести сценариям. Таблица помогает найти причину за пару минут.

СимптомПричинаЧто сделать
Permission denied при открытии логаФайл или каталог закрыт для root-процесса (NFS, SELinux, права каталога), либо лог принадлежит другому пользователюПроверить права и контекст SELinux, добавить директиву su myapp myapp для чужих логов
duplicate log entryОдин путь описан в двух файлах, например в пакетном конфиге и в вашемОставить один блок, остальные удалить или закомментировать
log does not need rotatingState-файл помнит недавнюю ротацию или интервал больше сутокПроверить daily/weekly в блоке и дату в /var/lib/logrotate/status
Приложение пишет в архив, новый файл пустойНет переоткрытия дескриптора в postrotate или выбран неверный сигналДобавить reload или корректный сигнал, проверить через lsof
postrotate не выполняетсяПропущен endscript, нет sharedscripts при маске из нескольких файлов, скрипт возвращает ошибкуЗапустить logrotate -f -v и посмотреть строки выполнения скрипта
Архивы не сжимаютсяНет compress или мешает delaycompress на первом циклеДождаться второй ротации, затем проверить наличие .gz

Директива su требует аккуратности: logrotate переключается на указанного пользователя, и каталог с логами должен быть ему доступен на запись, иначе ротация упадёт с Permission denied уже на этапе создания файла.

State-файл стоит держать в поле зрения при отладке. Удаление файла или его правка вручную сбрасывает историю: logrotate посчитает, что ротация не выполнялась, и сработает при первом же запуске.

Чек-лист перед применением в проде

  1. Конфиг лежит в /etc/logrotate.d/ с уникальным именем и правами 0644 root:root.
  2. Путь и маска совпадают с реальными логами: в выводе -d есть строка considering log с нужным файлом.
  3. daily и rotate 7 соответствуют политике хранения; для шумных логов добавлен maxsize.
  4. create задаёт режим, владельца и группу, к которым приложение имеет доступ.
  5. postrotate переоткрывает лог корректным сигналом, либо осознанно выбран copytruncate.
  6. Нет дублей пути: поиск по /etc/logrotate.d и /etc/logrotate.conf не находит второй блок.
  7. logrotate -d отрабатывает без ошибок и показывает ожидаемый интервал и лимит архивов.
  8. Тестовая ротация logrotate -f /etc/logrotate.d/myapp прошла, архив создан.
  9. Приложение пишет в новый файл, проверено через tail -f и lsof.
  10. Расписание активно: cron или logrotate.timer включён, двойного запуска нет, state-файл обновляется.

Порядок действий для новой машины: -d, затем -f по одному блоку, затем проверка дескрипторов и state-файла. Ротация логов в скриптах автоматизации подчиняется тем же правилам: если лог пишет ваш bash-скрипт, посмотрите скрипты администрирования и критерии перехода к конфигурационным менеджерам, чтобы не изобретать свой велосипед с mv и truncate.

Источники

Поделиться: