透過使用 Logic Apps 自訂警示通知

發行項
03/18/2024

本文說明如何建立邏輯應用程式，並將其與 Azure 監視器警示整合。

您可以使用 Azure Logic Apps 建置和自訂工作流程以進行整合。使用 Logic Apps 自訂警示通知。您可以：

藉由使用您自己的電子郵件主旨和本文格式，自訂警示電子郵件。
查閱受影響資源的標籤或擷取記錄查詢搜尋結果，以自訂警示中繼資料。如需如何存取包含警示資料的搜尋結果資料列的詳細資訊，請參閱：
- Azure 監視器 Log Analytics API 回應格式
- 查詢/管理 HTTP 回應
藉由使用 Outlook、Microsoft Teams、Slack 和 PagerDuty 等現有連接器，以便與外部服務整合。您也可以為自己的服務設定邏輯應用程式。

在此範例中，建立邏輯應用程式，以使用一般警示結構描述從警示傳送詳細資料。

建立邏輯應用程式

在 Azure 入口網站中建立新的邏輯應用程式。在頁面頂端的 [搜尋] 列中，輸入 邏輯應用程式。
在 [邏輯應用程式] 頁面上，選取 [新增]。
選取您邏輯應用程式的訂用帳戶與資源群組。
設定邏輯應用程式名稱。針對方案類型，選取 [使用量]。
選取 [檢閱 + 建立]>[建立]。
部署完成後選取 [移至資源]。
在 [Logic Apps 設計工具] 頁面上，選取 [收到 HTTP 要求時]。

將一般警示結構描述從下列 JSON 貼到 [要求本文 JSON 結構描述] 欄位中：

 {
    "type": "object",
    "properties": {
        "schemaId": {
            "type": "string"
        },
        "data": {
            "type": "object",
            "properties": {
                "essentials": {
                    "type": "object",
                    "properties": {
                        "alertId": {
                            "type": "string"
                        },
                        "alertRule": {
                            "type": "string"
                        },
                        "severity": {
                            "type": "string"
                        },
                        "signalType": {
                            "type": "string"
                        },
                        "monitorCondition": {
                            "type": "string"
                        },
                        "monitoringService": {
                            "type": "string"
                        },
                        "alertTargetIDs": {
                            "type": "array",
                            "items": {
                                "type": "string"
                            }
                        },
                        "originAlertId": {
                            "type": "string"
                        },
                        "firedDateTime": {
                            "type": "string"
                        },
                        "resolvedDateTime": {
                            "type": "string"
                        },
                        "description": {
                            "type": "string"
                        },
                        "essentialsVersion": {
                            "type": "string"
                        },
                        "alertContextVersion": {
                            "type": "string"
                        }
                    }
                },
                "alertContext": {
                    "type": "object",
                    "properties": {}
                }
            }
        }
    }
}

Screenshot that shows the Parameters tab for the When an HTTP request is received pane.

(選擇性)。您可以擷取警示引發時受影響資源的相關資訊，例如資源標籤，以自訂警示通知。然後，您可以將這些資源標記包含在警示承載中，並使用邏輯運算式中的資訊來傳送通知。若要執行此步驟，我們將：

為受影響的資源識別碼建立變數。
將資源識別碼分割成陣列，以便使用其各種元素 (例如訂用帳戶和資源群組)。
使用 Azure Resource Manager 連接器來讀取資源的中繼資料。
擷取資源的標籤，然後可在邏輯應用程式的後續步驟中使用。

選取 +>[新增動作] 圖示以插入新步驟。
在 [搜尋] 欄位中，搜尋並選取 [初始化變數]。
在 [名稱] 字段中，輸入變數的名稱，例如 AffectedResource。
在類型欄位中，選取陣列。
在 [值] 欄位中，選取 [新增動態內容]。選擇 [運算式] 索引標籤，然後輸入字串 split(triggerBody()?['data']?['essentials']?['alertTargetIDs'][0], '/')。
選取 +>[新增動作] 圖示以插入其他步驟。
在 [搜尋] 欄位中，搜尋並選取 [Azure Resource Manager]>[讀取資源]。

使用來自 AffectedResource 變數的陣列值，填入 [讀取資源] 動作的欄位。在每個欄位中，選取欄位並向下捲動至 [輸入自訂值]。選取 [新增動態內容]，然後選取 [運算式] 索引標籤。輸入此資料表中的字串：

欄位	[字串值]
訂用帳戶	`variables('AffectedResource')[2]`
資源群組	`variables('AffectedResource')[4]`
資源提供者	`variables('AffectedResource')[6]`
短資源識別碼	`concat(variables('AffectedResource')[7], '/', variables('AffectedResource')[8]`)
用戶端 API 版本	資源類型的 API 版本

若要尋找資源類型的 API 版本，請選取資源概觀頁面右上方的 [JSON 檢視] 連結。 [資源 JSON] 頁面會在頁面頂端搭配 ResourceID 和 API 版本顯示。

動態內容現在包含受影響資源的標記。您可以在設定通知時使用這些標記，如下列步驟所述。

傳送電子郵件或張貼 Teams 訊息。
選取 +>[新增動作] 圖示以插入新步驟。

傳送電子郵件
張貼 Teams 訊息

在搜尋欄位中，搜尋 Outlook。
選取 [Office 365 Outlook]。
從動作清單中，選取 [傳送電子郵件 (V2)]。
系統提示您建立連線時，登入 Office 365。
從 [動態內容] 清單中選擇欄位，輸入靜態文字並包含從警示承載取得的內容，以建立電子郵件本文。例如：
- 警示有監視條件：從 [動態內容] 清單中選取 [monitorCondition]。
- 引發日期：從 [動態內容] 清單中選取 [firedDateTime]。
- 受影響的資源：從 [動態內容] 清單中選取 [alertTargetIDs]。
在 [主旨] 欄位中，從 [動態內容] 清單中選擇欄位，輸入靜態文字並包含從警示承載取得的內容，以建立主旨文字。例如：
- 警示：從 [動態內容] 清單中選取 [alertRule]。
- 具有嚴重性：從 [動態內容] 清單中選取 [severity]。
- 具有條件：從 [動態內容] 清單中選取 [monitorCondition]。
於 [收件者] 欄位中輸入警示要傳送至的電子郵件地址。
選取 [儲存]。