cron 監視

cron モニターを使うと、バックアップ、バッチ処理、定期スクリプトなどのスケジュール実行のジョブを追跡し、予定どおりに実行されなかったときに通知を受け取れます。重要なバックグラウンド処理が常に想定どおり動いていることを確認できます。

他のモニターと同様に、cron ジョブが失敗したら、チームで協力してインシデントを解決し、必要に応じてステータスページを更新できます。

cron モニターの一覧は次のように表示されます。

cron モニターの一覧

主な機能

  • ジョブからの ping を使って、cron ジョブが予定どおり実行されたかを確認します。
  • ジョブが遅れている、または完了しないときにアラートを受け取れます。
  • Slack、メール、SMS、電話などと連携してアラートを送信します。

cron モニターをクリックすると、より詳しい情報を確認できます。

cron モニターの詳細

最初の cron モニターを追加する

モニターを追加するには、プロジェクト → モニター → モニターを追加 と進みます。

モニターを追加

モニターの種類

モニターの種類として cron / ハートビートを選びます。

cron のモニターの種類

専用の URL が生成されます。cron ジョブは実行のたびに、この URL へ HTTP リクエスト (HEADGETPOST) を送信してください。

モニターが成功と判定される条件

cron モニターは、ジョブが生成された URL にスケジュールどおり ping を送ったときに成功します。次の項目を設定できます。

  • 周期: ジョブを実行する頻度 (例: 15 分ごと)。
  • 猶予時間: ジョブが障害とみなされるまでに追加で許容する時間。

周期の時間が過ぎてもジョブから ping が届かない場合、モニターはパフォーマンス低下とマークされます。

猶予時間が過ぎてもジョブから ping が届かない場合、モニターは障害とマークされます。

ジョブが失敗、低下、復旧したときに通知を受け取るよう、アラートを設定できます。

失敗を明示的に通知する

ジョブが実行されてモニターに ping を送った場合でも、明示的に失敗としてマークしたいことがあります。
その場合は、モニターの URL の末尾に /fail を付けてリクエストを送信します。

スクリプトがエラーになったときに、Instatus へすぐに失敗として記録させたい場合に便利です。

  • 成功の ping: https://cron.instatus.com/your-unique-url
  • 失敗の ping: https://cron.instatus.com/your-unique-url/fail

失敗のシグナルを受け取ると、モニターは障害とマークされ、アラート設定に従ってすぐにアラートが送信されます。

ジョブの実行時間を計測する

2 つのリクエストを送ることで、ジョブの実行にかかった時間を計測できます。

  1. 開始のシグナル: ジョブの開始時に /start へリクエストを送ります
  2. 成功・失敗のシグナル: ジョブの完了時または失敗時にベース URL へリクエストを送ります
  • 開始の ping: https://cron.instatus.com/your-unique-url/start
  • 成功の ping: https://cron.instatus.com/your-unique-url
  • 失敗の ping: https://cron.instatus.com/your-unique-url/fail

開始のシグナルから成功のシグナルまでの時間が、ジョブの実行時間として記録されます。パフォーマンスを追跡し、想定より時間がかかっているジョブを見つけるのに役立ちます。

開始のシグナルを送った後にジョブが失敗した場合は、成功ではなく失敗のシグナルを送ると、実行時間を記録しつつ失敗としてマークできます。

おめでとうございます。最初の cron モニターを追加できました!