您可以將 Webhook 設定為將警示通知傳送至遠端 Web 伺服器。Webhook 會透過 HTTP POST/PUT 提供通知。

必要條件

  • 確認您是以「超級管理員」使用者身分，或是以其相關聯角色具有相關權限的使用者身分，來登入 vRealize Log Insight Web 使用者介面。如需詳細資訊，請參閱建立和修改角色。Web 使用者介面的 URL 格式為 https://log-insight-host，其中 log-insight-host 是 vRealize Log Insight 虛擬應用裝置的 IP 位址或主機名稱。

  • 如果您要使用 vRealize Orchestrator (vRO) 端點來建立 Webhook，請確定已在 vRealize Orchestrator 中建立工作流程。如需詳細資訊，請參閱在 vRealize Orchestrator 用戶端中建立工作流程。

程序

  1. 展開主功能表，並導覽至警示 > Webhook。
  2. 按一下新增 Webhook。
  3. 在名稱文字方塊中，輸入 Webhook 的名稱。
  4. 輸入以下資訊。
    選項 說明
    端點 選取您要傳送通知的目的地端點，例如 Slack、Pager Duty、vRO 或自訂端點。根據選取的端點類型：
    • 使用者介面提供其他輸入選項。
    • 使用者介面會使用預先定義的範本填入 Webhook 裝載，您可以根據需求進行自訂。
    記錄裝載 選取針對與對應警示查詢相符的每個結果傳送一則 Webhook 通知，或針對所有相符結果傳送一則通知。
    • 若要針對每個相符結果傳送一則 Webhook 通知，請選取個別記錄。
      備註： 如果選取此選項，您最多可以傳送 10 則通知。
    • 若要針對所有相符結果傳送一則 Webhook 通知，請選取記錄資料流。
    Webhook URL 輸入您要張貼 Webhook 通知的遠端 Web 伺服器 URL。URL 格式會因您選擇的端點而異。文字方塊中提供了範例格式。
    備註： 在 vRO 端點 URL 中，必須包含您在 vRealize Orchestrator 中所建立之對應工作流程的識別碼。

    輸入 URL 後，按一下測試警示，以驗證連線。

    您可以輸入多個 Webhook URL，並以空格分隔。
    Web Proxy 如果您已設定一或多個 HTTP Proxy，請從下拉式功能表中選取一個 Proxy。vRealize Log Insight 透過選取的 Proxy 向端點傳送 Webhook 通知。
    整合金鑰 如果您選取 Pager Duty 端點，請輸入 Webhook 要求的整合金鑰。
    進階設定 如果您選取 vRO 或自訂端點，請輸入內容類型、授權等其他資訊。
    • 對於 vRO 端點，內容類型的預設值為 JSON。如有必要，您可以變更為 XML。將根據所選內容類型來產生 Webhook 裝載。
      請提供授權標頭，以授權 vRO 要求。一些授權選項包括：
      • 基本驗證 - 在第一個文字方塊中，保留預設值 Authorization。在第二個文字方塊中輸入一值，且格式為 Basic Base64_encoded_string_for_username_and_password。
      • 持有人 Token 驗證 - 在第一個文字方塊中，保留預設值 Authorization。在第二個文字方塊中輸入一值，且格式為 Bearer bearer_token。
    • 對於自訂端點，內容類型的預設值為 JSON，動作為 POST。您可以自訂這些選項，以及將其他標頭新增至自訂標頭下方的要求。如果已配置的遠端 Web 伺服器需要 POST/PUT Webbhook 通知的授權，請在授權使用者和授權密碼文字方塊中輸入要向伺服器驗證的使用者名稱和密碼。
    Webhook 裝載 此區域會根據您在端點下拉式功能表中的選取項目自動填入。您可以自訂裝載，這是作為 POST/PUT Webhook 通知要求一部分所傳送的本文範本。本文可以是 XML 或 JSON 格式。傳送 Webhook 通知時，會以實際值取代裝載中的參數。例如，以警示名稱取代 $(AlertName) 參數。
    備註： 對於 vRO 端點，參數應與 vRealize 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 通知。例如，在 vRO 中，Webhook 通知將列為工作流程執行。在各項工作流程執行中，您可以在 [變數] 區段中查看裝載參數的值。