Freigeben über

az monitor scheduled-query

  • Referenz

Hinweis

Diese Referenz ist Teil der geplanten Abfrageerweiterung für die Azure CLI (Version 2.54.0 oder höher). Die Erweiterung wird automatisch installiert, wenn Sie einen az monitor geplanten Abfragebefehl zum ersten Mal ausführen. Weitere Informationen zu Erweiterungen

Befehle zum Verwalten geplanter Abfragen.

Befehle

Name Beschreibung Typ Status
az monitor scheduled-query create

Erstellen Sie eine geplante Abfrage.

 Erweiterung Allgemein verfügbar
az monitor scheduled-query delete

Löschen einer geplanten Abfrage.

 Erweiterung Allgemein verfügbar
az monitor scheduled-query list

Listet alle geplanten Abfragen auf.

 Erweiterung Allgemein verfügbar
az monitor scheduled-query show

Details einer geplanten Abfrage anzeigen.

 Erweiterung Allgemein verfügbar
az monitor scheduled-query update

Aktualisieren einer geplanten Abfrage.

 Erweiterung Allgemein verfügbar

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 argument Dimensions abgefragt werden, indem die "where"-Schlüsselwort (keyword) und mehrere Dimensionen abgefragt werden können, indem sie mit dem "und" Schlüsselwort (keyword) 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 im --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

Position. Werte aus: az account list-locations. Sie können den standardmäßig verwendeten Standort mit 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

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 scheduled-query delete

Löschen einer geplanten Abfrage.

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

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 „Ressource id“-Argumente handeln. Sie sollten entweder „--ids“ oder andere „Resource Id“-Argumente 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

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

--yes -y

Nicht zur Bestätigung auffordern

Standardwert: False
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 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

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 scheduled-query show

Details einer geplanten Abfrage anzeigen.

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

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 „Ressource id“-Argumente handeln. Sie sollten entweder „--ids“ oder andere „Resource Id“-Argumente 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

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 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 der "where"-Schlüsselwort (keyword) und mehrere Dimensionen abgefragt werden, indem sie mit dem Schlüsselwort (keyword) "and" kombiniert werden.

--condition-query

Abfragedeteils, um die Platzhalter im --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

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der „Ressource id“-Argumente handeln. Sie sollten entweder „--ids“ oder andere „Resource Id“-Argumente 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

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

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.