Debian 13 講座 / journalctlとlogrotateでログを管理する
Debian 13では、journalctlで表示するジャーナルとアプリケーションが直接書き込むファイルログを区別してログを管理します。まず、トラブルシューティングに必要な記録をエクスポートし、ファイルログについては、プログラムの再オープン方式に応じてローテーション、圧縮、保持数を設定する必要があります。このチュートリアルでは、稼働中のログを削除せずに専用ファイルとサービスでlogrotateを操作する方法を示します。
ジャーナルとアプリケーションのファイルログを区別する
systemd-journald はサービスの標準出力とエラー、そしてシステムメッセージをフィールド付きのジャーナルに収集します。journalctl は保存された記録を表示するためのツールです。逆に、/var/log/nginx配下のようなアプリケーションのログファイルはプログラム自身によって開かれ、書き込まれ、logrotate は通常、それらの名前を変更、圧縮、保持します。
| 対象 | 主要ツール | 確認項目 |
|---|---|---|
| systemd ジャーナル | journalctl と journald の設定 | サービス、起動、時間、優先度、保存場所、サイズポリシー |
| プログラムファイルのログ | アプリケーション設定と logrotate | ファイルパス、所有権および開かれているファイル、ローテーション時の再オープンと圧縮のタイミング |
通常のテキストファイルのように rm でジャーナルファイルを削除したり、logrotate に含めたりしてはいけません。ログファイルを削除しても空き容量が増えない場合、それはまだ開かれている削除済みファイルにも関連しています。ディスク容量と削除後も開かれているファイルの診断実習 を使用して df と du を比較し、まずログを書き込むサービスを特定してください。
サービス・起動・時刻で絞り込む
問題が発生したサービスと時間を特定し、次のように問い合わせます。時間の例を実際のサーバーの障害時間に置き換えてください。出力にはアカウント、アドレス、トークンなどの情報が含まれる場合があるため、外部と共有する前に確認してください。
sudo journalctl --list-boots --no-pager
sudo journalctl -b -u nginx.service -n 50 --no-pager
sudo journalctl -b -u nginx.service --since '2026-11-16 22:00:00' --until '2026-11-16 23:00:00' -o short-iso --no-pager
sudo journalctl -b -p warning --no-pager
sudo journalctl -b -k --no-pager
-b は現在のブートを選択し、-b -1 は以前に保存されたブートを選択します。まず --list-boots で存在を確認してください。-u はサービス用、-k はカーネルメッセージ用、-p warning は範囲を警告およびそれ以上の重大度に絞ります。エラーレベルを指定すると情報レベルの手がかりを見逃す可能性があるため、最初からそれだけを見るのは避けてください。
練習用VMでは、以前のブートジャーナルが保存されており、journalctl --disk-usage はアクティブファイルとアーカイブファイルを合わせて40MiBと報告しました。これは現在の例での観察であり、すべてのDebianサーバのデフォルト保持設定ではありません。クエリの権限やフィルタは Debian journalctl マニュアル で確認できます。
ユーザーサービスの場合は、journalctl --user -u UNIT を使用し、UNIT を実際のサービス名に置き換えてください。システムジャーナルへのアクセスが制限されている場合は、便利さのためにアカウントを広範な権限グループに追加するのではなく、必要なクエリに対して sudo を使用してください。
専用ログ書き込みサービス全体を作成する
これは Debian 13、systemd 257、Python 3、logrotate 3.22 の専用実習環境です。以下の例は、一般ユーザー lfstudent の VM を想定しています。別のアカウントを使用する場合は、ユニットの User および Group と logrotateのcreateで指定する所有者を既存の同じアカウントに変更してください。アカウントが存在するかどうかは、id lfstudent で確認できます。
インストール後とパスの確認後に準備してください。専用の名前が既に存在する場合は、既存のファイルを上書きせずに停止してください。このファイルは練習用データのみを記録し、既存のNginxログとはリンクされません。
sudo apt install logrotate python3
id lfstudent
for p in /var/log/lf-log29 /var/backups/lf-debian13-29 /usr/local/libexec/lf-log29-writer.py /etc/systemd/system/lf-log29.service; do
if test -e "$p"; then echo "Already exists: $p" >&2; exit 1; fi
done
sudo install -d -m 755 /var/log/lf-log29 /usr/local/libexec
sudo install -d -m 700 /var/backups/lf-debian13-29
sudo install -m 640 -o lfstudent -g lfstudent /dev/null /var/log/lf-log29/app.log
以下のPythonプログラム全体を保存してください。書き込み中はファイルを開いたままにします。SIGHUP(ハングアップ信号)を受け取ると、再オープン用のフラグを立て、次のループで現在のファイルを閉じて同じパスを開き直します。練習の制限として、記録は約10分までに制限されています。すべての一般サービスがSIGHUPによる再オープンをサポートしているわけではありません。
sudo tee /usr/local/libexec/lf-log29-writer.py > /dev/null <<'PY'
import os,signal,time
path='/var/log/lf-log29/app.log'
reopen=True
running=True
def hup(signum,frame):
global reopen
reopen=True
def stop(signum,frame):
global running
running=False
signal.signal(signal.SIGHUP,hup)
signal.signal(signal.SIGTERM,stop)
f=None
try:
for number in range(6000):
if not running: break
if reopen:
if f is not None: f.close()
f=open(path,'a',buffering=1)
reopen=False
print(f'<6>opened inode={os.fstat(f.fileno()).st_ino}',flush=True)
f.write(f'line={number:04d} sample log record\n')
time.sleep(.1)
finally:
if f is not None: f.close()
print('<6>writer stopped',flush=True)
PY
ファイルを準備する前に id lfstudent が成功することを確認してください。アカウントまたはインストール手順のいずれかが失敗した場合は停止してください。ユニットを保存した後、daemon-reloadおよびstartの前に sudo systemd-analyze verify /etc/systemd/system/lf-log29.service で確認してください。
以下のユニット全体を保存します。標準出力は開かれているファイルの inode を記録し、ファイルは番号付きのエントリをログに記録します。ファイルの再オープンは ExecReload を通して送信される HUP によって要求されます。サポートされていない実際のプログラムにそのまま適用すると終了する可能性があるため、プログラムのドキュメントを確認する必要があります。
sudo tee /etc/systemd/system/lf-log29.service > /dev/null <<'UNIT'
[Unit]
Description=LF log rotation lab 29
[Service]
Type=exec
User=lfstudent
Group=lfstudent
ExecStart=/usr/bin/python3 /usr/local/libexec/lf-log29-writer.py
ExecReload=/bin/kill -HUP $MAINPID
SyslogIdentifier=lf-log29
UNIT
sudo chmod 644 /usr/local/libexec/lf-log29-writer.py
sudo systemctl daemon-reload
sudo systemctl start lf-log29.service
sleep 1
sudo systemctl is-active lf-log29.service
sudo tail /var/log/lf-log29/app.log
sudo journalctl -b -u lf-log29.service -n 10 --no-pager
ファイル内では、line=0000 のような行がログレコードの増加を示し、ジャーナルではopened inode=番号が確認できます。実習中にプログラムが終了した場合は、ログとステータスを確認し、その後専用サービスのみを再起動してください。例の最大実行時間に達した場合の正常終了と権限エラーを区別してください。
独立したlogrotate設定を作り、デバッグで確認する
設定は /etc/logrotate.d ではなく、バックアップフォルダ内の独立したファイルとして配置されています。したがって、システムのデイリータイマーはこの例を自動的に処理せず、手動による確認のみが行われます。別の --state を使用しても、システムのデフォルト状態ファイルには触れません。
sudo tee /var/backups/lf-debian13-29/logrotate.conf > /dev/null <<'CONF'
/var/log/lf-log29/app.log {
size 100
rotate 2
compress
delaycompress
missingok
notifempty
create 0640 lfstudent lfstudent
sharedscripts
postrotate
/usr/bin/systemctl reload lf-log29.service
endscript
}
CONF
sudo chmod 600 /var/backups/lf-debian13-29/logrotate.conf
sudo logrotate --debug --state /var/backups/lf-debian13-29/logrotate.state /var/backups/lf-debian13-29/logrotate.conf
sudo ls -l /var/log/lf-log29
--debug は理由を表示しますが、ログや状態ファイルは変更しません。実行確認では、ハッシュを比較するために書き込み処理を一時停止し、ファイル内容、ローテートされたファイル、および別の状態ファイルが変更されないことを確認しました。読者はこの確認のために運用中のプロセスを停止する必要はありません。書き込み中のファイルのハッシュが変わったという事実は、debug がファイルを変更したことを意味しません。
| ディレクティブ | 意味と選択基準 |
|---|---|
| size 100 | これは100バイトを基準にした小さな練習用の制限です。正確にこのサイズでのリアルタイム回転監視機能ではありません。 |
| rotate 2 | 2つの回転されたバックアップを保持します。この設定は2日間を保証するものではありません。 |
| compress / delaycompress | 圧縮しますが、最新のアーカイブの圧縮は次の回転まで延期します。 |
| create 0640 | 新しいアクティブログの権限と所有権を指定します。 |
| postrotate | この例では、サービスがローテーション後に新しいファイルを開くように、reloadを要求します。 |
Debianのlogrotateマニュアル では、サポートされているオプションとデバッグ/ステートの挙動について説明しています。サイズや日次などの条件を組み合わせる場合は優先順序を確認してください。小さいサイズ閾値では、logrotateが1日に1回しか実行されない場合の呼び出し間での大きな成長を防ぐことはできません。
ローテーション、圧縮、およびファイル再オープンを確認する
以下は、専用の設定にのみ--forceを適用した最初のローテーションです。初期テスト時の条件を明確にするための強制実行であり、全体の本番構成には使用されません。
sudo logrotate --verbose --force --state /var/backups/lf-debian13-29/logrotate.state /var/backups/lf-debian13-29/logrotate.conf
sleep 1
sudo ls -li /var/log/lf-log29
sudo tail /var/log/lf-log29/app.log
sudo journalctl -b -u lf-log29.service -n 15 --no-pager
最初のローテーションの間、既存のファイルは app.log.1 になり、新しい app.log は異なる inode を持ちます。このプログラムは、HUP を受信した後、次の反復で新しいパスを開きます。その短い間に、以前のファイルに書き込まれた行は前のアーカイブに残る場合があります。重要なのは、その後のレコードが新しいアクティブファイルに引き続き書き込まれるかどうかです。検証では、/proc 内のオープンファイルディスクリプタの inode がアクティブファイルの inode と一致しているかどうかも比較しました。
以下のブロックを2回実行し、合計で3回のローテーションを行います。各ローテーション後に、内容がアクティブファイルに現れていることを確認するために少し待ちます。新しいファイルが空の場合、notifempty によりローテーションがスキップされることがあり、プログラムが終了している場合は postrotate のリロードが失敗する可能性があります。
sudo logrotate --verbose --force --state /var/backups/lf-debian13-29/logrotate.state /var/backups/lf-debian13-29/logrotate.conf
sleep 1
sudo ls -li /var/log/lf-log29
sudo gzip -t /var/log/lf-log29/app.log.2.gz
sudo gzip -cd /var/log/lf-log29/app.log.2.gz | head
| ローテーションの回数 | アクティブなログ | アーカイブ |
|---|---|---|
| 最初 | app.logへの書き込みを再開 | app.log.1、まだ圧縮されていない |
| 2番目 | 新しいapp.logに記録済み | app.log.1とapp.log.2.gz |
| 3番目 | 新しいapp.logに記録済み | バックアップを2つ保持し、最も古い最初のバックアップ内容を削除 |
実際の3回のローテーションでは、gzipのチェックが通過し、app.log.3.gzは残りませんでした。inode番号は再利用される可能性があるため、グローバルに増加することを期待しないでください。再オープンせずに単に名前を変更した場合、プロセスは前のinodeへの書き込みを続けることができます。copytruncateは、コピーとトランケートの間にレコードが失われる可能性があるため、すべてのプログラムに対する一般的な解決策としては使用されません。
クリーンアップ前にジャーナルのエクスポートとファイルログの保存を行う
調査用にログを保存する場合、フィルター、タイムゾーン、起動時の条件を一緒に記録してください。short-iso形式は人が読みやすく、export形式はジャーナルのフィールドをまとめて保持する用途に使えます。エクスポートファイルが作成されたという事実は、それがメインジャーナルに再登録されたことを意味するわけではありません。
sudo systemctl stop lf-log29.service
sudo journalctl --sync
sudo journalctl -b -u lf-log29.service -o short-iso --no-pager | sudo tee /var/backups/lf-debian13-29/service-journal.txt > /dev/null
sudo journalctl -b -u lf-log29.service -o export --no-pager | sudo tee /var/backups/lf-debian13-29/service-journal.export > /dev/null
sudo cp -a /var/log/lf-log29/app.log /var/log/lf-log29/app.log.1 /var/log/lf-log29/app.log.2.gz /var/backups/lf-debian13-29/
sudo ls -lh /var/backups/lf-debian13-29
実習では、ファイル再オープンの記録や正常終了メッセージがエクスポートされたジャーナルに含まれており、ファイルログや圧縮バックアップも別途コピーされていました。中間ローテーションによってスキップされたファイルがある場合は、実際のリストに従って保持し、コピー失敗を無視してバックアップを完了したとは見なさないでください。
保管ポリシーを確認し、実習環境を片付ける
journaldのストレージポリシーは、統合された設定を表示して次のように確認されます。Storage=autoは、永続的なジャーナルディレクトリの有無などに応じてストレージ方法を変更します。以前のブートを保持するために、本当に永続的に保存されているか、書き込み可能かも確認してください。
systemd-analyze cat-config systemd/journald.conf
sudo journalctl --disk-usage
systemctl cat logrotate.timer
systemctl list-timers logrotate.timer --no-pager
journald の SystemMaxUse と RuntimeMaxUse は、それぞれ永続ストレージとランタイムストレージの使用ポリシーを示し、MaxRetentionSec は古い記録の保持期間を制限する項目です。容量制限によりデータが早く削除される場合があるため、最小保持期間を保証するものではありません。Debian journald 保持設定マニュアル に基づき、ディスク容量の可用性、ログ生成量、および必要な保持期間について一緒に決定します。
実際にポリシーを変更する際は、既存の設定をバックアップし、/etc/systemd/journald.conf.d に自分で管理する別の .conf ファイル内に [Journal] セクションを指定してから、マージ結果を確認してください。適用するには sudo systemctl restart systemd-journald を実行し、サービスのステータスとログエラーを確認します。元に戻す場合は、作成したドロップインのみを削除して再度適用してください。保持ポリシーに従ってすでに削除されたログは、設定を元に戻しても復元されないため、必要な記録は事前に外部で保存してください。
この手順は、既存のjournald保持ポリシーを変更したり、vacuumを使用して運用ジャーナルを削除したりするものではありません。journalctlのvacuum機能は削除操作であり、アクティブなファイルを含む使用状況が即座に希望するレベルに下がることを保証するものではありません。容量不足でも、調査前にログを一括削除しないでください。
実習用サービスを停止し、コピーを確認した後、専用ファイルのみをクリーンアップします。/etc/logrotate.dに何も追加されていないため、システムタイマーの他のルールはそのまま有効です。
sudo rm -- /etc/systemd/system/lf-log29.service /usr/local/libexec/lf-log29-writer.py
sudo systemctl daemon-reload
sudo rm -- /var/log/lf-log29/app.log /var/log/lf-log29/app.log.1 /var/log/lf-log29/app.log.2.gz
sudo rmdir /var/log/lf-log29
検証の後、専用のサービスとログパスは削除され、証拠とともに設定ファイルおよび状態ファイルは /var/backups/lf-debian13-29 に保存されました。運用中の logrotate に追加されるのは、実際のサイズ、実行スケジュール、および再読み込みコマンドが適切なルールのみであり、この実習での 100 バイトおよび強制的なローテーションは運用上のデフォルトとして使用されません。




