操作說明：使用勾點設定警示並取得通知

  • 發行項

重要

從 2023 年 9 月 20 日起，您將無法建立新的 Metrics Advisor 資源。 Metrics Advisor 服務將于 2026 年 10 月 1 日淘汰。

在 Metrics Advisor 偵測到異常之後，系統會使用勾點，根據警示設定觸發警示通知。 警示設定可以搭配多個偵測組態使用，各種參數可用來自訂警示規則。

建立勾點

Metrics Advisor 支援四種不同類型的攔截：電子郵件、Teams、Webhook 和 Azure DevOps。 您可以選擇適用于特定案例的案例。

電子郵件勾點

注意

Metrics Advisor 資源管理員必須設定電子郵件設定，並將 SMTP 相關資訊 輸入 Metrics Advisor，才能傳送異常警示。 資源群組管理員或訂用帳戶管理員必須在 Metrics Advisor 資源的 [存取控制] 索引標籤中，至少指派一個 認知服務 Metrics Advisor 管理員istrator 角色。 深入瞭解電子郵件設定組態 。

電子郵件攔截是將異常警示傳送至 [電子郵件到 ] 區段中所指定 電子郵件地址的通道。 系統會傳送兩種類型的警示電子郵件： 資料摘要無法使用 警示，以及 包含一或多個異常的附隨報告 。

若要建立電子郵件勾點，可以使用下列參數：

參數 描述:
Name 電子郵件勾點的名稱
電子郵件至 要傳送警示的電子郵件地址
外部連結 選擇性欄位，可啟用自訂的重新導向，例如疑難排解附注。
自訂異常警示標題 標題範本支援 ${severity} 、 ${alertSettingName} 、、 ${metricName}${datafeedName}${timestamp}${detectConfigName} 、、 ${incidentCount}${topDimension}${anomalyCount}

選取 [ 確定 ] 之後，將會建立電子郵件勾點。 您可以在任何警示設定中使用它來接收異常警示。 如需詳細步驟， 請參閱 Metrics Advisor 中啟用異常通知的教學課程。

Teams 勾點

Teams 勾點是將異常警示傳送至 Microsoft Teams 中頻道的通道。 Teams 攔截是透過「傳入 Webhook」連接器來實作。 您可能需要在目標 Teams 頻道中預先建立「傳入 Webhook」連接器，並取得其 URL。 然後，重新移至您的 Metrics Advisor 工作區。

選取左側導覽列中的 [勾點] 索引標籤，然後選取頁面右上方的 [建立勾點] 按鈕。 選擇 「Teams」 的勾點類型，提供下列參數：

參數 描述:
Name Teams 勾點的名稱
連線or URL 剛從目標 Teams 頻道中建立的「傳入 Webhook」連接器複製的 URL。

選取 [ 確定 ] 之後，將會建立 Teams 勾點。 您可以在任何警示設定中使用，將異常警示通知至目標 Teams 頻道。 如需詳細步驟， 請參閱 Metrics Advisor 中啟用異常通知的教學課程。

Web 勾點

Web 攔截是另一個通知通道，方法是使用客戶提供的端點。 在時間序列上偵測到的任何異常都會透過 Web 攔截收到通知。 有數個步驟可在 Metrics Advisor 中啟用 Web 攔截作為警示通知通道。

步驟 1。 在 Metrics Advisor 資源中啟用受控識別

系統指派的受控識別限制為每個資源一個，並系結至此資源的生命週期。 您可以使用 Azure 角色型存取控制 （Azure RBAC） 將許可權授與受控識別。 受控識別會使用 Microsoft Entra ID 進行驗證，因此您不需要將任何認證儲存在程式碼中。

移至 Azure 入口網站 中的 Metrics Advisor 資源，然後選取 [身分識別]，將其開啟為 [開啟]，然後啟用受控識別。

步驟 2。 在 Metrics Advisor 工作區中建立 Web 攔截

登入您的工作區，然後選取 [勾點] 索引標籤，然後選取 [建立勾點] 按鈕。

若要建立 Web 攔截，您必須新增下列資訊：

參數 描述
端點 觸發警示時要呼叫的 API 位址。 必須是 Https 。
使用者名稱/密碼 用於向 API 位址進行驗證。 如果不需要驗證，請保留此黑色。
標題 API 呼叫中的自訂標頭。
Azure Key Vault 中的憑證識別碼 如果存取端點需要透過憑證進行驗證，憑證應該儲存在 Azure 金鑰保存庫中。 在這裡輸入識別碼。

注意

建立或修改 Web 攔截時，端點會以具有空白要求主體 的測試的形式 呼叫。 您的 API 必須傳回 200 HTTP 程式碼，才能順利通過驗證。

web hook creation window.

  • 要求方法是 POST
  • 逾時 30 秒
  • 重試 5xx 錯誤，忽略其他錯誤。 不會遵循 301/302 重新導向要求。
  • 要求本文：
{
"value": [{
	"hookId": "b0f27e91-28cf-4aa2-aa66-ac0275df14dd",
	"alertType": "Anomaly",
	"alertInfo": {
		"anomalyAlertingConfigurationId": "1bc6052e-9a2a-430b-9cbd-80cd07a78c64",
		"alertId": "172536dbc00",
		"timestamp": "2020-05-27T00:00:00Z",
		"createdTime": "2020-05-29T10:04:45.590Z",
		"modifiedTime": "2020-05-29T10:04:45.590Z"
	},
	"callBackUrl": "https://kensho2-api.azurewebsites.net/alert/anomaly/configurations/1bc6052e-9a2a-430b-9cbd-80cd07a78c64/alerts/172536dbc00/incidents"
}]
}

步驟 3. (選用) 將憑證儲存在 Azure 金鑰保存庫中並取得識別碼：如前所述，如果端點的存取需要利用憑證來進行驗證，則該憑證應儲存在 Azure 金鑰保存庫中。

  • 使用 Azure 入口網站 檢查 從 Azure 金鑰保存庫設定及擷取憑證
  • 選取您新增的憑證，然後您就可以複製「憑證識別碼」。
  • 然後選取 [存取原則] 和 [新增存取原則]，並授與 [金鑰許可權]、[秘密許可權] 和 [憑證許可權] 的 [取得] 許可權。 選取主體作為 Metrics Advisor 資源的名稱。 在 [存取原則] 頁面中選取 [新增] 和 [儲存] 按鈕。

步驟 4。 在透過 Web 攔截推送通知時，您可以呼叫 Webhook 要求中的 「callBackUrl」 來擷取事件資料。 此 API 的詳細資料：

藉由使用 Web 攔截和 Azure Logic Apps，可以傳送電子郵件通知 ，而未設定 SMTP 伺服器。 如需詳細步驟， 請參閱 Metrics Advisor 中啟用異常通知的教學課程。

Azure DevOps

Metrics Advisor 也支援在 Azure DevOps 中自動建立工作專案，以追蹤偵測到任何異常時的問題/錯誤。 所有警示都可以透過 Azure DevOps 攔截傳送。

若要建立 Azure DevOps 勾點，您必須新增下列資訊

參數 描述:
Name 勾點的名稱
Organization DevOps 所屬的組織
Project DevOps 中的特定專案。
存取權杖 用於向 DevOps 進行驗證的權杖。

注意

如果您想要 Metrics Advisor 根據異常警示建立工作專案，您必須授與寫入權限。 建立勾點之後，您可以在任何警示設定中使用它們。 在 勾點設定 頁面中管理您的勾點。

新增或編輯警示設定

移至 [計量詳細資料] 頁面，以尋找 [計量詳細資料] 頁面左下角的 [警示設定 ] 區段。 它會列出套用至所選偵測組態的所有警示設定。 建立新的偵測組態時，沒有警示設定，也不會傳送警示。
您可以使用 新增 、 編輯 和 刪除 圖示來修改警示設定。

Alert settings menu item.

選取 [ 新增 ] 或 [編輯 ] 按鈕，以取得視窗以新增或編輯您的警示設定。

Add or edit alert settings

警示設定名稱 ：警示設定的名稱。 其會顯示在警示電子郵件標題中。

勾點 ：要傳送警示的勾點清單。

上述螢幕擷取畫面中標示的區段是一個偵測組態的設定。 您可以針對不同的偵測組態設定不同的警示設定。 使用此視窗中的第三個下拉式清單選擇目標群組態。

篩選設定

以下是一個偵測組態的篩選設定。

[警示] 有四個選項可用來篩選異常：

  • 所有系列的 異常：警示中將會包含所有異常。
  • 數列群組 中的異常狀況：依維度值篩選數列。 設定某些維度的特定值。 只有在數列符合指定值時，才會將異常包含在警示中。
  • 我的最愛系列異常：只有標示為我的最愛的系列 才會包含在警示中。 |
  • 所有數列 前 N 名中的異常狀況：此篩選適用于您只關心值在前 N 名的數列。Metrics Advisor 會回顧先前的時間戳記，並檢查這些時間戳記的數列值是否在前 N 名。如果 「in top n」 計數大於指定的數位，則異常將會包含在警示中。 |

篩選異常選項是具有下列選項 的額外篩選：

  • 嚴重性 ：只有在異常嚴重性位於指定範圍內時，才會包含異常。
  • 延遲：在警示中觸發時，針對下一個 N 點（期間）中的異常暫時停止警示。
    • 延遲類型 ：當設定為 Series 時，觸發的異常只會延遲其數列。 針對 計量 ，一個觸發的異常會延遲此計量中的所有數列。
    • 延遲號碼 ：延遲的點數（期間）到延遲。
    • 非連續 重設：選取時，觸發的異常只會延遲後續 n 個異常。 如果下列其中一個資料點不是異常，則會從該點重設延遲;未選取時，即使後續的資料點不是異常，一個觸發的異常也會延遲下 n 個點（句點）。
  • value （選擇性）：依值篩選。 只有符合條件的點值，才會包含異常。 如果您使用另一個計量的對應值，則兩個計量的維度名稱應該一致。

未篩選掉的異常會在警示中傳送。

新增跨計量設定

選取 [警示設定] 頁面中的 [+ 新增跨計量設定 ] 以新增另一個區段。

運算子 選取器是每個區段的邏輯關聯性，用來判斷它們是否傳送警示。

運算子 說明
且 只有在數列符合每個警示區段，且所有資料點都是異常時，才會傳送警示。 如果計量有不同的維度名稱，則永遠不會觸發警示。
OR 如果至少有一個區段包含異常，請傳送警示。

Operator for multiple alert setting sections

下一步