az monitor scheduled-query

Note

Questo riferimento fa parte dell'estensione di query pianificata per l'interfaccia della riga di comando di Azure (versione 2.54.0 o successiva). L'estensione installerà automaticamente la prima volta che si esegue un comando az monitor scheduled-query . Altre informazioni sulle estensioni.

Comandi per gestire le query pianificate.

Comandi

Nome	Descrizione	Tipo	Status
az monitor scheduled-query create	Creare una query pianificata.	Extension	GA
az monitor scheduled-query delete	Eliminare una query pianificata.	Extension	GA
az monitor scheduled-query list	Elencare tutte le query pianificate.	Extension	GA
az monitor scheduled-query show	Visualizzare i dettagli di una query pianificata.	Extension	GA
az monitor scheduled-query update	Aggiornare una query pianificata.	Extension	GA

az monitor scheduled-query create

Creare una query pianificata.

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]

Esempio

Creare una query pianificata per una macchina virtuale.

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"

Creare una query pianificata per le macchine virtuali in un gruppo di risorse.

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"

Parametri necessari

--condition

Condizione che attiva la regola.

Utilizzo: --condition {avg,min,max,total,count} ["METRIC COLUMN" from] "QUERY_PLACEHOLDER" {=,!=,>,>=,<,<=} THRESHOLD [resource id RESOURCEID] [where DIMENSION {includes,excludes} VALUE [or VALUE ...] [e DIMENSION {includes,excludes} VALUE [o VALUE ...] ...]] [almeno le violazioni MinTimeToFail dai punti aggregati EvaluationPeriod]' I segnaposto della query possono essere definiti in --condition-query argument Dimensions può essere sottoposto a query aggiungendo la parola chiave 'where' e più dimensioni possono essere sottoposte a query combinandole con la parola chiave 'and'.

--name -n

Nome della regola di query pianificata.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando az configure --defaults group=<name>.

--scopes

Elenco delimitato da spazi degli ambiti a cui si applica la regola. Le risorse specificate in questo parametro devono essere dello stesso tipo ed essere presenti nella stessa posizione.

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--action-groups

ID risorsa gruppo di azioni da richiamare quando viene generato l'avviso.

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

--auto-mitigate

Flag che indica se l'avviso deve essere risolto automaticamente o meno. Il valore predefinito è true.

Proprietà	Valore
Valore predefinito:	True
Valori accettati:	false, true

--check-ws-alerts-storage --cwas

Flag che indica se questa regola di query pianificata deve essere archiviata nella risorsa di archiviazione del cliente.

Proprietà	Valore
Valore predefinito:	False
Valori accettati:	false, true

--condition-query

Eseguire una query per sostituire i segnaposto nell'argomento --condition.

--custom-properties

Proprietà di un payload di avviso.

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

--description

Descrizione in testo libero della regola.

--disabled

Disabilitare la query pianificata.

Proprietà	Valore
Valore predefinito:	False
Valori accettati:	false, true

--evaluation-frequency

Frequenza con cui valutare la regola in formato "##h##m##s".

Proprietà	Valore
Valore predefinito:	5m

--location -l

Location. Usare i valori ottenuti con az account list-locations. È possibile configurare il percorso predefinito usando az configure --defaults location=<location>.

--mad --mute-actions-duration

Disattivare le azioni per il periodo di tempo scelto (in formato di durata ISO 8601) dopo l'invio dell'avviso.

--severity

Gravità dell'avviso da 0 (critico) a 4 (dettagliato).

Proprietà	Valore
Valore predefinito:	2

--skip-query-validation

Flag che indica se la query specificata deve essere convalidata o meno.

Proprietà	Valore
Valore predefinito:	False
Valori accettati:	false, true

--tags

Tag separati da spazi: key[=value] [key[=value] ...]. Usare "" per cancellare i tag esistenti.

--target-resource-type --type

Tipo di risorsa delle risorse di destinazione negli ambiti. Questa operazione deve essere specificata quando gli ambiti sono gruppo di risorse o sottoscrizione.

--window-size

Tempo in cui aggregare le metriche nel formato "##h##m##s".

Proprietà	Valore
Valore predefinito:	5m

Parametri globali

--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà	Valore
Valore predefinito:	False

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà	Valore
Valore predefinito:	False

--output -o

Formato dell'output.

Proprietà	Valore
Valore predefinito:	json
Valori accettati:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Proprietà	Valore
Valore predefinito:	False

az monitor scheduled-query delete

Eliminare una query pianificata.

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

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--ids

Uno o più ID risorsa (delimitati da spazi). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".

Proprietà	Valore
Gruppo di parametri:	Resource Id Arguments

--name -n

Nome della regola di query pianificata.

Proprietà	Valore
Gruppo di parametri:	Resource Id Arguments

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando az configure --defaults group=<name>.

Proprietà	Valore
Gruppo di parametri:	Resource Id Arguments

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

Proprietà	Valore
Gruppo di parametri:	Resource Id Arguments

--yes -y

Non richiedere conferma.

Proprietà	Valore
Valore predefinito:	False

Parametri globali

--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà	Valore
Valore predefinito:	False

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà	Valore
Valore predefinito:	False

--output -o

Formato dell'output.

Proprietà	Valore
Valore predefinito:	json
Valori accettati:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Proprietà	Valore
Valore predefinito:	False

az monitor scheduled-query list

Elencare tutte le query pianificate.

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

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando az configure --defaults group=<name>.

Parametri globali

--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà	Valore
Valore predefinito:	False

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà	Valore
Valore predefinito:	False

--output -o

Formato dell'output.

Proprietà	Valore
Valore predefinito:	json
Valori accettati:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Proprietà	Valore
Valore predefinito:	False

az monitor scheduled-query show

Visualizzare i dettagli di una query pianificata.

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

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--ids

Proprietà	Valore
Gruppo di parametri:	Resource Id Arguments

--name -n

Nome della regola di query pianificata.

Proprietà	Valore
Gruppo di parametri:	Resource Id Arguments

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando az configure --defaults group=<name>.

Proprietà	Valore
Gruppo di parametri:	Resource Id Arguments

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

Proprietà	Valore
Gruppo di parametri:	Resource Id Arguments

Parametri globali

--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà	Valore
Valore predefinito:	False

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà	Valore
Valore predefinito:	False

--output -o

Formato dell'output.

Proprietà	Valore
Valore predefinito:	json
Valori accettati:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Proprietà	Valore
Valore predefinito:	False

az monitor scheduled-query update

Aggiornare una query pianificata.

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]

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--action-groups

ID risorsa gruppo di azioni da richiamare quando viene generato l'avviso.

--add

Aggiungere un oggetto a un elenco di oggetti specificando un percorso e coppie chiave-valore. Esempio: --add property.listProperty <key=value, string or JSON string>.

Proprietà	Valore
Gruppo di parametri:	Generic Update Arguments
Valore predefinito:	[]

--auto-mitigate

Flag che indica se l'avviso deve essere risolto automaticamente o meno. Il valore predefinito è true.

Proprietà	Valore
Valori accettati:	false, true

--check-ws-alerts-storage --cwas

Flag che indica se questa regola di query pianificata deve essere archiviata nella risorsa di archiviazione del cliente.

Proprietà	Valore
Valori accettati:	false, true

--condition

Condizione che attiva la regola.

I segnaposto della query possono essere definiti nell'argomento --condition-query Le dimensioni possono essere sottoposte a query aggiungendo la parola chiave 'where' e più dimensioni, combinandole con la parola chiave 'and'.

--condition-query

Eseguire una query per sostituire i segnaposto nell'argomento --condition.

--custom-properties

Proprietà di un payload di avviso.

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

--description

Descrizione in testo libero della regola.

--disabled

Disabilitare la query pianificata.

Proprietà	Valore
Valori accettati:	false, true

--evaluation-frequency

Frequenza con cui valutare la regola in formato "##h##m##s".

--force-string

Quando si usa 'set' o 'add', mantenere i valori letterali stringa anziché tentare di eseguire la conversione in JSON.

Proprietà	Valore
Gruppo di parametri:	Generic Update Arguments
Valore predefinito:	False

--ids

Proprietà	Valore
Gruppo di parametri:	Resource Id Arguments

--mad --mute-actions-duration

Disattivare le azioni per il periodo di tempo scelto (in formato di durata ISO 8601) dopo l'invio dell'avviso.

--name -n

Nome della regola di query pianificata.

Proprietà	Valore
Gruppo di parametri:	Resource Id Arguments

--remove

Rimuovere una proprietà o un elemento da un elenco. Esempio: --remove property.list <indexToRemove> OR --remove propertyToRemove.

Proprietà	Valore
Gruppo di parametri:	Generic Update Arguments
Valore predefinito:	[]

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando az configure --defaults group=<name>.

Proprietà	Valore
Gruppo di parametri:	Resource Id Arguments

--set

Aggiornare un oggetto specificando un percorso di proprietà e un valore da impostare. Esempio: --set property1.property2=<value>.

Proprietà	Valore
Gruppo di parametri:	Generic Update Arguments
Valore predefinito:	[]

--severity

Gravità dell'avviso da 0 (critico) a 4 (dettagliato).

--skip-query-validation

Flag che indica se la query specificata deve essere convalidata o meno.

Proprietà	Valore
Valori accettati:	false, true

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

Proprietà	Valore
Gruppo di parametri:	Resource Id Arguments

--tags

Tag separati da spazi: key[=value] [key[=value] ...]. Usare "" per cancellare i tag esistenti.

--target-resource-type --type

Tipo di risorsa delle risorse di destinazione negli ambiti. Questa operazione deve essere specificata quando gli ambiti sono gruppo di risorse o sottoscrizione.

--window-size

Tempo in cui aggregare le metriche nel formato "##h##m##s".

Parametri globali

--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà	Valore
Valore predefinito:	False

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà	Valore
Valore predefinito:	False

--output -o

Formato dell'output.

Proprietà	Valore
Valore predefinito:	json
Valori accettati:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Proprietà	Valore
Valore predefinito:	False

Commenti e suggerimenti

Questa pagina è stata utile?

Condividi tramite

az monitor scheduled-query

Comandi

az monitor scheduled-query create

Esempio

Parametri necessari

Parametri facoltativi

az monitor scheduled-query delete

Parametri facoltativi

az monitor scheduled-query list

Parametri facoltativi

az monitor scheduled-query show

Parametri facoltativi

az monitor scheduled-query update

Parametri facoltativi

Commenti e suggerimenti