logrotate: как ограничить журналы своей программы в /var/log
logrotate раз в сутки переименовывает журналы в /var/log, сжимает старые и удаляет самые старые. Чтобы он следил и за журналом вашей программы, положите файл с настройками в /etc/logrotate.d/ и проверьте его командой sudo logrotate -d.
Содержание 9
Что сделать прямо сейчас
Пример — программа пишет журнал в файл /var/log/myapp/app.log. Замените путь на свой.
- Подключитесь к серверу по SSH (как подключиться).
- Создайте файл настроек:
sudo nano /etc/logrotate.d/myapp. sudo может спросить пароль вашего пользователя на сервере: символы при вводе не видны, наберите пароль и нажмите Enter. - Впишите:
/var/log/myapp/*.log {
daily
rotate 14
compress
delaycompress
missingok
notifempty
copytruncate
}- Сохраните — Ctrl+O и Enter, выйдите — Ctrl+X.
- Проверьте настройку:
sudo logrotate -d /etc/logrotate.d/myapp. Ключ-dничего не меняет, а только показывает, что logrotate сделал бы. В выводе должна быть строкаconsidering log /var/log/myapp/app.log. Строки, которые начинаются сerror:, — ошибки, их разбор ниже. - Чтобы сразу убедиться, что всё работает, запустите ротацию принудительно:
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 — как найти и очистить место |
Источники
- Справка logrotate(8) в Ubuntu 24.04 — на английском: ключи -d, -f, -v, строки daily, rotate, compress, delaycompress, missingok, notifempty, copytruncate, create, size, maxsize, dateext, su, postrotate, sharedscripts; общие настройки и include.
- Исходный код logrotate 3.21.0: config.c — эта версия стоит в Ubuntu 24.04: проверка прав и владельца файла настроек, сообщения unknown option и missing '{'.
- Исходный код logrotate 3.21.0: logrotate.c — проверка прав папки журнала, строки considering log и log does not need rotating.
- Файл logrotate.conf в Ubuntu 24.04 и строка su root adm — общие настройки.
- Файлы logrotate.timer и logrotate.service — запуск раз в сутки и после включения сервера, если запуск был пропущен.
Сверено 23 октября 2026 года.
Что почитать дальше
- StandardOutput: журнал службы в файлкак служба пишет в /var/log.
- journald.confкак ограничить журнал systemd.
- Журналы nginxгде они лежат и как их читать.
- Настройки systemdвсе настройки служб.
- Журнал PostgreSQLгде лежит и как читать.
- Журнал Redisгде лежит и как найти в нём ошибку.
- Журналы Laravelжурнал по дням средствами самого Laravel.