Freigeben über

az monitor scheduled-query

  • Referenz

Hinweis

Diese Referenz ist Teil der geplanten Abfrage Erweiterung für die Azure CLI (Version 2.54.0 oder höher). Die Erweiterung wird automatisch installiert, wenn Sie ein az monitor geplante Abfrage Befehl ausführen. Erfahren Sie mehr über Erweiterungen.

Befehle zum Verwalten geplanter Abfragen.

Befehle

Name Beschreibung Typ Status
az monitor scheduled-query create

Erstellen Sie eine geplante Abfrage.

 Erweiterung GA
az monitor scheduled-query delete

Löschen einer geplanten Abfrage.

 Erweiterung GA
az monitor scheduled-query list

Listet alle geplanten Abfragen auf.

 Erweiterung GA
az monitor scheduled-query show

Details einer geplanten Abfrage anzeigen.

 Erweiterung GA
az monitor scheduled-query update

Aktualisieren einer geplanten Abfrage.

 Erweiterung GA

az monitor scheduled-query create

Erstellen Sie eine geplante Abfrage.

az monitor scheduled-query create --condition
                                  --name
                                  --resource-group
                                  --scopes
                                  [--action-groups]
                                  [--auto-mitigate {false, true}]
                                  [--check-ws-alerts-storage {false, true}]
                                  [--condition-query]
                                  [--custom-properties]
                                  [--description]
                                  [--disabled {false, true}]
                                  [--evaluation-frequency]
                                  [--location]
                                  [--mad]
                                  [--severity]
                                  [--skip-query-validation {false, true}]
                                  [--tags]
                                  [--target-resource-type]
                                  [--window-size]

Beispiele

Erstellen Sie eine geplante Abfrage für einen virtuellen Computer.

az monitor scheduled-query create -g {rg} -n {name1} --scopes {vm_id} --condition "count 'Placeholder_1' > 360 resource id _ResourceId at least 1 violations out of 5 aggregated points" --condition-query Placeholder_1="union Event, Syslog | where TimeGenerated > ago(1h) | where EventLevelName=='Error' or SeverityLevel=='err'" --description "Test rule"

Erstellen Sie eine geplante Abfrage für VMs in einer Ressourcengruppe.

az monitor scheduled-query create -g {rg} -n {name1} --scopes {rg_id} --condition "count 'Placeholder_1' > 360 resource id _ResourceId at least 1 violations out of 5 aggregated points" --condition-query Placeholder_1="union Event, Syslog | where TimeGenerated > ago(1h) | where EventLevelName=='Error' or SeverityLevel=='err'" --description "Test rule"

Erforderliche Parameter

--condition

Die Bedingung, die die Regel auslöst.

Verwendung: --bedingung {avg,min,max,total,count} ["METRIC COLUMN" from] "QUERY_PLACEHOLDER" {=,!=,>,>=,<,<=} THRESHOLD [resource id RESOURCEID] [where DIMENSION {includes,excludes} VALUE [or VALUE ...] [und DIMENSION {includes,excludes} VALUE [or VALUE ...] ...]] [mindestens MinTimeToFail-Verletzungen außerhalb von EvaluationPeriod aggregierten Punkten]' Abfrageplatzhalter können in "--condition-query"-Argumentdimensionen abgefragt werden, indem das Schlüsselwort "where" hinzugefügt und mehrere Dimensionen abgefragt werden können, indem sie mit dem Schlüsselwort "and" kombiniert werden.

--name -n

Name der geplanten Abfrageregel.

--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-groups

Aktionsgruppenressourcen-IDs, die beim Auslösen der Warnung aufgerufen werden sollen.

Verwendung: --action-groups ACTION_GROUP_NAME_OR_ID [NAME_OR_ID,...].

--auto-mitigate

Das Kennzeichen, das angibt, ob die Warnung automatisch aufgelöst werden soll oder nicht. Der Standardwert ist "true".

Zulässige Werte: false, true
Standardwert: True
--check-ws-alerts-storage --cwas

Das Kennzeichen, das angibt, ob diese geplante Abfrageregel im Speicher des Kunden gespeichert werden soll.

Zulässige Werte: false, true
Standardwert: False
--condition-query

Abfragedeteils, um die Platzhalter in --condition Argument zu ersetzen.

--custom-properties

Die Eigenschaften einer Warnungsnutzlast.

Verwendung: --custom-properties ALERT_PAYLOAD_PROPERTIES [KEY=VAL,KEY=VAL...].

--description

Freitextbeschreibung der Regel.

--disabled

Deaktivieren Sie die geplante Abfrage.

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

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

Standardwert: 5m
--location -l

Ort. Werte aus: az account list-locations. Sie können den Standardspeicherort mithilfe von az configure --defaults location=<location>konfigurieren.

--mad --mute-actions-duration

Stummschalten sie Aktionen für den ausgewählten Zeitraum (im ISO 8601-Dauerformat), nachdem die Warnung ausgelöst wurde.

--severity

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

Standardwert: 2
--skip-query-validation

Das Kennzeichen, das angibt, ob die bereitgestellte Abfrage überprüft werden soll.

Zulässige Werte: false, true
Standardwert: False
--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

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, 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

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az monitor scheduled-query delete

Löschen einer geplanten Abfrage.

az monitor scheduled-query delete [--ids]
                                  [--name]
                                  [--resource-group]
                                  [--subscription]
                                  [--yes]

Optionale Parameter

--ids

Mindestens eine 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

Name der geplanten Abfrageregel.

--resource-group -g

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

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--yes -y

Zur Bestätigung nicht auffordern.

Standardwert: False
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, 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

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az monitor scheduled-query list

Listet alle geplanten Abfragen auf.

az monitor scheduled-query list [--resource-group]

Optionale Parameter

--resource-group -g

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

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, 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

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az monitor scheduled-query show

Details einer geplanten Abfrage anzeigen.

az monitor scheduled-query show [--ids]
                                [--name]
                                [--resource-group]
                                [--subscription]

Optionale Parameter

--ids

Mindestens eine 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

Name der geplanten Abfrageregel.

--resource-group -g

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

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, 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

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az monitor scheduled-query update

Aktualisieren einer geplanten Abfrage.

az monitor scheduled-query update [--action-groups]
                                  [--add]
                                  [--auto-mitigate {false, true}]
                                  [--check-ws-alerts-storage {false, true}]
                                  [--condition]
                                  [--condition-query]
                                  [--custom-properties]
                                  [--description]
                                  [--disabled {false, true}]
                                  [--evaluation-frequency]
                                  [--force-string]
                                  [--ids]
                                  [--mad]
                                  [--name]
                                  [--remove]
                                  [--resource-group]
                                  [--set]
                                  [--severity]
                                  [--skip-query-validation {false, true}]
                                  [--subscription]
                                  [--tags]
                                  [--target-resource-type]
                                  [--window-size]

Optionale Parameter

--action-groups

Aktionsgruppenressourcen-IDs, die beim Auslösen der Warnung aufgerufen werden sollen.

--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>.

Standardwert: []
--auto-mitigate

Das Kennzeichen, das angibt, ob die Warnung automatisch aufgelöst werden soll oder nicht. Der Standardwert ist "true".

Zulässige Werte: false, true
--check-ws-alerts-storage --cwas

Das Kennzeichen, das angibt, ob diese geplante Abfrageregel im Speicher des Kunden gespeichert werden soll.

Zulässige Werte: false, true
--condition

Die Bedingung, die die Regel auslöst.

Verwendung: --bedingung {avg,min,max,total,count} ["METRIC COLUMN" from] "QUERY_PLACEHOLDER" {=,!=,>,>=,<,<=} THRESHOLD [resource id RESOURCEID] [where DIMENSION {includes,excludes} VALUE [or VALUE ...] [und DIMENSION {includes,excludes} VALUE [or VALUE ...] ...]] [mindestens MinTimeToFail-Verstöße aus EvaluationPeriod aggregierten Punkten]'

Abfrageplatzhalter können in --condition-query-argument Dimensions durch Hinzufügen des Schlüsselworts "where" und mehrere Dimensionen abgefragt werden, indem sie mit dem Schlüsselwort "and" kombiniert werden.

--condition-query

Abfragedeteils, um die Platzhalter in --condition Argument zu ersetzen.

--custom-properties

Die Eigenschaften einer Warnungsnutzlast.

Verwendung: --custom-properties ALERT_PAYLOAD_PROPERTIES [KEY=VAL,KEY=VAL...].

--description

Freitextbeschreibung der Regel.

--disabled

Deaktivieren Sie die geplante Abfrage.

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

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

--force-string

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

Standardwert: False
--ids

Mindestens eine 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.

--mad --mute-actions-duration

Stummschalten sie Aktionen für den ausgewählten Zeitraum (im ISO 8601-Dauerformat), nachdem die Warnung ausgelöst wurde.

--name -n

Name der geplanten Abfrageregel.

--remove

Entfernen sie eine Eigenschaft oder ein Element aus einer Liste. Beispiel: --remove property.list <indexToRemove> ODER --remove propertyToRemove.

Standardwert: []
--resource-group -g

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

--set

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

Standardwert: []
--severity

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

--skip-query-validation

Das Kennzeichen, das angibt, ob die bereitgestellte Abfrage überprüft werden soll.

Zulässige Werte: false, true
--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--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.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, 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

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.