リモート Web サーバにアラート通知を送信するように Webhook を構成できます。Webhook は、HTTP POST/PUT 経由で通知を行います。

前提条件

  • スーパー管理者ユーザー、または関連する権限を持つロールに関連付けられたユーザーとして VMware Aria Operations for Logs の Web ユーザー インターフェイスにログインしていることを確認します。詳細については、ロールの作成と変更を参照してください。

  • Webhook を VMware Aria Automation Orchestrator エンドポイントによって作成する場合は、ワークフローを VMware Aria Automation Orchestrator で作成しておいてください。詳細については、VMware Aria Automation Orchestrator クライアントでのワークフローの作成を参照してください。

手順

  1. メイン メニューを展開し、[構成] > [Webhook] に移動します。
  2. [新しい Webhook] をクリックします。
  3. [名前] テキスト ボックスに、Webhook の名前を入力します。
  4. 次の情報を入力します。
    オプション 説明
    エンドポイント 通知の送信先にするエンドポイント タイプを次から選択します。
    • Slack
    • Pager Duty
    • Orchestrator
    • カスタム

    選択したエンドポイント タイプに応じて、ユーザー インターフェイスに追加の入力オプションが表示されます。

    また、ユーザー インターフェイスでは Webhook ペイロードに事前定義されたテンプレートが入力されます。このテンプレートは要件に合わせてカスタマイズできます。
    ログ ペイロード 対応するアラート クエリに一致する結果ごとに Webhook 通知を送信するか、一致するすべての結果に対して 1 つの Webhook 通知を送信するかを選択します。
    • 一致するすべての結果に対して 1 つの Webhook 通知を送信するには、[ログ ストリーム] を選択します。
    • 一致する結果ごとに Webhook 通知を送信するには、[個々のログ] を選択します。
    Webhook URL Webhook 通知をポストするリモート Web サーバの URL を入力します。URL 形式は、エンドポイントの選択に基づいて変わります。サンプルの形式が、テキスト ボックスに表示されます。
    注： VMware Aria Automation Orchestrator エンドポイント URL には、 VMware Aria Automation Orchestrator で作成された対応するワークフローの ID を含める必要があります。

    URL を入力した後、[テスト アラート] をクリックして接続を確認します。

    複数の Webhook URL を空白のスペースで区切って入力できます。
    Web プロキシ 1 つ以上の HTTP プロキシを構成している場合は、ドロップダウン メニューからプロキシを選択します。VMware Aria Operations for Logs は、選択したプロキシを介して Webhook 通知をエンドポイントに送信します。
    統合キー [Pager Duty] をエンドポイント タイプに選択する場合は、Webhook 要求用の統合キーを入力します。
    詳細設定 [Orchestrator] または [カスタム] をエンドポイント タイプに選択する場合は、さらに情報を指定する必要があります。

    [Orchestrator] エンドポイント タイプでは、次のことができます。

    • VMware Aria Automation Orchestrator 要求を認証するための [カスタム ヘッダー] の名前と値の入力。認証オプションには、次のようなものがあります。
      • 基本認証 - 最初のテキスト ボックスで、デフォルト値 認証 を保持します。2 番目のテキスト ボックスに、「Basic Base64_encoded_string_for_username_and_password」の形式で値を入力します。
      • ベアラー トークン認証 - 最初のテキスト ボックスで、デフォルト値 Authorization を保持します。2 番目のテキスト ボックスに、「Bearer bearer_token」の形式で値を入力します。
    • コンテンツ タイプの選択。[コンテンツ タイプ] のデフォルト値は、[JSON] です。必要に応じて、[XML] に変更できます。Webhook ペイロードは、選択したコンテンツ タイプに応じて生成されます。

    [カスタム] エンドポイント タイプでは、次のことができます。

    • [アクション]（POST や PUT など）の選択。デフォルトのアクションは、POST です。
    • [基本認証を追加する] チェック ボックスの選択、認証情報をサーバで認証するためのユーザー名とパスワードの入力。
    • [カスタム ヘッダー] で要求にヘッダーを追加することによる追加情報（ある場合）の入力。
    Webhook ペイロード

    この領域には [エンドポイント タイプ] ドロップダウン メニューでの選択に基づいて自動的に入力されます。Webhook 通知の POST/PUT 要求の一部として送信される本文のテンプレートであるペイロードをカスタマイズできます。本文は XML または JSON 形式にすることができます。

    Webhook 通知の送信中、ペイロードのパラメータは実際の値に置き換えられます。たとえば、パラメータ $(AlertName) はアラートの名前に置き換えられます。

    注： [Orchestrator] エンドポイント タイプの場合、パラメータは、 VMware Aria Automation Orchestrator で作成された対応するワークフローの入力パラメータまたは出力パラメータと一致する必要があります。
    パラメータ 次のリストのパラメータを使用して、Webhook ペイロードを作成または変更します。
    • AlertName
    • AlertNameString
    • AlertType
    • AlertTypeString
    • SearchPeriod
    • SearchPeriodString
    • HitOperator
    • HitOperatorString
    • messages
    • messagesString
    • HasMoreResults
    • HasMoreResultsString
    • Url
    • UrlString
    • EditUrl
    • EditUrlString
    • Info
    • InfoString
    • Recommendation
    • RecommendationString
    • NumHits
    • NumHitsString
    • TriggeredAt
    • TriggeredAtString
    • SourceInfo
    • SourceInfoString
    注： messagesString を除き、他のすべての文字列パラメータ タイプの内容は同じです。
  5. [保存] をクリックします。
    Webhook が作成されました。Webhook 名の前にある [使用可能なアクション] アイコンをクリックすると、その Webhook を表示、編集、または削除できます。

次のタスク

選択したエンドポイントに Webhook 通知を送信するアラートを構成します。詳細については、Webhook 通知を送信するためのアラートの追加を参照してください。

アラートを構成した後、エンドポイントで Webhook 通知を表示できます。たとえば、VMware Aria Automation Orchestrator では、ワークフローが実行されると Webhook 通知が表示されます。各ワークフローの実行では、ペイロード パラメータの値が変数セクションに表示されます。