Logrotateのソースを表示

[[Category:ロギング]]
[[Category:データ圧縮とアーカイブ]]
[[en:Logrotate]]
{{Related articles start}}
{{Related|Cron}}
{{Related|systemd/タイマー}}
{{Related articles end}}

https://github.com/logrotate/logrotate より:

:''ログファイルが大量に生成されるシステムで、ログファイルの管理を簡単にするために logrotate ユーティリティは作られました。Logrotate はログファイルの自動的なローテーション圧縮や削除、メール送信などを可能にします。Logrotate を設定することで、ログファイルを毎日毎周毎月ごとに管理したり、特定のサイズまで達した時の動作を決められます。''

logrotate の''ローテーション''では、既存のログファイルに数字を割り振って名前を変更し、元の''空の''ログファイルを再作成します。例えば、{{ic|/var/log/syslog.log}} は {{ic|/var/log/syslog.log.1}} に名前が変更されます。{{ic|/var/log/syslog.log.1}} が既に存在する場合、名前は {{ic|/var/log/syslog.log.2}} に変更されます (バックログの数は設定で変えられます)。

==インストール==

Logrotate は {{Pkg|logrotate}} パッケージでインストールできます。

デフォルトでは、logrotate は [[systemd/タイマー|systemd タイマー]]によって毎日動作します: {{ic|logrotate.timer}}。

==設定==

デフォルトのパラメータを設定する logrotate の主な設定ファイルは {{ic|/etc/logrotate.conf}} です。追加のアプリケーション固有の設定ファイルは、{{ic|/etc/logrotate.d}} ディレクトリに含まれています。アプリケーション固有に設定された値は、プライマリ設定ファイルの同じパラメータをオーバーライドします。設定例と使用可能なディレクティブのリファレンスについては、{{man|5|logrotate.conf}} を参照してください。

logrotate が正しく機能するかどうかを確認するには、デバッグモードで実行します。このモードでは、デバッグ出力の生成以外は何も行われません:

 $ logrotate --debug /etc/logrotate.conf

=== ログの圧縮 ===

Logrotate は、{{ic|zstd}} のようなカスタム コマンドを使用してログを圧縮できます。

{{hc|/etc/logrotate.conf|
compress
compresscmd /usr/bin/zstd
compressext .zst
compressoptions -T0 --long
uncompresscmd /usr/bin/unzstd
}}

詳細については、{{man|5|logrotate.conf}} および {{man|1|zstd}} を参照してください。

== 使用方法 ==

logrotate は通常、[[systemd]] サービスを介して実行されます。: {{ic|logrotate.service}}

logrotate を手動で実行するには:
 logrotate /etc/logrotate.conf

単一のログファイルをローテートするには:
 logrotate /etc/logrotate.d/mylog

設定ファイルの実行をシミュレーションするには(''dry run''):
 logrotate --debug /etc/logrotate.d/mylog

条件が満されていない場合でも強制的にローテートするには、次のコマンドを実行します:
 logrotate -vf /etc/logrotate.d/mylog

詳細については、{{man|8|logrotate}} を参照してください。

==トラブルシューティング==

=== exim のログがローテーションされない ===

{{ic|/etc/logrotate.conf}} に {{ic|olddir}} 変数を設定した場合、以下のようなメッセージが表示されます:

{{Ic|error: failed to rename /var/log/exim/mainlog to /var/log/old/mainlog.1: Permission denied}}

この問題を修正するには、ユーザー {{ic|exim}} をグループ {{ic|log}} に追加してください。そして {{ic|olddir}} ({{ic|/var/log/old}}) のグループをデフォルトの {{ic|root}} から {{ic|log}} に変更してください。

=== logrotate の状態を確認 ===
{{ic|cat /var/lib/logrotate.status}} を実行することで logroate によってローテートされているファイルを確認できます:
{{hc| # cat /var/lib/logrotate.status |
"/var/log/mysql/query.log" 2016-3-20-5:0:0
"/var/log/samba/samba-smbd.log" 2016-3-21-5:0:0
"/var/log/httpd/access_log" 2016-3-20-5:0:0
}}
=== 親ディレクトリに安全でない権限があるためログをスキップする ===

どのユーザーとどのグループが {{ic|/etc/logrotate.d/job}} を実行する必要があるかを構成で設定します。

{{bc|
file-to-be-rotated {
    su user group
    rotate 4
}
}}

== 参照 ==

* [https://wiki.gentoo.org/wiki/Logrotate Logrotate on Gentoo Linux Wiki]
* [https://man.archlinux.org/man/logrotate.8 logrotate(8) Manual page]
* [https://man.archlinux.org/man/logrotate.conf.5 logrotate.conf(5) Manual page]