Полное руководство по Logrotate: практическое применение на Linux

Журналы на сервере растут постоянно, и если за ними не следить, однажды они займут весь диск. Logrotate решает эту задачу: по расписанию переименовывает текущий журнал, сжимает старые и удаляет самые давние. Разберём, как он устроен и как его настроить.

Установка и запуск

Logrotate есть почти во всех дистрибутивах. Проверка:

logrotate --version

Если его нет:

sudo apt install logrotate     # Debian, Ubuntu
sudo dnf install logrotate     # RHEL, Fedora
sudo pacman -S logrotate       # Arch

Сам по себе logrotate не работает как служба. Его раз в день запускает таймер systemd (logrotate.timer) или, в старых системах, задача в /etc/cron.daily/:

systemctl list-timers logrotate.timer

Где лежат настройки

  • /etc/logrotate.conf: общие параметры по умолчанию.
  • /etc/logrotate.d/: отдельные файлы для каждого приложения. Пакеты кладут сюда свои конфигурации при установке.

Типичный /etc/logrotate.conf:

weekly
rotate 4
create
include /etc/logrotate.d

Основные директивы

  • daily, weekly, monthly: частота ротации.
  • size 100M: ротировать, когда файл больше указанного размера. maxsize делает то же, но не раньше заданной частоты.
  • rotate 7: сколько старых копий хранить.
  • compress и delaycompress: сжимать старые копии, но последнюю оставлять несжатой (полезно, если программа ещё дописывает в неё).
  • missingok: не считать ошибкой отсутствие файла.
  • notifempty: не ротировать пустой файл.
  • create 0640 www-data adm: создать новый файл с такими правами и владельцем.
  • copytruncate: скопировать журнал и обнулить исходный. Для программ, которые не умеют переоткрывать файл. Возможна потеря нескольких строк.
  • dateext: добавлять к имени дату вместо номера.
  • sharedscripts: выполнять скрипты один раз для всех файлов блока.
  • postrotate ... endscript: команды после ротации, обычно сигнал программе переоткрыть журнал.
  • su пользователь группа: от чьего имени работать, если каталог доступен на запись не только root.

Пример: Nginx

В Debian и Ubuntu пакет nginx уже содержит /etc/logrotate.d/nginx. Обычно он выглядит так:

/var/log/nginx/*.log {
    daily
    missingok
    rotate 14
    compress
    delaycompress
    notifempty
    create 0640 www-data adm
    sharedscripts
    postrotate
        invoke-rc.d nginx rotate >/dev/null 2>&1
    endscript
}

Команда в postrotate посылает nginx сигнал USR1, и он открывает журналы заново. В конфигурации для других систем можно написать напрямую: [ -f /run/nginx.pid ] && kill -USR1 $(cat /run/nginx.pid).

Пример: своё приложение

/var/log/myapp/*.log {
    daily
    rotate 30
    maxsize 200M
    compress
    delaycompress
    missingok
    notifempty
    dateext
    copytruncate
}

Если приложение умеет переоткрывать журнал по сигналу, вместо copytruncate лучше использовать create и postrotate.

MariaDB и Netdata

  • MariaDB при установке из пакетов уже кладёт свой файл в /etc/logrotate.d/ (обычно mariadb или mysql-server). Не создавайте второй файл для тех же журналов: logrotate выдаст ошибку о дублирующейся записи и может пропустить ротацию.
  • Netdata в современных версиях пишет журналы в журнал systemd, а не в файлы, поэтому logrotate ей часто вообще не нужен. Если журналы в файлах всё-таки есть, пакет обычно содержит свою конфигурацию. Подробнее о Netdata в статье о мониторинге с помощью Netdata.

Проверка и отладка

Пробный прогон без изменений:

sudo logrotate -d /etc/logrotate.d/myapp

Принудительная ротация с подробным выводом:

sudo logrotate -vf /etc/logrotate.d/myapp

Когда и что ротировалось последний раз, видно в файле состояния:

sudo cat /var/lib/logrotate/status

Частые ошибки: неправильные права на каталог (нужна директива su), дублирующиеся пути в двух файлах и синтаксические ошибки в postrotate.

Журнал systemd

Сообщения служб, которые пишут в journald, logrotate не касается. Для них размер задаётся в /etc/systemd/journald.conf (параметр SystemMaxUse) или разовой очисткой:

sudo journalctl --vacuum-size=500M

Связанные статьи

Источники и ссылки


Комментарии загружаются…