ヘルプ 管理 サードパーティ連携 Webhook連携

Webhook連携

Webhookを利用すると、Site24x7のイベント データを、複数のアプリケーションに接続できます。Webhookは、イベントベースの出力メカニズムです。Site24x7が作成したイベントで、Webhookのトリガーがかかり、そこから、HTTP要求でHook URLのシグナルを送ります。Site24x7でイベントが発生すると、イベント データを指定のHook URLに投稿します。これによって、Site24x7アラームや、サードパーティのアプリケーションのインシデントやメッセージを、効率的に管理することが可能となります。さらに、 オンプレミス ポーラーのWebhook連携対応により、内部アプリケーションにイベント情報を投稿することもできます。

もくじ

WebhhookによるSite24x7とサード パーティ アプリケーションの連携

Webhook連携には、希望のサードパーティ サービスのHook URLが必要です。Hook URLを入手したら、次の手順でWebhookを利用し、Site24x7のイベント データを、あらゆるサードパーティ アプリケーションと連携できます。

  1. Site24x7アカウントにログインします。
  2. 管理 > サードパーティ連携と移動してください。
  3. サードパーティ連携の追加ボタンをクリックしてください。Webhookを選択。
    Webhook
  4. Webhook連携フォームを埋め、連携プロセスを完了させてください。
    • 連携名：連携に名前をつけてください。
    • Hook URL：Site24x7のデータ送信先を示す、完全なURLです（http/httpsを含みます）。
    • アクセス方法：Hook URLを、Site24x7のグローバルなサーバー拠点から実行するか、オンプレミス ポーラーでネットワーク内部から実行するかを、指定します。
      • グローバル設定：Site24x7中央サーバーからHook URLを実行し、連携を実行します。
      • 内部設定：連携の実行には、オンプレミス ポーラーが必要です。セットアップが終わると、中央サーバーはオンプレミス ポーラーに通知を行い、Hook URLによる連携完成を実行させます。
        オンプレミス ポーラーの設定は、この説明にしたがってください。
    • HTTPメソッド：URLへの接続につかうメソッドを、get、post、put、delete、patchより指定します。ラジオボタンを選択し、フォーム送信メソッド、および、post、put、delete、patchメソッドのbodyタイプを設定してください。
      • JSONでpost：送信コンテンツをJSON要求bodyに入力してください。Content-Typeヘッダーは自動的に決まります。
      • インシデント パラメーター送信：URL自体に含まれるコードを記述し、変数を、インシデント パラメーターで渡します。HTTPメソッドの要求パラメーターは、param name=value pair形式で指定してください。詳細は、 インシデント パラメーターを参照ください。
        incident-parameters-json
      • カスタム パラメーターの送信：独自のカスタム パラメーターを定義し、要求をJSON形式でpostできます。
    • HTTP要求ヘッダー：デフォルトのHTTP要求ヘッダーを編集する場合は、ヘッダー名とヘッダー値を、ここで追加します。
    • ユーザー エージェント：ブラウザーのカスタム ユーザー エージェントを設定し、要求とHTTPヘッダーの送出に利用します。利用できるUAからの選択が可能です。
    • 認証方法：ラジオボタンを指定し、それにあわせて認証情報を更新してください。
      • Basic/NTLM認証情報：Basic/NTLMベース認証を設定します。Windows NTLMは、Windows OS上のシステムで利用できる認証プロトコルです。
        認証情報：Basic/NTLMベース認証で必要となるユーザー名とパスワードを指定してください。
      • OAuth：OAuthフレームワークによるセキュリティを施したリソースを監視する場合は、OAuthラジオボタンを選択してください。
        プロバイダー名 ：OAuthサービス プロバイダー名を設定リストから選ぶか、新しくOAuthプロファイルを作成してください。 （＋）ボタンをクリックし、
        手順はOAuthサービス プロバイダーの設定を参照ください。
    • タイムアウト：対象URLが反応しないと判断するまで、Site24x7サーバーが待機する時間を入力します（秒）。サーバーの応答時間として、通常を超えたものを指定ください。値は1から45秒の間で指定します。
    • 連携レベル：希望の連携レベルを選び、関連Webhookへ、1つの監視から特定イベントを送出するか、Site24x7アカウントからすべてのアラームを送出。
      複数の監視をえらび、そのうち1つの監視のみから、イベントを優先サードパーティ サービスに送出。
      すべての監視をえらび、Site24x7の全インシデントを、希望のサードパーティ サービスに送出。
  5. 保存をクリックし、設定手順を完了してください。
    設定手順が完了すると、Webhook連携がサードパーティ連携ダッシュボードに表示されます。Site24x7アカウントには、このように、複数のWebhookを設定できます。

Webhook連携の停止・起動・削除

アクティブなWebhook連携を停止する際は、次の手順にしたがいます。

  1. Site24x7にログインします。
  2. 管理 > サードパーティ連携 と移動。
    連携はすべて、ここ、サードパーティ連携ダッシュボードに表示されます。サードパーティ連携ダッシュボード.
  3. 停止するWebhook連携をクリック。
  4. 連携ウィンドウの右上コーナーにある停止ボタンをクリックしてください。
    停止中のWebhook連携を再起動するには、上述と同じ手順にしたがってください。続いて、アクティブにするボタンを、連携ウィンドウの右上コーナーからクリック。再起動をすると、Site24x7サーバーは、イベント データを対象アプリケーションに送信し始めます。
    Webhook連携を削除するには、上述と同じ手順にしたがってください。続いて、連携ウィンドウ右上コーナーに表示の削除ボタンをクリック。削除すると、Webhook連携は永久に停止します。