cronジョブの出力を記録しないと何が起きるか
cronで定期実行したジョブが失敗しても、出力を記録していなければ気づくのが遅れます。デフォルトでは、コマンドが標準出力や標準エラー出力に何かを書き出したとき、cronデーモンはその内容をローカルメールとしてシステムユーザー宛に送信しようとします。しかし多くのサーバー環境ではMTAが設定されておらず、メールは届かないか、/var/spool/mail/ にひたすら溜まり続けるだけです。
障害を見逃さないためには、ジョブの出力をファイルにリダイレクトし、いつでも確認できる状態にしておくことが基本です。
標準出力をファイルに書き出す基本構文
cronエントリは crontab -e で編集します。コマンドの末尾に > /path/to/logfile を追加すると、標準出力をファイルに書き出せます。
# 毎日午前2時にスクリプトを実行し、出力をファイルに記録する
0 2 * * * /usr/local/bin/backup.sh > /var/log/backup.log 2>&1
2>&1 を末尾に付けると、標準エラー出力(ファイルディスクリプタ2)を標準出力(ファイルディスクリプタ1)と同じ先に書き出します。エラーメッセージも同じファイルにまとめて記録できるため、障害時に原因を追いやすくなります。
> は実行のたびにファイルを上書きします。最新の出力だけを残したい場合は > を、過去の出力を積み上げたい場合は >> を使います。
# 追記モード(過去のログを残す)
0 2 * * * /usr/local/bin/backup.sh >> /var/log/backup.log 2>&1
標準出力とエラーを別ファイルに分けて記録する
正常時の出力とエラーを混在させると、問題の箇所が分かりにくくなることがあります。ファイルを分けたい場合は次のように書きます。
# 標準出力とエラーを別ファイルに記録する
0 2 * * * /usr/local/bin/backup.sh >> /var/log/backup.log 2>> /var/log/backup_error.log
エラーログを監視ツールやアラート設定の対象にする場合は、ファイルを分けておくと連携しやすくなります。正常終了時に何も出力しない運用であれば、標準出力を /dev/null に捨て、エラーだけをファイルに残す構成も選択肢です。
# 正常出力は捨て、エラーだけ記録する
0 2 * * * /usr/local/bin/backup.sh > /dev/null 2>> /var/log/backup_error.log
ログが肥大化しないようにする
追記モードでログを書き続けると、ファイルが際限なく大きくなります。logrotate を使ってローテーションを設定しておくと管理しやすくなります。
/etc/logrotate.d/ に設定ファイルを作成します(ファイル名は任意です)。
/var/log/backup.log /var/log/backup_error.log {
daily
rotate 14
compress
missingok
notifempty
}
上の設定は、毎日ローテーションし14世代分を圧縮保存します。missingok はファイルが存在しない場合にエラーを出さないオプション、notifempty はファイルが空のときにローテーションをスキップするオプションです。設定後は次のコマンドで動作を確認できます。
sudo logrotate --debug /etc/logrotate.d/backup
--debug オプションを付けると実際にはファイルを操作せず、どのような処理が行われるかを表示します。
ログが正しく記録されているか確認する
cronエントリを設定したあと、次の手順で記録の状態を確認できます。まず crontab の内容を確認します。
crontab -l
次に、ジョブが実行されたかをシステムのcronログで確認します。ディストリビューションによってログの場所が異なります。
# systemd を使うディストリ(Ubuntu・Debian・RHEL 系など)
journalctl -u cron --since "1 hour ago"
# または
journalctl -u crond --since "1 hour ago"
# /var/log/syslog または /var/log/cron に記録される環境
grep CRON /var/log/syslog | tail -20
ジョブが実行された記録があれば、次に出力ファイルの内容を確認します。
tail -50 /var/log/backup.log
tail -50 /var/log/backup_error.log
エラーログが空であれば、直近の実行でエラーは発生していないと判断できます。
よくあるつまずきと対処法
ログファイルに何も書かれない
cronが実行するシェルはログインシェルではないため、~/.bashrc や ~/.bash_profile で設定した PATH が引き継がれません。スクリプト内でコマンドが見つからずに失敗しているケースが一般的に多く見られます。crontab の先頭に PATH を明示するか、スクリプト内でフルパスを指定すると解決します。
PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
0 2 * * * /usr/local/bin/backup.sh >> /var/log/backup.log 2>&1
出力先ディレクトリへの書き込み権限がない
cronジョブを実行するユーザーが、ログファイルの親ディレクトリに書き込み権限を持っていない場合、ファイルが作成されません。次のコマンドで権限を確認できます。
ls -ld /var/log/
/var/log/ への書き込みには root 権限が必要です。一般ユーザーの cronジョブであれば、ホームディレクトリ配下やそのユーザーが書き込めるディレクトリをログの出力先に指定してください。
ローカルメールが溜まり続ける
リダイレクト設定前に実行されたジョブのメールが /var/spool/mail/ユーザー名 に蓄積していることがあります。リダイレクト設定後は不要なメール送信を防ぐため、crontab に MAILTO="" を追記しておくと安心です。
MAILTO=""
0 2 * * * /usr/local/bin/backup.sh >> /var/log/backup.log 2>&1
「コマンドは打てる。次は”現場で通用する型”を最短で身につけたい」——そんなあなたへ。
ネットの断片的なTipsをコピペするだけでは、体系的な運用スキルはなかなか積み上がりません。リナックスマスター.JPの無料メルマガ「リナマガ」では、現場で実際に使うLinuxサーバー運用の考え方を、順を追って実務目線でお届けしています。いま登録された方には、安全なサーバー構築の「型」をまとめた『Linuxサーバー構築入門マニュアル(図解60P)』を完全無料でプレゼント中です。
>> 図解60P『Linux入門マニュアル』を無料で受け取る
(メルマガ登録は10秒・いつでも解除OK)
※ 「独学の時間がもったいない」「プロから現場の技術を最短で学びたい」という本気の方には、2日で実務レベルが身につく初心者向けハンズオンセミナーもご用意しています。
