操作說明:使用勾點設定警示並取得通知
重要
從 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 程式碼,才能順利通過驗證。
- 要求方法是 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 根據異常警示建立工作專案,您必須授與寫入權限。 建立勾點之後,您可以在任何警示設定中使用它們。 在 勾點設定 頁面中管理您的勾點。
新增或編輯警示設定
移至 [計量詳細資料] 頁面,以尋找 [計量詳細資料] 頁面左下角的 [警示設定 ] 區段。 它會列出套用至所選偵測組態的所有警示設定。 建立新的偵測組態時,沒有警示設定,也不會傳送警示。
您可以使用 新增 、 編輯 和 刪除 圖示來修改警示設定。
選取 [ 新增 ] 或 [編輯 ] 按鈕,以取得視窗以新增或編輯您的警示設定。
警示設定名稱 :警示設定的名稱。 其會顯示在警示電子郵件標題中。
勾點 :要傳送警示的勾點清單。
上述螢幕擷取畫面中標示的區段是一個偵測組態的設定。 您可以針對不同的偵測組態設定不同的警示設定。 使用此視窗中的第三個下拉式清單選擇目標群組態。
篩選設定
以下是一個偵測組態的篩選設定。
[警示] 有四個選項可用來篩選異常:
- 所有系列的 異常:警示中將會包含所有異常。
- 數列群組 中的異常狀況:依維度值篩選數列。 設定某些維度的特定值。 只有在數列符合指定值時,才會將異常包含在警示中。
- 我的最愛系列異常:只有標示為我的最愛的系列 才會包含在警示中。 |
- 所有數列 前 N 名中的異常狀況:此篩選適用于您只關心值在前 N 名的數列。Metrics Advisor 會回顧先前的時間戳記,並檢查這些時間戳記的數列值是否在前 N 名。如果 「in top n」 計數大於指定的數位,則異常將會包含在警示中。 |
篩選異常選項是具有下列選項 的額外篩選:
- 嚴重性 :只有在異常嚴重性位於指定範圍內時,才會包含異常。
- 延遲:在警示中觸發時,針對下一個 N 點(期間)中的異常暫時停止警示。
- 延遲類型 :當設定為 Series 時,觸發的異常只會延遲其數列。 針對 計量 ,一個觸發的異常會延遲此計量中的所有數列。
- 延遲號碼 :延遲的點數(期間)到延遲。
- 非連續 重設:選取時,觸發的異常只會延遲後續 n 個異常。 如果下列其中一個資料點不是異常,則會從該點重設延遲;未選取時,即使後續的資料點不是異常,一個觸發的異常也會延遲下 n 個點(句點)。
- value (選擇性):依值篩選。 只有符合條件的點值,才會包含異常。 如果您使用另一個計量的對應值,則兩個計量的維度名稱應該一致。
未篩選掉的異常會在警示中傳送。
新增跨計量設定
選取 [警示設定] 頁面中的 [+ 新增跨計量設定 ] 以新增另一個區段。
運算子 選取器是每個區段的邏輯關聯性,用來判斷它們是否傳送警示。
運算子 | 說明 |
---|---|
且 | 只有在數列符合每個警示區段,且所有資料點都是異常時,才會傳送警示。 如果計量有不同的維度名稱,則永遠不會觸發警示。 |
OR | 如果至少有一個區段包含異常,請傳送警示。 |