通知やアラートの方法
障害は適切な人が知ることで初めて価値があります。チームがすでに確認している場所や、人が最初に対応すべきでない場合にはあなたのシステムに通知します。
チャンネル
すべてのチャンネルに同じメッセージが送信されます:どのモニターが、いつから、なぜ。各チャンネルは一度アドレスを追加し、ルールで名前を付けます。
-
Email すべてのプラン
任意のアドレスにメッセージを送信しますが、送信前に一度確認を行うため、アラートが他人の受信箱に送られることはありません。
-
Webhook (POST) すべてのプラン
以下のすべてのフィールドを含むJSONボディをあなたのURLに送信します。自動化のために:チケットを開く、ローテーションを通知する、ステータスライトを切り替える。
-
Webhook (GET) すべてのプラン
GETしか受け付けない受信者向けに、クエリパラメータとして同じフィールドを送信します。
-
PagerDuty スタータープラン以上
Events API v2を通じて障害が発生するとインシデントが作成され、復旧時に解決されます。その後はPagerDutyのエスカレーションが処理します。遅延や損失のあるチェックは警告として通知され、クリティカルではありません。
-
Slack プロプランおよびビジネスプラン
チャンネルにメッセージを送信します。ダウン時は赤、復旧時は緑で、Webhookを通じて通知されます。
-
Microsoft Teams プロプランおよびビジネスプラン
同じメッセージをTeamsチャンネルにWebhookを通じて送信します。
-
Discord プロプランおよびビジネスプラン
同じメッセージをDiscordチャンネルにチャンネルWebhookを通じて送信します。
-
Telegram プロプランおよびビジネスプラン
同じメッセージをチャットに、あなた自身のボットを通じて送信します。
誰が何をいつ知るか
最初に確認済み
1つのプローブの結果だけでは何も送信されません。2つの他の大陸のプローブが同意した場合に障害と見なされるため、アラートはサイトがダウンしていることを意味し、中間のネットワークの問題ではありません。
ルールとエスカレーション
ルールは、誰がどのモニターについて、障害発生後どのくらいの時間で通知を受けるかを指定します。オンコールのローテーションを連絡先グループに設定し、メンバーごとに遅延を設定することで、1つのルールがエスカレーションとなり、モニターが復旧した瞬間に停止します。
復旧時に1回通知
障害について通知を受けた全員に、終了時とその継続時間が通知されます。障害が終了したことを伝えるために起こすことはありません。
必要になる前にテスト
すべてのアドレスにはボタンがあり、実際のアラートと同じ経路でテストを送信します。本物の障害と間違えられないように文言が設定されています。
Webhook:あなたのシステム用
Webhookアドレスはお客様のURLです。障害が確認されたとき、復旧したとき、またはテストボタンを押したときに呼び出します。POSTはフィールドをJSONボディとして送信し、GETはクエリパラメータとして送信します。このURLは暗号化されて保存され、再度完全には表示されません。URLを持つ人はそれにPOSTできるためです。
| フィールド | 内容 |
|---|---|
| reason | 障害が確認されたときはdown、終了時はrecovery、ボタンが押されたときはtest |
| monitor | モニターの名前 |
| monitor_id | そのID(ダッシュボードのアドレスにあるものと同じ) |
| target | チェック対象:URL、ホストまたは名前 |
| type | チェックの種類(https、dns、ssl_certなどの短い名前) |
| cause | 失敗理由(判明している場合は簡潔に) |
| error_class | プログラムが分岐できる短い名前(timeout、connection、certificate_expiredなど) |
| started | 障害が開始した時刻(タイムゾーン付き) |
| confirmed_at | 障害が確認された時刻 |
| confirmed_from | 確認した大陸(名前のリスト)。2026年9月までは単一の名前でした。 |
| degraded | モニターがダウンではなく遅延またはパケットロスしている場合はtrue |
| resolved | 復旧時の終了時刻(ISO 8601タイムスタンプ) |
| duration | 復旧時の継続時間(言葉で表記) |
| incident_id | インシデントのID(障害と復旧で同じ) |
内容がないフィールドはJSONではnullとなり、GETでは省略されます。400未満のステータスで応答してください。それ以外は配信失敗と見なされ、30秒後、2分後、10分後に再試行されます。その後は中止されます。15分以内に届かなかったアラートは過去の情報であり、ニュースではありません。