logrotateの設定と確認の手順|ログでディスクをいっぱいにしないために
ログは放っておくと増え続け、いずれディスクをいっぱいにします。logrotateは、ログを日付ごとに切り替え、古いものを圧縮・削除する仕組みです。新しいアプリケーションを入れたら、ログの出力先ごとにローテーションの設定を作り、-dで動作を確認してから運用に乗せましょう。
logrotate の仕組み
logrotateは、多くのディストリビューションで1日1回、systemdのタイマー(logrotate.timer)やcronから自動で実行されます。設定は、全体の既定値を書いた/etc/logrotate.confと、ログごとの設定を置く/etc/logrotate.d/の中のファイルに分かれています。新しいアプリケーションのログは、/etc/logrotate.d/にファイルを1つ追加して設定するのが基本です。
ステップ1:設定ファイルを作る
/etc/logrotate.d/myapp
/var/log/myapp/*.log {
daily
rotate 14
compress
delaycompress
missingok
notifempty
create 0640 myapp adm
sharedscripts
postrotate
systemctl reload myapp >/dev/null 2>&1 || true
endscript
}
| 設定 | 意味 |
|---|---|
daily/weekly | ローテーションの間隔 |
rotate 14 | 古いログを14世代まで残し、それより古いものは削除する |
compress/delaycompress | 古いログをgzipで圧縮する。delaycompressは直前の1世代だけ圧縮を遅らせる |
missingok/notifempty | ログが無くてもエラーにしない/空のログはローテーションしない |
create 0640 myapp adm | 新しいログファイルを、指定した権限・所有者で作る |
postrotate〜endscript | ローテーションのあとに実行するコマンド(ログを開き直させる) |
copytruncate | ログを開き直せないアプリケーション向け。コピーしてから元のファイルを空にする |
ローテーションしたあと、アプリケーションが古いファイルに書き続けないよう、postrotateでログを開き直させるのがポイントです。開き直す仕組みが無いアプリケーションには、copytruncateを使います(コピーと空にする間のわずかなログが失われることがあります)。
ステップ2:ドライランで確認する
$ sudo logrotate -d /etc/logrotate.d/myapp
reading config file /etc/logrotate.d/myapp
...
considering log /var/log/myapp/app.log
log does not need rotating (log has been already rotated)
-dは、実際には何も変更せずに、何が起きるかだけを表示します。構文の誤りや、対象のファイルが見つからないことに、ここで気付けます。
ステップ3:強制実行して、結果を確認する
$ sudo logrotate -vf /etc/logrotate.d/myapp
$ ls -l /var/log/myapp/
-rw-r----- 1 myapp adm 0 Nov 19 10:00 app.log
-rw-r----- 1 myapp adm 52341 Nov 19 09:59 app.log.1
-fで強制的にローテーションし、新しいファイルが作られたこと、アプリケーションが新しいファイルに書き込んでいることを確認します。本番では、影響の少ない時間帯に行います。
動いているかを確認する
$ systemctl list-timers logrotate.timer
$ cat /var/lib/logrotate/status | grep myapp
$ sudo journalctl -u logrotate --since yesterday
/var/lib/logrotate/statusには、ログごとの最後のローテーションの日時が記録されています。ここに記録が無い、日付が古い、といった場合は、設定が読み込まれていないか、エラーで止まっています。
よくある失敗
設定ファイルの権限が緩くて、読み込まれない
/etc/logrotate.d/の設定ファイルは、所有者がroot、権限は644にします。グループやその他に書き込み権限があると、安全のため無視されます。
ローテーションしたのに、ディスクが空かない
アプリケーションが削除された古いファイルを開いたままです。postrotateでログを開き直させるか、copytruncateを使います。
ログのディレクトリの権限でエラーになる
ログのディレクトリがroot以外のユーザーに書き込める場合、su ユーザー グループの指定が必要というエラーになります。設定にsu myapp admを追加します。
ログでディスクがいっぱいになったときの対処は「ログが肥大化してディスクを圧迫する」で解説しています。
よくある質問
毎日ではなく、サイズで切り替えられますか?
size 100Mで、指定したサイズを超えたときに切り替えられます。maxsizeを使うと、間隔とサイズのどちらかに達したときに切り替わります。
journald のログも logrotate で管理しますか?
journaldのログは、/etc/systemd/journald.confのSystemMaxUseなどで容量を管理します。logrotateの対象ではありません。
ローテーションの時刻を変えられますか?
sudo systemctl edit logrotate.timerで、OnCalendarを変更します。