Heartbeat モニター

Cron ジョブやバッチ処理など、定期的に実行されるプロセスの監視に使用します。Manako が発行したエンドポイントに対して定期的に ping が届くかどうかで死活を判定します。

仕組み

1. Manako が Heartbeat モニター用のエンドポイント URL を発行します
2. 監視対象のジョブが実行完了時にその URL へ HTTP リクエスト(ping)を送信します
3. 設定した猶予期間内に ping が届かなければ、ダウンとして検知します

設定項目

項目	説明	必須	デフォルト
猶予期間	ping が届かなかった場合にダウンとみなすまでの待ち時間	いいえ	300 秒(5 分)

猶予期間は 60 秒から 86,400 秒(24 時間)の範囲で設定できます。監視間隔よりも少し長めに設定するのがおすすめです。

設定例

curl

# ジョブの最後に ping を送信
curl -s https://hb.manako.dev/ping/{token}

crontab

# 毎時実行のバッチ + Heartbeat ping
0 * * * * /path/to/job.sh && curl -s https://hb.manako.dev/ping/{token}

Docker

# Dockerfile の HEALTHCHECK で Heartbeat ping
HEALTHCHECK --interval=5m CMD curl -sf https://hb.manako.dev/ping/{token} || exit 1

ヒント

&& でコマンドを連結すると、ジョブが成功した場合のみ ping が送信されます。ジョブが失敗した場合は ping が送信されず、猶予期間経過後にダウンとして検知されます。

インシデント判定

設定した猶予期間内に ping が届かなかった場合にダウンとして検知します。ping を受信すると自動的に復旧します。