Share via

快速入門：使用 Bicep 檔案在服務通知上建立活動記錄警示

  • 發行項

本文說明如何使用 Bicep 檔案來設定服務健康情況通知的活動記錄警示。

Bicep 是使用宣告式語法來部署 Azure 資源的特定領域語言 (DSL)。 其提供簡潔的語法、可靠的類型安全，並支援程式碼重複使用。 Bicep 能夠為您在 Azure 中的基礎結構即程式碼解決方案，提供最佳的製作體驗。

服務健康情況通知儲存在 Azure 活動記錄中。 由於活動記錄中可能儲存大量的資訊，因此有個別的使用者介面，可讓您更輕鬆地檢視及設定服務健康情況通知的警示。

您可以在 Azure 傳送服務健康狀態通知到您的 Azure 訂用帳戶時接收警示。 您可以針對下列設定警示：

  • 服務健康情況通知的類別 (服務問題、計劃性維護或健康情況摘要報告)。
  • 受影響的訂閱。
  • 受影響的服務。
  • 受影響的區域。

注意

服務健康情況通知不會傳送關於資源健康情況事件的警示。

您也可以設定應傳送警示的對象：

  • 選取現有的動作群組。
  • 建立新動作群組 (可用於未來的警示)。

若要深入了解動作群組，請參閱建立及管理動作群組。

必要條件

檢閱 Bicep 檔案

下列 Bicep 檔案會建立具有電子郵件目標的動作群組，並啟用目標訂用帳戶的所有服務健康情況通知。 將此 Bicep 儲存為 CreateServiceHealthAlert.bicep。

param actionGroups_name string = 'SubHealth'
param activityLogAlerts_name string = 'ServiceHealthActivityLogAlert'
param emailAddress string

var alertScope = '/subscriptions/${subscription().subscriptionId}'

resource actionGroups_name_resource 'microsoft.insights/actionGroups@2019-06-01' = {
  name: actionGroups_name
  location: 'Global'
  properties: {
    groupShortName: actionGroups_name
    enabled: true
    emailReceivers: [
      {
        name: actionGroups_name
        emailAddress: emailAddress
      }
    ]
    smsReceivers: []
    webhookReceivers: []
  }
}

resource activityLogAlerts_name_resource 'microsoft.insights/activityLogAlerts@2017-04-01' = {
  name: activityLogAlerts_name
  location: 'Global'
  properties: {
    scopes: [
      alertScope
    ]
    condition: {
      allOf: [
        {
          field: 'category'
          equals: 'ServiceHealth'
        }
        {
          field: 'properties.incidentType'
          equals: 'Incident'
        }
      ]
    }
    actions: {
      actionGroups: [
        {
          actionGroupId: actionGroups_name_resource.id
          webhookProperties: {}
        }
      ]
    }
    enabled: true
  }
}

Bicep 檔案會定義兩個資源：

部署 Bicep 檔案

使用 Azure CLI 和 Azure PowerShell 部署 Bicep 檔案。 以適用於您環境的適當值取代 Resource Group 和 emailAddress 的範例值。

az login
az deployment group create --name CreateServiceHealthAlert --resource-group my-resource-group --template-file CreateServiceHealthAlert.bicep --parameters emailAddress='user@contoso.com'

驗證部署

使用下列其中一個命令驗證已建立的工作區。 以您在上面使用的值取代 Resource Group 的範例值。

az monitor activity-log alert show --resource-group my-resource-group --name ServiceHealthActivityLogAlert

清除資源

如果您打算繼續進行後續的快速入門和教學課程，您可以讓這些資源留在原處。 如果不再需要，請刪除資源群組，這會刪除警示規則和相關資源。 若要使用 Azure CLI 或 Azure PowerShell 刪除資源群組

az group delete --name my-resource-group

後續步驟