Что такое 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: вывод покажет, какие файлы переименованы, сжаты и удалены.
Проверка результата после ротации
Проверяйте по шагам, иначе легко пропустить, что приложение пишет в старый дескриптор.
- ls -la /var/log/myapp/: появился новый app.log и архив с датой в имени (app.log-20261114) или нумерацией (app.log.1).
- ls -la /var/log/myapp/*.gz: со compress и delaycompress самый свежий архив остаётся несжатым, остальные получают суффикс .gz.
- tail -f /var/log/myapp/app.log: новые строки идут в новый файл, а не в архив.
- lsof | grep myapp или lsof -p $(pgrep -f myapp): дескриптор указывает на актуальный путь, а не на переименованный файл.
- grep myapp /var/lib/logrotate/status: в state-файле зафиксирована свежая дата. Формат строки зависит от версии, важен сам факт обновления.
- 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 rotating | State-файл помнит недавнюю ротацию или интервал больше суток | Проверить daily/weekly в блоке и дату в /var/lib/logrotate/status |
| Приложение пишет в архив, новый файл пустой | Нет переоткрытия дескриптора в postrotate или выбран неверный сигнал | Добавить reload или корректный сигнал, проверить через lsof |
| postrotate не выполняется | Пропущен endscript, нет sharedscripts при маске из нескольких файлов, скрипт возвращает ошибку | Запустить logrotate -f -v и посмотреть строки выполнения скрипта |
| Архивы не сжимаются | Нет compress или мешает delaycompress на первом цикле | Дождаться второй ротации, затем проверить наличие .gz |
Директива su требует аккуратности: logrotate переключается на указанного пользователя, и каталог с логами должен быть ему доступен на запись, иначе ротация упадёт с Permission denied уже на этапе создания файла.
State-файл стоит держать в поле зрения при отладке. Удаление файла или его правка вручную сбрасывает историю: logrotate посчитает, что ротация не выполнялась, и сработает при первом же запуске.
Чек-лист перед применением в проде
- Конфиг лежит в /etc/logrotate.d/ с уникальным именем и правами 0644 root:root.
- Путь и маска совпадают с реальными логами: в выводе -d есть строка considering log с нужным файлом.
- daily и rotate 7 соответствуют политике хранения; для шумных логов добавлен maxsize.
- create задаёт режим, владельца и группу, к которым приложение имеет доступ.
- postrotate переоткрывает лог корректным сигналом, либо осознанно выбран copytruncate.
- Нет дублей пути: поиск по /etc/logrotate.d и /etc/logrotate.conf не находит второй блок.
- logrotate -d отрабатывает без ошибок и показывает ожидаемый интервал и лимит архивов.
- Тестовая ротация logrotate -f /etc/logrotate.d/myapp прошла, архив создан.
- Приложение пишет в новый файл, проверено через tail -f и lsof.
- Расписание активно: cron или logrotate.timer включён, двойного запуска нет, state-файл обновляется.
Порядок действий для новой машины: -d, затем -f по одному блоку, затем проверка дескрипторов и state-файла. Ротация логов в скриптах автоматизации подчиняется тем же правилам: если лог пишет ваш bash-скрипт, посмотрите скрипты администрирования и критерии перехода к конфигурационным менеджерам, чтобы не изобретать свой велосипед с mv и truncate.
Источники
- logrotate(8) — Linux manual page
- Проект OpenNet: MAN logrotate(8)
- Страница руководства logrotate(8)
- logrotate issue #109: duplicate log entry
- Logrotate duplicate log entry: Let's correct it!
- Server Fault: How can I monitor what logrotate is doing?
- Server Fault: How does logrotate exactly handle "daily"?
- Unix StackExchange: why use create and copytruncate together