Condividi tramite

az monitor scheduled-query

  • Riferimento

Nota

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 Stato
az monitor scheduled-query create

Creare una query pianificata.

 Estensione Disponibilità generale
az monitor scheduled-query delete

Eliminare una query pianificata.

 Estensione Disponibilità generale
az monitor scheduled-query list

Elencare tutte le query pianificate.

 Estensione Disponibilità generale
az monitor scheduled-query show

Visualizzare i dettagli di una query pianificata.

 Estensione Disponibilità generale
az monitor scheduled-query update

Aggiornare una query pianificata.

 Estensione Disponibilità generale

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

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

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

valori accettati: false, true
valore predefinito: True
--check-ws-alerts-storage --cwas

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

valori accettati: false, true
valore predefinito: False
--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.

valori accettati: false, true
valore predefinito: False
--evaluation-frequency

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

valore predefinito: 5m
--location -l

Posizione. Usare i valori ottenuti con az account list-locations. È possibile configurare la posizione predefinito con 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).

valore predefinito: 2
--skip-query-validation

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

valori accettati: false, true
valore predefinito: False
--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".

valore predefinito: 5m
Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

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

--subscription

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

--verbose

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

az monitor scheduled-query delete

Eliminare una query pianificata.

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

Parametri facoltativi

--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti 'ID risorsa'. È necessario specificare --ids o altri argomenti 'ID risorsa'.

--name -n

Nome della regola di query pianificata.

--resource-group -g

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

--subscription

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

--yes -y

Indica che non è richiesta la conferma.

valore predefinito: False
Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

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

--subscription

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

--verbose

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

az monitor scheduled-query list

Elencare tutte le query pianificate.

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

Parametri facoltativi

--resource-group -g

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

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

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

--subscription

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

--verbose

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

az monitor scheduled-query show

Visualizzare i dettagli di una query pianificata.

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

Parametri facoltativi

--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti 'ID risorsa'. È necessario specificare --ids o altri argomenti 'ID risorsa'.

--name -n

Nome della regola di query pianificata.

--resource-group -g

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

--subscription

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

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

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

--subscription

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

--verbose

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

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

Parametri facoltativi

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

valore predefinito: []
--auto-mitigate

Flag che indica se l'avviso deve essere risolto automaticamente o meno. Il 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.

valori accettati: false, true
--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 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.

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.

valore predefinito: False
--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti 'ID risorsa'. È necessario specificare --ids o altri argomenti 'ID risorsa'.

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

--remove

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

valore predefinito: []
--resource-group -g

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

--set

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

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.

valori accettati: false, true
--subscription

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

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

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

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

--subscription

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

--verbose

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