Поиск
Справочник

logrotate: как ограничить журналы своей программы в /var/log

logrotate раз в сутки переименовывает журналы в /var/log, сжимает старые и удаляет самые старые. Чтобы он следил и за журналом вашей программы, положите файл с настройками в /etc/logrotate.d/ и проверьте его командой sudo logrotate -d.

≈ 8 мин чтения
Содержание 9

Что сделать прямо сейчас

Пример — программа пишет журнал в файл /var/log/myapp/app.log. Замените путь на свой.

  1. Подключитесь к серверу по SSH (как подключиться).
  2. Создайте файл настроек: sudo nano /etc/logrotate.d/myapp. sudo может спросить пароль вашего пользователя на сервере: символы при вводе не видны, наберите пароль и нажмите Enter.
  3. Впишите:
/var/log/myapp/*.log {
    daily
    rotate 14
    compress
    delaycompress
    missingok
    notifempty
    copytruncate
}
  1. Сохраните — Ctrl+O и Enter, выйдите — Ctrl+X.
  2. Проверьте настройку: sudo logrotate -d /etc/logrotate.d/myapp. Ключ -d ничего не меняет, а только показывает, что logrotate сделал бы. В выводе должна быть строка considering log /var/log/myapp/app.log. Строки, которые начинаются с error:, — ошибки, их разбор ниже.
  3. Чтобы сразу убедиться, что всё работает, запустите ротацию принудительно: sudo logrotate -f /etc/logrotate.d/myapp. Затем ls -l /var/log/myapp/ — появится файл app.log.1 со старыми записями, а app.log станет пустым.

Больше ничего запускать не нужно: logrotate сам проверит ваш файл при следующем запуске.

Что значит каждая строка

СтрокаЧто делает
/var/log/myapp/*.log {какие файлы обслуживать; *.log — все файлы с окончанием .log в папке. Настройки — между фигурными скобками
dailyротация раз в сутки; ещё бывает weekly — раз в неделю, monthly — раз в месяц
rotate 14хранить 14 старых файлов, более старые удалять
compressсжимать старые файлы, они получат окончание .gz
delaycompressвчерашний файл .1 не сжимать, сожмётся при следующей ротации — его удобно читать
missingokесли файла нет, молча пропустить
notifemptyпустой файл не трогать
copytruncateскопировать журнал в .1 и обнулить исходный файл — программа продолжает писать в тот же файл
size 100Mротация, когда файл больше 100 МБ, без оглядки на дни; вместо daily
maxsize 100Mротация по дням, но и раньше срока, если файл больше 100 МБ
dateextстарые файлы получат в имени дату вместо номера: app.log-20261023

Размер пишут с буквой: k — килобайты, M — мегабайты, G — гигабайты.

Сжатый журнал читают командой sudo zcat /var/log/myapp/app.log.2.gz, ищут в нём — командой sudo zgrep 'текст' /var/log/myapp/app.log.2.gz.

Когда logrotate запускается

В Ubuntu 24.04 его запускает таймер systemd logrotate.timer раз в сутки. Если сервер был выключен в нужный момент, таймер запустит logrotate после включения. Посмотреть, когда следующий запуск: systemctl list-timers logrotate.timer. Как устроены такие таймеры — в статье systemd timer.

Каждый запуск logrotate читает файл /etc/logrotate.conf, а из него — все файлы папки /etc/logrotate.d/. Когда какой файл обслуживался в последний раз, он записывает в /var/lib/logrotate/status. Поэтому daily не значит «ровно в полночь»: ротация будет при первом запуске, когда с прошлой прошли сутки.

Размер файла тоже проверяется только при запуске. Строка size 100M не остановит журнал, который за сутки вырос до 5 ГБ, — она сработает при следующей проверке.

Общие настройки в /etc/logrotate.conf

В Ubuntu этот файл задаёт строки для всех журналов: weekly, rotate 4, create, su root adm, а в конце — include /etc/logrotate.d. Если в вашем файле нет, например, строки rotate, при ночном запуске возьмётся rotate 4 из общего файла.

При проверке одного файла командой sudo logrotate -d /etc/logrotate.d/myapp общий файл не читается. Поэтому пишите в свой файл все нужные строки, особенно rotate: без неё при запуске одного файла старые копии не хранятся. Проверить всё вместе, как при ночном запуске, — sudo logrotate -d /etc/logrotate.conf, вывод будет длинный.

copytruncate или create

Без строки copytruncate logrotate переименовывает app.log в app.log.1 и создаёт новый пустой app.log. Но программа, которая держит файл открытым, продолжит писать в переименованный app.log.1, а новый файл останется пустым. Есть два выхода:

СпособКогда подходит
copytruncateпрограмма не умеет заново открывать журнал. Подходит для служб systemd со строкой StandardOutput=append:… (как настроить). Справка logrotate предупреждает: между копированием и обнулением может пропасть несколько строк
блок postrotateпрограмма умеет заново открыть журнал по сигналу или команде. Её пишут между postrotate и endscript; так устроены настройки nginx в Ubuntu — журналы nginx

При copytruncate строка create из общего файла не действует: файл остаётся на месте.

Пример с postrotate — программа перечитывает журнал после перезапуска службы:

/var/log/myapp/*.log {
    daily
    rotate 14
    compress
    delaycompress
    missingok
    notifempty
    sharedscripts
    postrotate
        systemctl restart myapp
    endscript
}

sharedscripts нужна, чтобы команда выполнилась один раз, даже если под шаблон *.log попало несколько файлов. Перезапуск прерывает работу программы на несколько секунд, поэтому для служб systemd удобнее copytruncate.

Как проверить

Что проверитьКоманда
что logrotate сделает с вашим файлом, ничего не меняяsudo logrotate -d /etc/logrotate.d/myapp
что сделает ночной запуск со всеми журналамиsudo logrotate -d /etc/logrotate.conf
ротация прямо сейчас, с подробным выводомsudo logrotate -v -f /etc/logrotate.d/myapp
когда журнал обслуживался в последний разsudo grep myapp /var/lib/logrotate/status
когда следующий запускsystemctl list-timers logrotate.timer
чем кончился прошлый запускjournalctl -u logrotate -n 20 --no-pager

Строка log does not need rotating в выводе -d — не ошибка: срок ротации ещё не пришёл или файл пустой. В скобках после неё logrotate пишет причину.

Ошибки и как их исправить

Что видитеЧто делать
error: Ignoring /etc/logrotate.d/myapp because it is writable by group or others.файл настроек могут менять посторонние, logrotate его не читает: sudo chmod 644 /etc/logrotate.d/myapp — подробнее о правах в статье chmod
error: Ignoring /etc/logrotate.d/myapp because the file owner is wrong (should be root or user with uid 0).файл должен принадлежать root: sudo chown root:root /etc/logrotate.d/myapp
error: /etc/logrotate.d/myapp:3 unknown option 'dayly' -- ignoring lineопечатка в строке 3 — сверьте с таблицей выше
error: /etc/logrotate.d/myapp:1 missing '{' after log files definitionпосле пути к журналу нет фигурной скобки { или путь записан с пробелом без кавычек
error: skipping "/var/log/myapp/app.log" because parent directory has … — в конце сообщения совет про suв папку журнала может писать группа или кто угодно. Посмотрите владельца: ls -ld /var/log/myapp. Уберите лишние права: sudo chmod 755 /var/log/myapp — или добавьте в блок строку su владелец группа с теми именами, что показала команда
error: stat of /var/log/myapp/app.log failed: …файла нет: проверьте путь. Если журнал появляется не сразу, добавьте строку missingok
программа пишет в app.log.1, а app.log пустойдобавьте copytruncate или блок postrotate — выше
журналы всё равно заняли дискNo space left on device — как найти и очистить место

Источники

Сверено 23 октября 2026 года.

Где попробовать. Команды из статьи безопаснее сначала повторить на отдельном тестовом сервере, а не на рабочем. Подойдёт VPS с Ubuntu, например Timeweb Cloud Реклама. АО «ТАЙМВЭБ», ИНН 7810353960. erid: CQH36pWzJpoBWKF332yG5h2XQ4cVubfBmkvqAitFqcpzWs. Как зайти на него после заказа — в статье Как подключиться к VPS по SSH.

Что почитать дальше