Freigeben über

Erstellen einer neuen Warnungsregel mithilfe der CLI, PowerShell oder einer ARM-Vorlage

  • Artikel

Sie können eine neue Warnungsregel mithilfe der der CLI-, PowerShell-oder einer Azure Resource Manager-Vorlageerstellen.

Voraussetzungen

Zum Erstellen oder Bearbeiten einer Warnungsregel müssen Sie die folgenden Berechtigungen haben:

  • Leseberechtigung für die Zielressource der Warnungsregel.
  • Schreibberechtigung für die Ressourcengruppe, in der die Warnungsregel erstellt wird. Wenn Sie die Warnungsregel über das Azure-Portal erstellen, wird die Warnungsregel standardmäßig in derselben Ressourcengruppe erstellt, in der sich die Zielressource befindet.
  • Leseberechtigung für jede Aktionsgruppe, die der Warnungsregel zugeordnet ist, falls zutreffend.

Erstellen einer neuen Warnungsregel mit der CLI

Sie können eine neue Warnungsregel mithilfe der Azure CLI erstellen. In den folgenden Codebeispielen wird Azure Cloud Shell verwendet. Sie können die vollständige Liste der Azure CLI-Befehle für Azure Monitor einsehen.

  1. Wählen Sie im PortalCloud Shell aus. Verwenden Sie diese an der Eingabeaufforderung.

    Beispiel: Zum Erstellen einer Metrikwarnungsregel, die überwacht, ob der durchschnittliche Wert für „CPU in Prozent“ einer VM größer als 90 ist:

     az monitor metrics alert create -n {nameofthealert} -g {ResourceGroup} --scopes {VirtualMachineResourceID} --condition "avg Percentage CPU > 90" --description {descriptionofthealert}

Erstellen einer neuen Warnungsregel mit PowerShell

  • Zum Erstellen einer Metrikwarnungsregel mit PowerShell verwenden Sie das Cmdlet Add-AzMetricAlertRuleV2.

    Hinweis

    Wenn Sie eine Metrikwarnung für eine einzelne Ressource erstellen, verwendet die Syntax die TargetResourceId. Wenn Sie eine metrische Warnung für mehrere Ressourcen erstellen, enthält die Syntax den TargetResourceScope, den TargetResourceType und die TargetResourceRegion.

  • Zum Erstellen einer Regel für Protokollsuchwarnungen mit PowerShell verwenden Sie das Cmdlet New-AzScheduledQueryRule.
  • Zum Erstellen einer Aktivitätsprotokoll-Warnungsregel mit PowerShell verwenden Sie das Cmdlet New-AzActivityLogAlert.

Erstellen einer neuen Warnungsregel mithilfe einer ARM-Vorlage

Sie können eine Azure Resource Manager-Vorlage (ARM-Vorlage) verwenden, um Warnungsregeln in allen Umgebungen konsistent zu konfigurieren.

  1. Erstellen Sie eine neue Ressource mit den folgenden Ressourcentypen:

    • Für Metrikwarnungen: Microsoft.Insights/metricAlerts

      Hinweis

      • Es wird empfohlen, die Metrikwarnung mit derselben Ressourcengruppe wie Ihre Zielressource zu erstellen.
      • Metrikwarnungen für Ressourcen vom Typ Azure Log Analytics-Arbeitsbereich (Microsoft.OperationalInsights/workspaces) werden anders konfiguriert als andere Metrikwarnungen. Weitere Informationen finden Sie unter Ressourcenvorlage für Metrikwarnungen für Protokolle.
      • Wenn Sie eine Metrikwarnung für eine einzelne Ressource erstellen, verwendet die Vorlage die ResourceId der Zielressource. Wenn Sie eine Metrikwarnung für mehrere Ressourcen erstellen, verwendet die Vorlage den scope, den TargetResourceType und die TargetResourceRegion für die Zielressourcen.
    • Für Protokollsuchwarnungen: Microsoft.Insights/scheduledQueryRules
    • Für Aktivitätsprotokoll-, Dienstintegritäts- und Ressourcenintegritätswarnungen: microsoft.Insights/activityLogAlerts

  2. Kopieren Sie eine der Vorlagen aus diesen ARM-Beispielvorlagen.

  3. Bearbeiten Sie die Vorlagendatei, damit sie die geeigneten Informationen für Ihre Warnung enthält, und speichern Sie die Datei als <Ihre-Warnungsvorlagendatei>.json.

  4. Bearbeiten Sie die entsprechende Parameterdatei, um die Warnung anzupassen, und speichern Sie sie als <Ihre-Warnungsvorlagendatei>.parameters.json.

  5. Legen Sie den metricName-Parameter mithilfe eines der Werte in den unterstützten Azure Monitor-Metriken fest.

  6. Stellen Sie die Vorlage mithilfe von PowerShell oder der CLI bereit.

Nächste Schritte