Schnellstart: Erstellen von Dienstintegritätswarnungen zu Dienstbenachrichtigungen mit einer ARM-Vorlage

Dieser Leitfaden führt Sie durch das Einrichten von Dienstintegritätswarnungen für Dienststatusbenachrichtigungen mithilfe einer Azure Resource Manager (ARM)-Vorlage.

Eine Azure Resource Manager-Vorlage ist eine JSON (JavaScript Object Notation)-Datei, welche die Infrastruktur und die Konfiguration für Ihr Projekt definiert. Die Vorlage verwendet eine deklarative Syntax. Sie beschreiben Ihre geplante Bereitstellung, ohne die Abfolge der Programmierbefehle zum Erstellen der Bereitstellung zu schreiben.

Überblick

Benachrichtigungen zur Dienstintegrität werden im Azure-Aktivitätsprotokoll gespeichert. Angesichts der möglicherweise großen Menge an Informationen, die im Aktivitätsprotokoll gespeichert sind, gibt es eine separate Benutzeroberfläche, um das Anzeigen und Einrichten von Warnungen für Dienststatusbenachrichtigungen zu vereinfachen.

Sie können eine Warnung erhalten, wenn Azure Benachrichtigungen zur Dienstintegrität an Ihr Azure-Abonnement sendet. Sie können die Warnung konfigurieren auf der Grundlage von:

  • Die Klasse der Dienststatusbenachrichtigung (Dienstprobleme, geplante Wartung, Gesundheitsberater und Sicherheitsempfehlungen).
  • Dem betroffenen Abonnement.
  • Die betroffenen Dienste.
  • Die betroffenen Regionen.

Hinweis

Dienststatusbenachrichtigungen senden keine Warnungen zu Ressourcengesundheitsereignissen.

Sie können auch konfigurieren, an wen die Warnung gesendet werden soll:

  • Wählen Sie eine vorhandene Aktionsgruppe aus.
  • Erstellen Sie eine neue Aktionsgruppe, die für zukünftige Warnungen verwendet werden kann.

Weitere Informationen zu Aktionsgruppen finden Sie unter Erstellen und Verwalten von Aktionsgruppen im Azure-Portal.

Voraussetzungen

1. Überprüfen Der Vorlage

Mit der folgenden Vorlage wird eine Aktionsgruppe mit einem E-Mail-Ziel erstellt, und alle Dienstintegritätsbenachrichtigungen für das Zielabonnement werden aktiviert.
Speichern Sie diese Vorlage als CreateServiceHealthAlert.json.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "actionGroups_name": {
      "type": "string",
      "defaultValue": "SubHealth"
    },
    "activityLogAlerts_name": {
      "type": "string",
      "defaultValue": "ServiceHealthActivityLogAlert"
    },
    "emailAddress": {
      "type": "string"
    }
  },
  "variables": {
    "alertScope": "[format('/subscriptions/{0}', subscription().subscriptionId)]"
  },
  "resources": [
    {
      "type": "microsoft.insights/actionGroups",
      "apiVersion": "2019-06-01",
      "name": "[parameters('actionGroups_name')]",
      "location": "Global",
      "properties": {
        "groupShortName": "[parameters('actionGroups_name')]",
        "enabled": true,
        "emailReceivers": [
          {
            "name": "[parameters('actionGroups_name')]",
            "emailAddress": "[parameters('emailAddress')]"
          }
        ],
        "smsReceivers": [],
        "webhookReceivers": []
      }
    },
    {
      "type": "microsoft.insights/activityLogAlerts",
      "apiVersion": "2017-04-01",
      "name": "[parameters('activityLogAlerts_name')]",
      "location": "Global",
      "properties": {
        "scopes": [
          "[variables('alertScope')]"
        ],
        "condition": {
          "allOf": [
            {
              "field": "category",
              "equals": "ServiceHealth"
            },
            {
              "field": "properties.incidentType",
              "equals": "Incident"
            }
          ]
        },
        "actions": {
          "actionGroups": [
            {
              "actionGroupId": "[resourceId('microsoft.insights/actionGroups', parameters('actionGroups_name'))]",
              "webhookProperties": {}
            }
          ]
        },
        "enabled": true
      },
      "dependsOn": [
        "[resourceId('microsoft.insights/actionGroups', parameters('actionGroups_name'))]"
      ]
    }
  ]
}

Die Vorlage definiert zwei Ressourcen:

2. Bereitstellen der Vorlage

Stellen Sie die Vorlage mithilfe einer beliebigen Standardmethode für die Bereitstellung einer ARM-Vorlage bereit. Sie können die folgenden Beispiele für die Verwendung von CLI und PowerShell verwenden.

Ersetzen Sie die Beispielwerte für "Ressourcengruppe " und "emailAddress " durch die entsprechenden Werte für Ihre Umgebung.

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

3. Überprüfen der Bereitstellung

Stellen Sie sicher, dass der Arbeitsbereich mit einem der folgenden Befehle erstellt wird. Ersetzen Sie die Beispielwerte für die Ressourcengruppe durch die von Ihnen verwendeten Werte.

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

4. Bereinigen von Ressourcen

Falls Sie mit weiteren Schnellstartanleitungen und Tutorials fortfahren möchten, sollten Sie die Ressourcen nicht bereinigen.

Sie können die Ressourcengruppe löschen, wenn sie nicht mehr benötigt wird, wodurch die Warnungsregel und die zugehörigen Ressourcen gelöscht werden. So löschen Sie die Ressourcengruppe mithilfe der hier gezeigten Azure CLI- oder Azure PowerShell-Befehle.

az group delete --name my-resource-group

Weitere Informationen