MENU

定期実行ジョブが動いていないときに設定と実行ログで原因を切り分ける手順

スクリプトを定期実行するように設定したはずなのに、処理が走っていない――そんなときは「サービスが起動しているか」「設定が正しいか」「実行された痕跡がログにあるか」の3点を順番に確かめると、原因を素早く絞り込めます。この記事では cron を中心に手順を整理し、systemd タイマーの場合の確認方法も補足します。

目次

まず cron サービスの稼働状態を確かめる

設定より先に、ジョブを実行するサービス自体が起動しているかを確認します。サービスが止まっていればどの設定も動きません。

systemctl status cron    # Debian・Ubuntu 系
systemctl status crond   # RHEL・Rocky・AlmaLinux 系

Active: inactive (dead) と表示されている場合は cron が停止しています。次のコマンドで起動と自動起動の有効化を同時に行えます。

sudo systemctl enable --now cron    # Debian・Ubuntu 系
sudo systemctl enable --now crond   # RHEL 系

サービスが起動していることを確認したら、次は設定内容の確認に進みます。

crontab の設定内容を確認する

現在のユーザーの crontab は次のコマンドで確認できます。

crontab -l

root として登録したジョブを確認する場合は sudo crontab -l を使います。システム全体の定期実行設定は /etc/crontab と /etc/cron.d/ 以下のファイルにも存在します。

cat /etc/crontab
ls -la /etc/cron.d/
cat /etc/cron.d/任意のファイル名

設定を読むときに確認したいのは次の3点です。

  • 時刻の指定が正しいか(分・時・日・月・曜日の順)
  • 実行ユーザーが正しいか(/etc/crontab と /etc/cron.d/ のエントリにはユーザー名フィールドがある)
  • コマンドやスクリプトのパスが絶対パスになっているか

cron が実行するシェルはデフォルトで /bin/sh であり、ログインシェルが読み込む ~/.bashrc や ~/.bash_profile の設定は適用されません。python3 や node など PATH が通っていないと動かないケースがよくあります。crontab の先頭で PATH を明示するか、コマンドを絶対パスで書くと問題を回避できます。

PATH=/usr/local/bin:/usr/bin:/bin
5 3 * * * /home/deploy/scripts/backup.sh

ログで実行状況を追う

設定に問題がなさそうでもジョブが動いていない場合、ログに手がかりがあります。systemd ジャーナルから cron のログを確認するには次のようにします。

journalctl -u cron --since "1 hour ago"
# RHEL 系の場合
journalctl -u crond --since "1 hour ago"

伝統的な syslog が有効な環境では /var/log/syslog(Debian 系)や /var/log/cron(RHEL 系)にも記録があります。

grep CRON /var/log/syslog | tail -20
grep cron /var/log/cron | tail -20

ログにジョブの実行記録がまったくない場合は、スケジュールの時刻がまだ来ていないか、設定ファイルの構文エラーでジョブ全体が無効になっている可能性があります。構文エラーがあると cron がそのファイルを読み飛ばすため、crontab -e で保存した際に表示された警告メッセージも確認しておきましょう。

「実行の記録はあるが処理が完了していない」場合は、スクリプト自体のエラーが原因である可能性があります。cron はジョブの標準出力・標準エラー出力をメールで送る仕組みになっており、MTA が設定されていない環境では出力が捨てられます。次のようにログファイルへリダイレクトを追加すると、スクリプトのエラー内容を確認できます。

5 3 * * * /home/deploy/scripts/backup.sh >> /var/log/backup.log 2>&1

systemd タイマーを使っている場合の確認手順

最近のディストリビューションでは、cron の代わりに systemd タイマーで定期実行を管理しているケースもあります。タイマーの一覧と次回・前回の実行時刻は次のコマンドで一覧できます。

systemctl list-timers --all

NEXT 列が空欄になっていたり、LAST 列が想定より古い日時になっているタイマーがあれば、対応するサービスに問題がある可能性があります。たとえばタイマー名が backup.timer なら、実行ログは次のように確認できます。

systemctl status backup.timer
systemctl status backup.service
journalctl -u backup.service --since "24 hours ago"

systemd タイマーは .timer ファイルと .service ファイルが対になる構成です。タイマーが有効でもサービスが無効化されていると実行されないため、両方の状態を確認する習慣をつけておくと切り分けがスムーズです。

よくあるつまずきと対処

設定とログを確認しても原因が見つからないとき、一般的に引っかかりやすいポイントをまとめます。

  • スクリプトに実行権限がない:ls -l /path/to/script.sh でパーミッションを確認し、chmod +x で実行権限を付与します。
  • スクリプト内で相対パスを使っている:cron の作業ディレクトリはユーザーの HOME になるため、スクリプト内のファイル参照も絶対パスで書くと安全です。
  • シェルの違いによるエラー:bash 固有の構文(配列・[[ ]] など)を使っている場合、スクリプト先頭のシェバン行(#!/bin/bash)を明記します。
  • /etc/cron.d/ のファイルのパーミッション:cron はワールドライタブル(書き込み権限が全員にある)なファイルをセキュリティ上の理由で無視します。chmod 644 になっているかを確認してください。
  • MAILTO=”” でエラーが見えない:crontab に MAILTO="" と設定されていると、ジョブの出力やエラーがどこにも届きません。デバッグ中は MAILTO 行を削除するか、前述のようにスクリプトの出力をファイルへリダイレクトします。
  • 時刻のタイムゾーンがずれている:サーバーのシステムタイムゾーンと期待する実行時刻が合っていないケースもあります。timedatectl でタイムゾーンを確認しておきましょう。

サービスの稼働確認 → 設定の読み合わせ → ログの照合 → スクリプト自体のデバッグ、という順で進めることで、ほとんどのケースで原因にたどり着けます。ログが十分でない環境では、まずリダイレクトでスクリプトの出力を記録できる状態にしてから再度スケジュールを待つのが確実な方法です。

「コマンドは打てる。次は”現場で通用する型”を最短で身につけたい」——そんなあなたへ。

ネットの断片的なTipsをコピペするだけでは、体系的な運用スキルはなかなか積み上がりません。リナックスマスター.JPの無料メルマガ「リナマガ」では、現場で実際に使うLinuxサーバー運用の考え方を、順を追って実務目線でお届けしています。いま登録された方には、安全なサーバー構築の「型」をまとめた『Linuxサーバー構築入門マニュアル(図解60P)』を完全無料でプレゼント中です。

>> 図解60P『Linux入門マニュアル』を無料で受け取る
(メルマガ登録は10秒・いつでも解除OK)

※ 「独学の時間がもったいない」「プロから現場の技術を最短で学びたい」という本気の方には、2日で実務レベルが身につく初心者向けハンズオンセミナーもご用意しています。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

この記事を書いた人

目次