カスタムウェブフック通知の設定

カスタムウェブフック通知を使用して、 IBM® NS1 Connect® からお好みの通知サービスへのアラートを構成できます。

アラートまたはモニタリング通知がトリガーされると、 NS1 Connect 、ウェブフック URL に詳細とともに POST リクエストを送信します。 次の例は、監視対象のエンドポイントがダウンしていることを示すために、カスタムの Webhook URL に送信される PING 監視アラートのリクエスト・ボディを示しています。

{
  "state": "down",
  "since": 1444744828,
  "region": "global",
  "job_document": {
    "notes": null,
    "name": "ping2",
    "notify_repeat": 0,
    "id": "561d0d482db1564c88776b57",
    "region_scope": "fixed",
    "rapid_recheck": false,
    "frequency": 60,
    "job_type": "ping",
    "notify_delay": 0,
    "notify_list": "560d7d249f782d4d663d7d3d",
    "notify_regional": false,
    "regions": [
      "lga"
    ],
    "policy": "quorum",
    "config": {
      "timeout": 2000,
      "host": "1.1.1.1",
      "count": 4
    },
    "status": {
      "global": {
        "since": 1444744580,
        "status": "up"
      },
      "lga": {
        "since": 1444744580,
        "status": "up"
      }
    },
    "notify_failback": true,
    "rules": [],
    "active": true
  }
}
 

監視対象のエンドポイントが再び利用可能になったと判断されると、別のアラートが送信されます。 例:

{
  "state": "up",
  "since": 1444745000,
...

準備

• 通知者リストの管理権限を有効にする必要があります。

説明

カスタムウェブフック通知機能を使用して通知者リストを作成したり、 既存のリストに追加したりすることができます。 新しい、または既存の通知リストにカスタムのウェブフック通知を追加する場合は、以下の手順を参照してください。

1. Notifier type ドロップダウンリストから、 Webhook を選択します。
2. Webhook URL に、 NS1 Connect が通知を送信するアプリケーションの Webhook URL を入力します。
3. 指定された URL への POST リクエストに含める HTTP ヘッダー(キーと値のペア)を追加するには、[ ヘッダーの追加 ]をクリックします。 各ヘッダーは一意のキーを使用しなければなりません。 ヘッダーは、 NS1 Connect からの通知を認証するために使用することができ、悪意のある行為者が偽の通知を偽装するのを防ぐことができる。 サポートされる HTTP ヘッダーとユースケースの詳細については、 RFC 9110を参照のこと。
4. 通知を作成をクリックします。