Директивы logrotate: справочник по rotate, size, daily и missingok с шаблоном конфига | AdminWiki

Директивы logrotate: справочник по rotate, size, daily и missingok с шаблоном конфига

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

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Когда файл превысит 100Mdaily игнорируется, самая частая причина «не сработало по расписанию»
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 не срабатывает каждый день

Причины по частоте:

  1. logrotate запускается по cron.daily или таймеру, а не круглосуточно, поэтому время ротации привязано к запуску.
  2. В блоке стоит size, и daily для файла отключён.
  3. Файл добавлен недавно, и state-файл ещё не содержит записи с нужной датой.
  4. Сервис держит файл открытым, ротация прошла, а запись продолжается в переименованный файл: новый файл не появляется без 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.

Проверка конфига перед применением на проде

Последовательность из пяти шагов занимает минуту и снимает большую часть рисков.

  1. Синтаксис и решения: logrotate -d /etc/logrotate.d/myapp. Режим отладки ничего не меняет на диске и показывает, что утилита собирается делать.
  2. Принудительная ротация с подробным выводом: logrotate -v -f /etc/logrotate.d/myapp. Здесь файлы реально переименуются и сожмутся.
  3. Права и владелец нового файла: ls -l /var/log/myapp/app.log. Ожидаете увидеть пользователя сервиса и режим из create.
  4. Запись после ротации: спровоцируйте событие в сервисе и убедитесь, что лог растёт, а не остался пустым.
  5. Состояние: 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 и конфигурационными менеджерами из материала скрипты администрирования.

Поделиться: