logrotate не висит в памяти демоном. Утилита запускается по расписанию, читает конфиг, обрабатывает файлы и завершается. На Debian и Ubuntu её вызывает /etc/cron.daily/logrotate либо systemd-таймер logrotate.timer, на RHEL-подобных дистрибутивах тоже таймер или cron. Отсюда первое практическое следствие: daily означает не «ровно в 00:00 каждый день», а «один раз за календарный день при ближайшем запуске».
Второе следствие скрыто в state-файле. logrotate помнит дату последней ротации по каждому файлу и опирается на неё в решении. Добавили блок в конфиг сегодня, и daily может сработать не сразу, а на следующем запуске. Прогнали logrotate -f вручную, и расписание сдвинулось.
Дальше разбираем директивы по группам, показываем, где они конфликтуют (главный конфликт, size против daily), даём готовый шаблон в /etc/logrotate.d/ и порядок проверки, который не страшно выполнить на проде.
Как читать этот справочник: логика директив logrotate
Конфиг logrotate состоит из двух уровней: глобальные опции в /etc/logrotate.conf и блоки для конкретных файлов в /etc/logrotate.d/. Файл /etc/logrotate.conf подключает каталог строкой include /etc/logrotate.d, поэтому оба уровня работают вместе. Глобальные значения (типичный набор: weekly, rotate 4, create) действуют на все файлы, пока блок не переопределит их своими строками.
Три группы директив: когда, сколько и что делать с файлами
Держите в голове три вопроса, и конфиг перестанет быть набором заклинаний.
- Когда ротировать: daily, weekly, monthly, size, maxsize, minsize.
- Сколько хранить: rotate, dateext, olddir.
- Что делать с файлами: compress, delaycompress, copytruncate, create, missingok, notifempty, postrotate/endscript, sharedscripts.
Строки внутри фигурных скобок применяются только к перечисленным путям. Минимальный блок выглядит так:
/var/log/myapp/app.log {
daily
rotate 7
compress
missingok
}
Несколько путей в одном блоке перечисляются через пробел и получают общие опции. Временная директива берётся одна: если написать daily и weekly в одном блоке, применится последняя по порядку чтения, и полагаться на такой конфиг нельзя.
Где лежит state-файл и почему он важен
Путь по умолчанию — /var/lib/logrotate/status; так он описан в man-странице logrotate(8) и в документации Debian. В РЕД ОС, RHEL-подобном дистрибутиве, logrotate читает состояние из /var/lib/logrotate/logrotate.status. Поэтому перед диагностикой уточните фактический путь в вашей системе, а не полагайтесь на память. Посмотреть содержимое: cat /var/lib/logrotate/status. Внутри имя файла и дата последней ротации.
Что это даёт на практике:
- файл, добавленный в конфиг впервые, может пропустить ближайший запуск и ротироваться на следующем;
- daily сравнивает календарные даты, а не интервал в 24 часа;
- ручной прогон с -f обновляет state, поэтому следующий daily подождёт до новой даты;
- после удаления state-файла история ротаций теряется, и первый запуск считает файлы новыми.
Путь state-файла и поведение при ручном запуске подтверждаются man-страницей logrotate(8): man7.org/linux/man-pages/man8/logrotate.8.html и manpages.debian.org/stretch/logrotate/logrotate.8.en.html. Для РЕД ОС — база знаний РЕД ОС.
Справочная таблица директив logrotate
Все три таблицы ниже устроены одинаково: директива, что делает, типичный сценарий, подводный камень. Размеры задаются с суффиксами k, M, G: size 100M, maxsize 500M, minsize 50M.
Директивы времени: daily, weekly, monthly, size, maxsize, minsize
| Директива | Что делает | Типичный сценарий | Подводный камень |
|---|---|---|---|
| daily | Ротирует файл один раз за календарный день при запуске logrotate | Логи Nginx или приложения с ровным трафиком | Порога по размеру нет: за сутки файл может вырасти до гигабайт, добавьте maxsize |
| weekly | Ротирует раз в неделю, обычно в день, соответствующий первому запуску после установки | Редко читаемые логи: аудит, отладка | День недели зависит от даты в state-файле, а не от вашего желания |
| monthly | Ротирует раз в месяц | Архивы раз в 30 дней, отчётные логи | При rotate 12 получаете только год истории, дальше файлы удаляются |
| size 100M | Ротирует при превышении порога, временные директивы для этого файла отключаются | Логи с рваной нагрузкой: то тишина, то всплеск | Медленный лог может не ротироваться неделями, пока не наберёт 100M |
| maxsize 500M | Аварийный порог: ротирует раньше срока, не дожидаясь периода | daily плюс maxsize 500M для продакшена | Без временной директивы ведёт себя непредсказуемо, ставьте в паре с daily |
| minsize 100M | Ротирует, только когда прошёл период И размер достигнут | Редкие логи, чтобы не плодить пустые архивы | Ротация может отложиться на месяцы, размер надо пересматривать |
Запомните приоритет: size в блоке перебивает daily, weekly и monthly. maxsize и minsize работают как дополнение к периоду, а не как его замена. Это поведение зафиксировано в man-странице logrotate(8): man7.org/linux/man-pages/man8/logrotate.8.html.
Директивы хранения: rotate, dateext, olddir
| Директива | Что делает | Типичный сценарий | Подводный камень |
|---|---|---|---|
| rotate 14 | Хранит 14 архивных копий, более старые удаляет | daily плюс rotate 14 дают две недели истории | rotate 4 при weekly даёт всего месяц, проверьте политику хранения заранее |
| rotate 0 | Архивы не хранит: старый файл удаляется после ротации | Шумные отладочные логи, где нужен только текущий файл | Истории не останется вообще, восстановить инцидент будет нечем |
| dateext | Добавляет дату в имя архива вместо порядкового номера | Аудит и передача логов во внешнее хранилище | Сортировка по номеру ломается, скрипты разбора имён придётся править |
| olddir /var/log/archive | Складывает архивы в отдельный каталог | Вынос логов на отдельный раздел или том | Каталог должен быть на той же файловой системе, иначе нужны copy, copytruncate или renamecopy |
Директивы обработки: compress, delaycompress, copytruncate, create, missingok, notifempty
| Директива | Что делает | Типичный сценарий | Подводный камень |
|---|---|---|---|
| compress | Сжимает архив, по умолчанию gzip | Логи с большим объёмом и долгим хранением | Старый архив занимает процессор в момент ротации, для нагруженных хостов планируйте время |
| delaycompress | Откладывает сжатие предыдущего файла на следующий цикл | Приложения, которые ещё дописывают переименованный файл | Без compress директива бессмысленна, ставьте парой |
| copytruncate | Копирует файл и обрезает оригинал, не переименовывая его | Сервис не умеет переоткрывать лог | Операция не атомарна: строки, записанные между копированием и обрезанием, теряются |
| create 0640 app app | Создаёт новый файл с указанными правами и владельцем | Сервис работает под отдельным пользователем | Ошибка в правах или владельце: сервис перестаёт писать в лог молча |
| missingok | Не считает ошибкой отсутствие файла | Необязательные логи, которые появляются не сразу | Скрывает реальную поломку: файл должен быть, а его нет |
| notifempty | Пропускает ротацию пустого файла (обратная директива: ifempty) | Защита от пустых архивов | Может замаскировать остановку записи логов сервисом |
| postrotate/endscript | Выполняет команды после ротации | Переоткрытие лога: nginx -s reopen, kill -HUP, systemctl reload | Ненулевой код возврата команды даёт ошибку в отчёте logrotate |
| sharedscripts | Выполняет скрипт один раз на весь блок, а не на каждый файл | Несколько логов одного сервиса в одном блоке | Без неё команда переоткрытия вызовется столько раз, сколько путей в блоке |
Антипример из практики: notifempty без missingok на нестабильном логе даёт ошибки в cron каждую ночь, когда файл ещё не создан. Для необязательного лога ставьте обе директивы, для критичного обходитесь без missingok и мониторьте наличие файла.
Как size сочетается с daily: когда ротация срабатывает не так, как ожидается
Правило короткое: если в блоке указан size, временные директивы для этого файла не действуют. Ротация идёт только по достижении порога. maxsize добавляет к периоду аварийный порог, minsize требует выполнения обоих условий. Сводка по комбинациям:
| Комбинация в блоке | Когда произойдёт ротация | Что это значит на практике |
|---|---|---|
| daily | Раз за календарный день при запуске | Порога нет, размер файла не ограничен |
| size 100M | Когда файл превысит 100M | Периодичность отключена полностью |
| daily + size 100M | Когда файл превысит 100M | daily игнорируется, самая частая причина «не сработало по расписанию» |
| daily + maxsize 500M | Раз в день или раньше, если файл превысил 500M | Рабочая схема для продакшена |
| daily + minsize 100M | Раз в день, но только если файл больше 100M | Защита от пустых архивов, риск редкой ротации |
Два сценария, которые чаще всего принимают за баг. Медленный лог с size 100M и daily: файл добирает объём неделями, ротации нет, диск в порядке, поведение ожидаемое. Быстрый лог с daily без maxsize: за день файл вырастает до нескольких гигабайт, и однажды место кончается между запусками. Для продакшена берите daily + maxsize 500M + rotate 14 и пересматривайте порог под реальный суточный объём.
Поведение size, maxsize и minsize как триггеров ротации описано в man-странице logrotate(8): man7.org/linux/man-pages/man8/logrotate.8.html. Обсуждение перекрытия size и daily — на Server Fault.
Почему daily не срабатывает каждый день
Причины по частоте:
- logrotate запускается по cron.daily или таймеру, а не круглосуточно, поэтому время ротации привязано к запуску.
- В блоке стоит size, и daily для файла отключён.
- Файл добавлен недавно, и state-файл ещё не содержит записи с нужной датой.
- Сервис держит файл открытым, ротация прошла, а запись продолжается в переименованный файл: новый файл не появляется без create.
Диагностика без изменений на диске:
logrotate -d /etc/logrotate.d/myapp
Вывод показывает, какие файлы найдены, какие условия выполнены и почему файл пропущен. Читайте строки вида «considering log» и «log does not need rotating», они объясняют решение буквально.
Про запуск через systemd-таймер и типичные ошибки диагностики на Debian/Ubuntu — в разборе fastfox.pro.
Практические комбинации директив для типовых сервисов
Три готовых набора, которые закрывают большинство задач.
- Nginx: daily, rotate 14, compress, delaycompress, missingok, notifempty, create 0640 www-data adm, postrotate с nginx -s reopen endscript.
- Приложение с собственным логом и без переоткрытия: daily, maxsize 500M, rotate 7, compress, delaycompress, copytruncate. Команды postrotate не нужны, create не используется.
- Самописный демон с обработкой SIGHUP: daily, maxsize 200M, rotate 10, create 0640 app app, postrotate с kill -HUP по PID-файлу. Для скриптов, которые сами пишут логи и коды возврата, полезны приёмы из материала логирование и обработка ошибок в скриптах администрирования.
copytruncate и create вместе не работают: при copytruncate старый файл остаётся на месте, поэтому create не оказывает эффекта. Ставьте что-то одно. Это прямо указано в man-странице logrotate(8): man7.org/linux/man-pages/man8/logrotate.8.html.
Готовый шаблон конфига logrotate с комментариями
Шаблон кладётся в /etc/logrotate.d/myapp с правами 0644 и владельцем root. Имя файла произвольное, важно, чтобы оно не начиналось с точки: такие файлы logrotate пропускает.
Шаблон для сервиса с поддержкой переоткрытия лога
/var/log/myapp/app.log {
daily # период: раз в сутки
maxsize 500M # аварийный порог внутри суток
rotate 14 # две недели истории
missingok # не падать, если файла пока нет
notifempty # пустой файл не ротировать
compress # архивы в gzip
delaycompress # сжимать предыдущий файл на следующем цикле
create 0640 app app # новый файл с правами сервиса
sharedscripts # скрипт один раз на блок
postrotate
systemctl reload myapp >/dev/null 2>&1 || true
endscript
}
Что менять под свой сервис: путь к логу, пользователя и группу в create, команду в postrotate. Права 0640 с владельцем app означают, что писать может только сервис и группа, читать - они же. Если сервис работает под root, не копируйте это молча: выставьте отдельного пользователя и права под него.
sharedscripts нужен, когда в блоке несколько путей: команда переоткрытия выполнится один раз, а не на каждый файл. Команда в postrotate должна завершаться успешно, иначе logrotate сообщит об ошибке выполнения скрипта.
Шаблон для сервиса без переоткрытия лога
/var/log/legacy/legacy.log {
daily
maxsize 300M
rotate 7
missingok
notifempty
compress
delaycompress
copytruncate
}
Здесь нет ни create, ни postrotate: файл остаётся на месте, содержимое копируется в архив и обрезается. Риск в неатомарности: между копированием и обрезанием есть очень малый промежуток времени, и записанные в него строки могут потеряться. Для критичных логов настройте в приложении переоткрытие по сигналу и вернитесь к первому шаблону. Механика потери строк при copytruncate разобрана в материале itfresh.ru.
Для аудита добавьте dateext: архивы получат имена вида app.log-20261114.gz и перестанут зависеть от счётчика rotate. Если приложение пишет в stdout, а сбором занимается systemd, logrotate не нужен: лимиты и ротацию задаёт journald, детали в руководстве по journalctl и ротации логов systemd.
Проверка конфига перед применением на проде
Последовательность из пяти шагов занимает минуту и снимает большую часть рисков.
- Синтаксис и решения: logrotate -d /etc/logrotate.d/myapp. Режим отладки ничего не меняет на диске и показывает, что утилита собирается делать.
- Принудительная ротация с подробным выводом: logrotate -v -f /etc/logrotate.d/myapp. Здесь файлы реально переименуются и сожмутся.
- Права и владелец нового файла: ls -l /var/log/myapp/app.log. Ожидаете увидеть пользователя сервиса и режим из create.
- Запись после ротации: спровоцируйте событие в сервисе и убедитесь, что лог растёт, а не остался пустым.
- Состояние: cat /var/lib/logrotate/status (в РЕД ОС и RHEL-подобных дистрибутивах путь может отличаться, например /var/lib/logrotate/logrotate.status), проверьте, что дата обновилась.
Предупреждение: -f обновляет state-файл, поэтому следующая daily-ротация сдвинется на новый календарный день. На проде выполняйте принудительный прогон осознанно, лучше в окно, когда потеря одного цикла расписания не критична.
Чек-лист перед деплоем конфига
- Синтаксис проверен через logrotate -d, ошибок в выводе нет.
- Путь к логу существует либо missingok включён осознанно.
- Права и владелец в create совпадают с пользователем сервиса.
- Команда в postrotate рабочая и завершается с кодом 0.
- copytruncate и create не используются вместе.
- rotate соответствует политике хранения, а не поставлен наугад.
- compress и delaycompress стоят парой.
- Файл лежит в /etc/logrotate.d/ с правами 0644 и владельцем root.
Типичные ошибки и как их избежать
- size вместе с daily без понимания приоритета. Как правильно: daily плюс maxsize, если нужны и период, и порог.
- copytruncate на критичных логах. Как правильно: переоткрытие по сигналу и create, copytruncate только как вынужденная мера.
- create с правами root там, где сервис работает под своим пользователем. Как правильно: create 0640 app app и проверка через ls -l после первой ротации.
- Отсутствие missingok на нестабильном логе. Как правильно: missingok для необязательных логов, мониторинг наличия файла для критичных.
- notifempty без missingok. Как правильно: ставить обе директивы или ни одной, но тогда следить за отчётами cron.
- delaycompress без compress. Как правильно: только парой.
- postrotate без sharedscripts при нескольких файлах в блоке. Как правильно: sharedscripts плюс одна команда переоткрытия на весь блок.
- Забытый state-файл после ручной ротации. Как правильно: после logrotate -f учитывать сдвиг расписания и не удивляться пропуску daily.
Рабочая привычка: держите шаблон конфига в репозитории рядом с конфигом сервиса, фиксируйте политику хранения в README (сколько дней храните, какой суточный объём ожидаете) и прогоняйте logrotate -d в CI или на стейдже перед выкаткой. Тогда ротация перестаёт быть ночным сюрпризом и становится предсказуемой частью деплоя. Для скриптов, которые сами управляют логами и бэкапами, пригодятся критерии выбора между Bash и конфигурационными менеджерами из материала скрипты администрирования.