Freigeben über


az monitor metrics alert

Verwalten Von Warnungsregeln für metrische Benachrichtigungen in Nahezu-Echtzeit.

Befehle

Name Beschreibung Typ Status
az monitor metrics alert condition

Verwalten Von Regelbedingungen für metrische Warnungen in Nahezu-Echtzeit.

Core Allgemein verfügbar
az monitor metrics alert condition create

Erstellen Sie eine metrische Warnungsregelbedingung.

Core Vorschau
az monitor metrics alert create

Erstellen Sie eine metrikbasierte Warnungsregel.

Core Allgemein verfügbar
az monitor metrics alert delete

Löschen einer metrikbasierten Warnungsregel.

Core Allgemein verfügbar
az monitor metrics alert dimension

Verwalten Von Warnungsregelabmessungen in Nahezu-Echtzeit.

Core Allgemein verfügbar
az monitor metrics alert dimension create

Erstellen Sie eine Metrik-Warnungsregeldimension.

Core Vorschau
az monitor metrics alert list

Listen Sie metrikbasierte Warnungsregeln auf.

Core Allgemein verfügbar
az monitor metrics alert show

Anzeigen einer metrikbasierten Warnungsregel.

Core Allgemein verfügbar
az monitor metrics alert update

Aktualisieren einer metrikbasierten Warnungsregel.

Core Allgemein verfügbar

az monitor metrics alert create

Erstellen Sie eine metrikbasierte Warnungsregel.

az monitor metrics alert create --condition
                                --name
                                --resource-group
                                --scopes
                                [--action]
                                [--auto-mitigate {false, true}]
                                [--description]
                                [--disabled {false, true}]
                                [--evaluation-frequency]
                                [--region]
                                [--severity]
                                [--tags]
                                [--target-resource-type]
                                [--window-size]

Beispiele

Erstellen Sie eine Warnung zur hohen CPU-Auslastung auf einem virtuellen Computer ohne Aktion.

az monitor metrics alert create -n alert1 -g {ResourceGroup} --scopes {VirtualMachineID} --condition "avg Percentage CPU > 90" --description "High CPU"

Erstellen Sie eine Warnung zur hohen CPU-Auslastung auf einem virtuellen Computer mit E-Mail- und Webhook-Aktionen.

az monitor metrics alert create -n alert1 -g {ResourceGroup} --scopes {VirtualMachineID} \
    --condition "avg Percentage CPU > 90" --window-size 5m --evaluation-frequency 1m \
    --action "/subscriptions/<subscriptionId>/resourceGroups/<resourceGroupName>/providers/Microsoft.Insights/actionGroups/<actionGroupName>" apiKey={APIKey} type=HighCPU \
    --description "High CPU"

Erstellen Sie eine Benachrichtigung, wenn ein Speicherkonto eine hohe Anzahl langsamer Transaktionen mit mehrdimensionalen Filtern anzeigt.

az monitor metrics alert create -g {ResourceGroup} -n alert1 --scopes {StorageAccountId} \
    --description "Storage Slow Transactions" \
    --condition "total transactions > 5 where ResponseType includes Success" \
    --condition "avg SuccessE2ELatency > 250 where ApiName includes GetBlob"

Erstellen Sie eine metrikbasierte Warnungsregel, die eine benutzerdefinierte Metrik überwacht.

az monitor metrics alert create -n "metric alert rule on a custom metric" -g "Demos" --scopes {VirtualMachineID} \
    --condition "max Azure.VM.Windows.GuestMetrics.Memory\Available Bytes > 90" \
    --window-size 5m --evaluation-frequency 1m

Erstellen Sie eine Warnung zur hohen CPU-Auslastung auf mehreren virtuellen Computern ohne Aktionen.

az monitor metrics alert create -n alert1 -g {ResourceGroup} --scopes {VirtualMachineID1} {VirtualMachineID2} {VirtualMachineID3} \
    --condition "avg Percentage CPU > 90" --description "High CPU" --region westus

Erstellen Sie eine Warnung zur dynamischen CPU-Auslastung auf mehreren virtuellen Computern ohne Aktionen.

az monitor metrics alert create -n alert1 -g {ResourceGroup} --scopes {VirtualMachineID1} {VirtualMachineID2} {VirtualMachineID3} \
    --condition "avg Percentage CPU > dynamic medium 2 of 4 since 2020-10-01T10:23:00.000Z"
    --description "Dynamic CPU"
    --window-size 5m
    --region westus

Erforderliche Parameter

--condition

Die Bedingung, die die Regel auslöst. Sie kann durch den Befehl "az monitor metrics alert condition create" erstellt werden.

Verwendung: --condition {avg,min,max,total,count} [NAMESPACE.] METRIC [{=,!=,;;>=>,<=<}SCHWELLENWERT] [{<,>,}><dynamische VERTRAULICHKEITSVERLETZUNGEN VON AUSWERTUNGEN [seit DATETIME]] [wobei DIMENSION {includes,excludes} VALUE [or VALUE ...] [und DIMENSION {includes,excludes} VALUE [or VALUE ...] ...]] [mit skipmetricvalidation]

Die Empfindlichkeit kann "niedrig", "mittel", "hoch" sein.

Verstöße können die Anzahl der Verletzungen sein, um eine Warnung auszulösen. Es sollte kleiner oder gleich der Auswertung sein.

Auswertungen können die Anzahl der Auswertungszeiträume für dynamische Schwellenwerte sein.

Datetime kann das Datum sein, von dem aus sie mit dem Erlernen der metrischen Historischen Daten beginnen und die dynamischen Schwellenwerte (im ISO8601 Format) berechnen.

Dimensionen können abgefragt werden, indem sie die "where"-Schlüsselwort (keyword) und mehrere Dimensionen durch Kombinieren mit dem Schlüsselwort (keyword) "und" abfragen.

Werte für METRIC, DIMENSION und entsprechende SCHWELLENWERTe können über az monitor metrics list-definitions den Befehl abgerufen werden.

Aufgrund der Servereinschränkung ist die Verwendung von Dimensionen innerhalb jedes Kriteriums auf einen Wert pro Dimension beschränkt, wenn eine Warnungsregel mehrere Kriterien enthält.

Mehrere Bedingungen können mithilfe --condition mehrerer Argumente angegeben werden.

--name -n

Der Name der Warnungsregel.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--scopes

Leerzeichentrennte Liste der Bereiche, auf die die Regel angewendet wird. Die in diesem Parameter angegebenen Ressourcen müssen denselben Typ aufweisen und an demselben Speicherort vorhanden sein.

Optionale Parameter

--action -a

Fügen Sie eine Aktionsgruppe und optionale Webhook-Eigenschaften hinzu, die ausgelöst werden sollen, wenn die Warnung ausgelöst wird.

Verwendung: --action ACTION_GROUP_NAME_OR_ID [KEY=VAL [KEY=VAL ...]]

Mehrere Aktionsgruppen können mithilfe --action mehrerer Argumente angegeben werden.

--auto-mitigate

Automatisches Auflösen der Warnung.

Zulässige Werte: false, true
--description

Freitextbeschreibung der Regel.

--disabled

Erstellen Sie die Regel in einem deaktivierten Zustand.

Zulässige Werte: false, true
Standardwert: False
--evaluation-frequency

Häufigkeit, mit der die Regel im Format "##h##m##s" ausgewertet werden soll.

Standardwert: 1m
--region --target-resource-region

Der Bereich der Zielressource(n) in Bereichen. Dies muss angegeben werden, wenn Bereiche Ressourcengruppe oder Abonnement sind.

--severity

Schweregrad der Warnung von 0 (kritisch) bis 4 (ausführlich).

Standardwert: 2
--tags

Durch Leerzeichen getrennte Tags: key[=value] [key[=value] ...]. Verwenden Sie "", um vorhandene Tags zu löschen.

--target-resource-type --type

Der Ressourcentyp der Zielressource(n) in Bereichen. Dies muss angegeben werden, wenn Bereiche Ressourcengruppe oder Abonnement sind.

--window-size

Zeit, über die Metriken im Format "##h##m##s" aggregiert werden sollen.

Standardwert: 5m
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az monitor metrics alert delete

Löschen einer metrikbasierten Warnungsregel.

az monitor metrics alert delete [--ids]
                                [--name]
                                [--resource-group]
                                [--subscription]

Beispiele

Löschen einer metrikbasierten Warnungsregel.

az monitor metrics alert delete --name MyAlertRule --resource-group MyResourceGroup

Optionale Parameter

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--name -n

Der Name der Warnungsregel.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az monitor metrics alert list

Listen Sie metrikbasierte Warnungsregeln auf.

az monitor metrics alert list [--resource-group]

Beispiele

Listen Sie metrikbasierte Warnungsregeln auf.

az monitor metrics alert list --resource-group MyResourceGroup

Optionale Parameter

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az monitor metrics alert show

Anzeigen einer metrikbasierten Warnungsregel.

az monitor metrics alert show [--ids]
                              [--name]
                              [--resource-group]
                              [--subscription]

Beispiele

Anzeigen einer metrikbasierten Warnungsregel.

az --name MyAlertRule --resource-group MyResourceGroup

Optionale Parameter

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--name -n

Der Name der Warnungsregel.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az monitor metrics alert update

Aktualisieren einer metrikbasierten Warnungsregel.

az monitor metrics alert update [--add]
                                [--add-action]
                                [--add-condition]
                                [--auto-mitigate {0, 1, f, false, n, no, t, true, y, yes}]
                                [--description]
                                [--enabled {0, 1, f, false, n, no, t, true, y, yes}]
                                [--evaluation-frequency]
                                [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                                [--ids]
                                [--name]
                                [--remove]
                                [--remove-actions]
                                [--remove-conditions]
                                [--resource-group]
                                [--scopes]
                                [--set]
                                [--severity]
                                [--subscription]
                                [--tags]
                                [--window-size]

Beispiele

Deaktivieren/Aktivieren einer metrikbasierten Warnungsregel.

az monitor metrics alert update --enabled false --name MyAlertRule --resource-group MyResourceGroup

Optionale Parameter

--add

Fügen Sie einer Liste von Objekten ein Objekt hinzu, indem Sie ein Pfad- und Schlüsselwertpaar angeben. Beispiel: --add property.listProperty <key=value, string or JSON string>.

--add-action --add-actions

Fügen Sie eine Aktionsgruppe und optionale Webhook-Eigenschaften hinzu, die ausgelöst werden sollen, wenn die Warnung ausgelöst wird.

Verwendung: --add-action ACTION_GROUP_NAME_OR_ID [KEY=VAL [KEY=VAL ...]]

Mehrere Aktionsgruppen können mithilfe --add-action mehrerer Argumente angegeben werden. Unterstützung von Shorthand-Syntax, JSON-Datei und Yaml-Datei. Probieren Sie "??" aus, um mehr anzuzeigen.

--add-condition --add-conditions

Fügen Sie eine Bedingung hinzu, die die Regel auslöst.

Verwendung: --add-condition {avg,min,max,total,count} [NAMESPACE.] METRIC [{=,!=,;;>=>,<=<}SCHWELLENWERT] [{<,>,}><dynamische VERTRAULICHKEITSVERLETZUNGEN VON AUSWERTUNGEN [seit DATETIME]] [wobei DIMENSION {includes,excludes} VALUE [or VALUE ...] [und DIMENSION {includes,excludes} VALUE [or VALUE ...] ...]]

Die Empfindlichkeit kann "niedrig", "mittel", "hoch" sein.

Verstöße können die Anzahl der Verletzungen sein, um eine Warnung auszulösen. Es sollte kleiner oder gleich der Auswertung sein.

Auswertungen können die Anzahl der Auswertungszeiträume für dynamische Schwellenwerte sein.

Datetime kann das Datum sein, von dem aus sie mit dem Erlernen der metrischen Historischen Daten beginnen und die dynamischen Schwellenwerte (im ISO8601 Format) berechnen.

Dimensionen können abgefragt werden, indem sie die "where"-Schlüsselwort (keyword) und mehrere Dimensionen durch Kombinieren mit dem Schlüsselwort (keyword) "und" abfragen.

Werte für METRIC, DIMENSION und entsprechende SCHWELLENWERTe können über az monitor metrics list-definitions den Befehl abgerufen werden.

Aufgrund der Servereinschränkung ist die Verwendung von Dimensionen innerhalb jedes Kriteriums auf einen Wert pro Dimension beschränkt, wenn eine Warnungsregel mehrere Kriterien enthält.

Mehrere Bedingungen können mithilfe --add-condition mehrerer Argumente angegeben werden. Unterstützung von Shorthand-Syntax, JSON-Datei und Yaml-Datei. Probieren Sie "??" aus, um mehr anzuzeigen.

--auto-mitigate

Automatisches Auflösen der Warnung.

Zulässige Werte: 0, 1, f, false, n, no, t, true, y, yes
--description

Freitextbeschreibung der Regel.

--enabled

Gibt an, ob die Metrikwarnungsregel aktiviert ist.

Zulässige Werte: 0, 1, f, false, n, no, t, true, y, yes
--evaluation-frequency

Häufigkeit, mit der die Regel im ##h##m##s Format ausgewertet werden soll.

--force-string

Wenn Sie "set" oder "add" verwenden, behalten Sie Zeichenfolgenliterale bei, anstatt zu versuchen, in JSON zu konvertieren.

Zulässige Werte: 0, 1, f, false, n, no, t, true, y, yes
--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--name -n

Der Name der Warnungsregel.

--remove

Entfernen sie eine Eigenschaft oder ein Element aus einer Liste. Beispiel: --remove property.list OR --remove propertyToRemove.

--remove-actions

Durch Leerzeichen getrennte Liste der zu entfernenden Aktionsgruppennamen. Unterstützung von Shorthand-Syntax, JSON-Datei und Yaml-Datei. Probieren Sie "??" aus, um mehr anzuzeigen.

--remove-conditions

Leerzeichentrennte Liste der zu entfernenden Bedingungsnamen. Unterstützung von Shorthand-Syntax, JSON-Datei und Yaml-Datei. Probieren Sie "??" aus, um mehr anzuzeigen.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--scopes

Leerzeichentrennte Liste der Bereiche, auf die die Regel angewendet wird. Die in diesem Parameter angegebenen Ressourcen müssen denselben Typ aufweisen und an demselben Speicherort vorhanden sein. Unterstützung von Shorthand-Syntax, JSON-Datei und Yaml-Datei. Probieren Sie "??" aus, um mehr anzuzeigen.

--set

Aktualisieren Sie ein Objekt, indem Sie einen festzulegenden Eigenschaftspfad und -wert angeben. Beispiel: --set property1.property2=.

--severity

Schweregrad der Warnung von 0 (kritisch) bis 4 (ausführlich).

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--tags

Durch Leerzeichen getrennte Tags: key[=value] [key[=value] ...]. Unterstützung von Shorthand-Syntax, JSON-Datei und Yaml-Datei. Probieren Sie "??" aus, um mehr anzuzeigen.

--window-size

Zeit, über die Metriken im ##h##m##s Format aggregiert werden sollen.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.