Configure Webhook Notifications

最終更新日:2025-07-15 11:20:05

Webhookコールバックを利用してカスタムURLでアラート通知を受信し、自動化された監視および対応ワークフローを構築できます。本ガイドでは、設定およびテスト手順をご案内します。

設定手順

1. アラートルールの作成

Webhook機能を利用するには、まず通知をトリガーするアラートルールを作成する必要があります。

  1. Cloud Monitor → Alert Service → Alert Rulesに移動します。
  2. アラートルール作成ボタンをクリックします。
  3. ルール名を設定し、アラート条件を定義します。
  4. 「通知方法」セクションで、Webhook Callbackオプションを選択してください。

2. Webhook URLを設定する

アラートルールの作成時に、Webhook callbackの送信先URLを指定する必要があります。

  1. 通知を受信したいURLを入力してください。このURLは外部からアクセス可能であり、サーバーがPOSTリクエストを処理するように設定されていることを確認してください。
  2. 変更内容を保存してください。

【产品维护】云安全产品维护公告

注意: Webhookエンドポイントは、Cloud MonitoringシステムからのPOSTリクエストを正しく解析し、応答できる必要があります。これにより通知の失敗を防止します。

Webhookコールバックのテスト

設定が正しいことを確認するために、テストを実施する必要があります。

  1. Webhook URL入力欄の横にあるテストボタンをクリックしてください。これによりアラートがシミュレートされ、テストペイロードがご指定のURLに送信されます。
  2. 監視システムからのテストペイロードがエンドポイントで正常に受信されていることを確認してください。

コールバックは、以下のパラメーターを含むJSON形式のPOSTリクエストとして送信されます。将来的に新しいフィールドが追加される可能性があるため、エンドポイントが追加パラメーターにも対応できるようご注意ください。

エンドポイントが受信するJSONペイロードの例を以下に示します。

{


"loginName": "user@example.com",


"alarmTime": "2025-07-09T15:22:00Z",


"ruleName": "高帯域幅アラート",


"monitor": "総帯域幅が100Gbpsを超過しました。"


}


パラメーター 説明
loginName string アラートルールに関連付けられているアカウント名です。
alarmTime string アラートが発生したタイムスタンプです。
ruleName string トリガーされたアラートルールの名称です。
monitor string アラートの内容または説明です。

テスト通知が受信できない場合は、ネットワーク接続とエンドポイントの構成をご確認いただき、正しく動作していることをご確認ください。

トラブルシューティング

通知が届かない場合は、以下の一般的な問題をご確認ください:

  • URLの誤り: WebhookのURLが正しく設定されており、外部からアクセス可能であることを確認してください。
  • POSTリクエストの処理: エンドポイントが正しく設定されており、POSTリクエストおよびJSONペイロードの解析に対応していることを確認してください。
  • ネットワーク接続: ファイアウォールのルールやネットワーク上の問題によって監視システムからの着信リクエストがブロックされていないか確認してください。

設定が完了すると、Webhook連携により自動的かつリアルタイムでイベント通知を受信できるようになります。これにより、カスタムロジックでアラートを解析して自動応答を実行し、インシデント管理の効率を大幅に向上させることが可能です。