Dela via


az monitor scheduled-query

Note

Den här referensen är en del av tillägget scheduled-query för Azure CLI (version 2.54.0 eller senare). Tillägget installeras automatiskt första gången du kör ett az monitor scheduled-query kommando. Läs mer om tillägg.

Kommandon för att hantera schemalagda frågor.

Kommandon

Name Description Typ Status
az monitor scheduled-query create

Skapa en schemalagd fråga.

Extension GA
az monitor scheduled-query delete

Ta bort en schemalagd fråga.

Extension GA
az monitor scheduled-query list

Visa en lista över alla schemalagda frågor.

Extension GA
az monitor scheduled-query show

Visa information om en schemalagd fråga.

Extension GA
az monitor scheduled-query update

Uppdatera en schemalagd fråga.

Extension GA

az monitor scheduled-query create

Skapa en schemalagd fråga.

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

Exempel

Skapa en schemalagd fråga för en virtuell dator.

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"

Skapa en schemalagd fråga för virtuella datorer i en resursgrupp.

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"

Obligatoriska parametrar

--condition

Villkoret som utlöser regeln.

Användning: --condition {avg,min,max,total,count} ["METRIC COLUMN" from] "QUERY_PLACEHOLDER" {=,!=,>,>=,<,<=} THRESHOLD [resource id RESOURCEID] [where DIMENSION {includes,excludes} VALUE [or VALUE ...] [and DIMENSION {includes,excludes} VALUE [or VALUE ...] ...]] [Minst MinTimeToFail-överträdelser från Sammanställda poäng för EvaluationPeriod]' Frågeplatshållare kan definieras i --condition-query argument Dimensioner kan efterfrågas genom att lägga till nyckelordet "where" och flera dimensioner kan efterfrågas genom att kombinera dem med nyckelordet "och".

--name -n

Namnet på den schemalagda frågeregeln.

--resource-group -g

Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

--scopes

Utrymmesavgränsad lista över omfång som regeln gäller för. Resurserna som anges i den här parametern måste vara av samma typ och finnas på samma plats.

Valfria parametrar

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--action-groups

Resurs-ID för åtgärdsgrupp som ska anropas när aviseringen utlöses.

Användning: --action-groups ACTION_GROUP_NAME_OR_ID [NAME_OR_ID,...].

--auto-mitigate

Flaggan som anger om aviseringen ska matchas automatiskt eller inte. Standardvärdet är sant.

Egenskap Värde
Standardvärde: True
Godkända värden: false, true
--check-ws-alerts-storage --cwas

Flaggan som anger om den här schemalagda frågeregeln ska lagras i kundens lagring.

Egenskap Värde
Standardvärde: False
Godkända värden: false, true
--condition-query

Frågan deteils för att ersätta platshållarna i --condition argument.

--custom-properties

Egenskaperna för en aviseringsnyttolast.

Användning: --custom-properties ALERT_PAYLOAD_PROPERTIES [KEY=VAL,KEY=VAL ...].

--description

Beskrivning av regeln i fritext.

--disabled

Inaktivera den schemalagda frågan.

Egenskap Värde
Standardvärde: False
Godkända värden: false, true
--evaluation-frequency

Frekvens som regeln ska utvärderas med i formatet "##h##m##s".

Egenskap Värde
Standardvärde: 5m
--location -l

Location. Värden från: az account list-locations. Du kan konfigurera standardplatsen med hjälp av az configure --defaults location=<location>.

--mad --mute-actions-duration

Stäng av åtgärder för den valda tidsperioden (i ISO 8601-varaktighetsformat) efter att aviseringen har utlösts.

--severity

Allvarlighetsgraden för aviseringen från 0 (kritisk) till 4 (utförlig).

Egenskap Värde
Standardvärde: 2
--skip-query-validation

Flaggan som anger om den angivna frågan ska verifieras eller inte.

Egenskap Värde
Standardvärde: False
Godkända värden: false, true
--tags

Blankstegsavgränsade taggar: key[=value] [key[=value] ...]. Använd "" för att rensa befintliga taggar.

--target-resource-type --type

Resurstypen för målresurserna i omfång. Detta måste anges när omfång är resursgrupp eller prenumeration.

--window-size

Tid för att aggregera mått i formatet "##h##m##s".

Egenskap Värde
Standardvärde: 5m
Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

Egenskap Värde
Standardvärde: False
--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap Värde
Standardvärde: False
--output -o

Utdataformat.

Egenskap Värde
Standardvärde: json
Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

Egenskap Värde
Standardvärde: False

az monitor scheduled-query delete

Ta bort en schemalagd fråga.

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

Valfria parametrar

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--ids

Ett eller flera resurs-ID:t (utrymmesavgränsade). Det bör vara ett fullständigt resurs-ID som innehåller all information om 'resurs-ID' argumenten. Du bör ange antingen --id eller andra "Resurs-ID"-argument.

Egenskap Värde
Parameter group: Resource Id Arguments
--name -n

Namnet på den schemalagda frågeregeln.

Egenskap Värde
Parameter group: Resource Id Arguments
--resource-group -g

Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

Egenskap Värde
Parameter group: Resource Id Arguments
--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

Egenskap Värde
Parameter group: Resource Id Arguments
--yes -y

Fråga inte efter bekräftelse.

Egenskap Värde
Standardvärde: False
Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

Egenskap Värde
Standardvärde: False
--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap Värde
Standardvärde: False
--output -o

Utdataformat.

Egenskap Värde
Standardvärde: json
Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

Egenskap Värde
Standardvärde: False

az monitor scheduled-query list

Visa en lista över alla schemalagda frågor.

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

Valfria parametrar

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--resource-group -g

Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

Egenskap Värde
Standardvärde: False
--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap Värde
Standardvärde: False
--output -o

Utdataformat.

Egenskap Värde
Standardvärde: json
Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

Egenskap Värde
Standardvärde: False

az monitor scheduled-query show

Visa information om en schemalagd fråga.

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

Valfria parametrar

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--ids

Ett eller flera resurs-ID:t (utrymmesavgränsade). Det bör vara ett fullständigt resurs-ID som innehåller all information om 'resurs-ID' argumenten. Du bör ange antingen --id eller andra "Resurs-ID"-argument.

Egenskap Värde
Parameter group: Resource Id Arguments
--name -n

Namnet på den schemalagda frågeregeln.

Egenskap Värde
Parameter group: Resource Id Arguments
--resource-group -g

Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

Egenskap Värde
Parameter group: Resource Id Arguments
--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

Egenskap Värde
Parameter group: Resource Id Arguments
Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

Egenskap Värde
Standardvärde: False
--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap Värde
Standardvärde: False
--output -o

Utdataformat.

Egenskap Värde
Standardvärde: json
Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

Egenskap Värde
Standardvärde: False

az monitor scheduled-query update

Uppdatera en schemalagd fråga.

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

Valfria parametrar

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--action-groups

Resurs-ID för åtgärdsgrupp som ska anropas när aviseringen utlöses.

--add

Lägg till ett objekt i en lista över objekt genom att ange en sökväg och nyckelvärdepar. Exempel: --add property.listProperty <key=value, string or JSON string>.

Egenskap Värde
Parameter group: Generic Update Arguments
Standardvärde: []
--auto-mitigate

Flaggan som anger om aviseringen ska matchas automatiskt eller inte. Standardvärdet är sant.

Egenskap Värde
Godkända värden: false, true
--check-ws-alerts-storage --cwas

Flaggan som anger om den här schemalagda frågeregeln ska lagras i kundens lagring.

Egenskap Värde
Godkända värden: false, true
--condition

Villkoret som utlöser regeln.

Användning: --condition {avg,min,max,total,count} ["METRIC COLUMN" from] "QUERY_PLACEHOLDER" {=,!=,>,>=,<,<=} THRESHOLD [resource id RESOURCEID] [where DIMENSION {includes,excludes} VALUE [or VALUE ...] [and DIMENSION {includes,excludes} VALUE [or VALUE ...] ...]] [minst MinTimeToFail-överträdelser från EvaluationPeriods aggregerade punkter]'

Frågeplatshållare kan definieras i --condition-query argument Dimensioner kan efterfrågas genom att lägga till nyckelordet "var" och flera dimensioner kan efterfrågas genom att kombinera dem med nyckelordet "och".

--condition-query

Frågan deteils för att ersätta platshållarna i --condition argument.

--custom-properties

Egenskaperna för en aviseringsnyttolast.

Användning: --custom-properties ALERT_PAYLOAD_PROPERTIES [KEY=VAL,KEY=VAL ...].

--description

Beskrivning av regeln i fritext.

--disabled

Inaktivera den schemalagda frågan.

Egenskap Värde
Godkända värden: false, true
--evaluation-frequency

Frekvens som regeln ska utvärderas med i formatet "##h##m##s".

--force-string

När du använder "set" eller "add" bevarar du strängliteraler i stället för att försöka konvertera till JSON.

Egenskap Värde
Parameter group: Generic Update Arguments
Standardvärde: False
--ids

Ett eller flera resurs-ID:t (utrymmesavgränsade). Det bör vara ett fullständigt resurs-ID som innehåller all information om 'resurs-ID' argumenten. Du bör ange antingen --id eller andra "Resurs-ID"-argument.

Egenskap Värde
Parameter group: Resource Id Arguments
--mad --mute-actions-duration

Stäng av åtgärder för den valda tidsperioden (i ISO 8601-varaktighetsformat) efter att aviseringen har utlösts.

--name -n

Namnet på den schemalagda frågeregeln.

Egenskap Värde
Parameter group: Resource Id Arguments
--remove

Ta bort en egenskap eller ett element från en lista. Exempel: --remove property.list <indexToRemove> ELLER --remove propertyToRemove.

Egenskap Värde
Parameter group: Generic Update Arguments
Standardvärde: []
--resource-group -g

Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

Egenskap Värde
Parameter group: Resource Id Arguments
--set

Uppdatera ett objekt genom att ange en egenskapssökväg och ett värde som ska anges. Exempel: --set property1.property2=<value>.

Egenskap Värde
Parameter group: Generic Update Arguments
Standardvärde: []
--severity

Allvarlighetsgraden för aviseringen från 0 (kritisk) till 4 (utförlig).

--skip-query-validation

Flaggan som anger om den angivna frågan ska verifieras eller inte.

Egenskap Värde
Godkända värden: false, true
--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

Egenskap Värde
Parameter group: Resource Id Arguments
--tags

Blankstegsavgränsade taggar: key[=value] [key[=value] ...]. Använd "" för att rensa befintliga taggar.

--target-resource-type --type

Resurstypen för målresurserna i omfång. Detta måste anges när omfång är resursgrupp eller prenumeration.

--window-size

Tid för att aggregera mått i formatet "##h##m##s".

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

Egenskap Värde
Standardvärde: False
--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap Värde
Standardvärde: False
--output -o

Utdataformat.

Egenskap Värde
Standardvärde: json
Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

Egenskap Värde
Standardvärde: False