Condividi tramite

az monitor metrics alert

  • Riferimento

Gestire le regole di avviso delle metriche near realtime.

Comandi

Nome Descrizione Tipo Stato
az monitor metrics alert condition

Gestire le condizioni delle regole di avviso delle metriche near realtime.

 Core Disponibilità generale
az monitor metrics alert condition create

Creare una condizione della regola di avviso per le metriche.

 Core Anteprima
az monitor metrics alert create

Creare una regola di avviso basata su metriche.

 Core Disponibilità generale
az monitor metrics alert delete

Eliminare una regola di avviso basata sulle metriche.

 Core Disponibilità generale
az monitor metrics alert dimension

Gestire le dimensioni delle regole di avviso delle metriche quasi in tempo reale.

 Core Disponibilità generale
az monitor metrics alert dimension create

Creare una dimensione della regola di avviso delle metriche.

 Core Anteprima
az monitor metrics alert list

Elencare le regole di avviso basate sulle metriche.

 Core Disponibilità generale
az monitor metrics alert show

Visualizzare una regola di avviso basata sulle metriche.

 Core Disponibilità generale
az monitor metrics alert update

Aggiornare una regola di avviso basata su metriche.

 Core Disponibilità generale

az monitor metrics alert create

Modifica

Creare una regola di avviso basata su metriche.

az monitor metrics alert create --condition
                                --name
                                --resource-group
                                --scopes
                                [--action]
                                [--auto-mitigate {false, true}]
                                [--description]
                                [--disabled {false, true}]
                                [--evaluation-frequency]
                                [--region]
                                [--severity]
                                [--tags]
                                [--target-resource-type]
                                [--window-size]

Esempio

Creare un avviso di utilizzo elevato della CPU in una macchina virtuale senza alcuna azione.

az monitor metrics alert create -n alert1 -g {ResourceGroup} --scopes {VirtualMachineID} --condition "avg Percentage CPU > 90" --description "High CPU"

Creare un avviso di utilizzo elevato della CPU in una macchina virtuale con azioni di posta elettronica e webhook.

az monitor metrics alert create -n alert1 -g {ResourceGroup} --scopes {VirtualMachineID} \
    --condition "avg Percentage CPU > 90" --window-size 5m --evaluation-frequency 1m \
    --action "/subscriptions/<subscriptionId>/resourceGroups/<resourceGroupName>/providers/Microsoft.Insights/actionGroups/<actionGroupName>" apiKey={APIKey} type=HighCPU \
    --description "High CPU"

Creare un avviso quando un account di archiviazione mostra un numero elevato di transazioni lente, usando filtri multidimensionali.

az monitor metrics alert create -g {ResourceGroup} -n alert1 --scopes {StorageAccountId} \
    --description "Storage Slow Transactions" \
    --condition "total transactions > 5 where ResponseType includes Success" \
    --condition "avg SuccessE2ELatency > 250 where ApiName includes GetBlob"

Creare una regola di avviso basata su metriche che monitora una metrica personalizzata.

az monitor metrics alert create -n "metric alert rule on a custom metric" -g "Demos" --scopes {VirtualMachineID} \
    --condition "max Azure.VM.Windows.GuestMetrics.Memory\Available Bytes > 90" \
    --window-size 5m --evaluation-frequency 1m

Creare un avviso di utilizzo elevato della CPU in diverse macchine virtuali senza azioni.

az monitor metrics alert create -n alert1 -g {ResourceGroup} --scopes {VirtualMachineID1} {VirtualMachineID2} {VirtualMachineID3} \
    --condition "avg Percentage CPU > 90" --description "High CPU" --region westus

Creare un avviso di utilizzo della CPU dinamico in diverse macchine virtuali senza azioni.

az monitor metrics alert create -n alert1 -g {ResourceGroup} --scopes {VirtualMachineID1} {VirtualMachineID2} {VirtualMachineID3} \
    --condition "avg Percentage CPU > dynamic medium 2 of 4 since 2020-10-01T10:23:00.000Z"
    --description "Dynamic CPU"
    --window-size 5m
    --region westus

Parametri necessari

--condition

Condizione che attiva la regola. Può essere creato con il comando 'az monitor metrics alert condition create'.

Utilizzo: --condition {avg,min,max,total,count} [NAMESPACE.] METRICA [{=,!=,>,>=,<=<} THRESHOLD] [{<,>,}><DYNAMIC edizione Standard NSITIVITY VIOLATIONS of EVALUATIONS [since DATETIME]] [where DIMENSION {includes,excludes} VALUE [or VALUE ...] [e DIMENSION {includes,excludes} VALUE [o VALUE ...] ...]] [with skipmetricvalidation]

La sensibilità può essere "bassa", "media", "alta".

Le violazioni possono essere il numero di violazioni per attivare un avviso. Deve essere minore o uguale alla valutazione.

Le valutazioni possono essere il numero di periodi di valutazione per la soglia dinamica.

Datetime può essere la data da cui iniziare ad apprendere i dati cronologici delle metriche e calcolare le soglie dinamiche (in formato ISO8601).

È possibile eseguire query sulle dimensioni aggiungendo la parola chiave 'where' e è possibile eseguire query su più dimensioni combinandole con la parola chiave 'and'.

I valori per METRICa, DIMENSION e valori THRESHOLD appropriati possono essere ottenuti dal az monitor metrics list-definitions comando .

A causa della limitazione del server, quando una regola di avviso contiene più criteri, l'uso delle dimensioni è limitato a un valore per dimensione all'interno di ogni criterio.

È possibile specificare più condizioni usando più --condition argomenti.

--name -n

Nome della regola di avviso.

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

Aggiungere un gruppo di azioni e le proprietà facoltative del webhook da attivare quando viene attivato l'avviso.

Utilizzo: --action ACTION_GROUP_NAME_OR_ID [KEY=VAL [KEY=VAL ...]]

È possibile specificare più gruppi di azioni usando più --action argomenti.

--auto-mitigate

Risolvere automaticamente l'avviso.

valori accettati: false, true
--description

Descrizione in testo libero della regola.

--disabled

Creare la regola in uno stato disabilitato.

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

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

valore predefinito: 1m
--region --target-resource-region

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

--severity

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

valore predefinito: 2
--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 metrics alert delete

Modifica

Eliminare una regola di avviso basata sulle metriche.

az monitor metrics alert delete [--ids]
                                [--name]
                                [--resource-group]
                                [--subscription]

Esempio

Eliminare una regola di avviso basata sulle metriche.

az monitor metrics alert delete --name MyAlertRule --resource-group MyResourceGroup

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

--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 metrics alert list

Modifica

Elencare le regole di avviso basate sulle metriche.

az monitor metrics alert list [--resource-group]

Esempio

Elencare le regole di avviso basate sulle metriche.

az monitor metrics alert list --resource-group MyResourceGroup

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 metrics alert show

Modifica

Visualizzare una regola di avviso basata sulle metriche.

az monitor metrics alert show [--ids]
                              [--name]
                              [--resource-group]
                              [--subscription]

Esempio

Visualizzare una regola di avviso basata sulle metriche.

az --name MyAlertRule --resource-group MyResourceGroup

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

--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 metrics alert update

Modifica

Aggiornare una regola di avviso basata su metriche.

az monitor metrics alert update [--add]
                                [--add-action]
                                [--add-condition]
                                [--auto-mitigate {0, 1, f, false, n, no, t, true, y, yes}]
                                [--description]
                                [--enabled {0, 1, f, false, n, no, t, true, y, yes}]
                                [--evaluation-frequency]
                                [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                                [--ids]
                                [--name]
                                [--remove]
                                [--remove-actions]
                                [--remove-conditions]
                                [--resource-group]
                                [--scopes]
                                [--set]
                                [--severity]
                                [--subscription]
                                [--tags]
                                [--window-size]

Esempio

Disabilitare/Abilitare una regola di avviso basata su metriche.

az monitor metrics alert update --enabled false --name MyAlertRule --resource-group MyResourceGroup

Parametri facoltativi

--add

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

--add-action --add-actions

Aggiungere un gruppo di azioni e le proprietà facoltative del webhook da attivare quando viene attivato l'avviso.

Utilizzo: --add-action ACTION_GROUP_NAME_OR_ID [KEY=VAL [KEY=VAL ...]]

È possibile specificare più gruppi di azioni usando più --add-action argomenti. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

--add-condition --add-conditions

Aggiungere una condizione che attiva la regola.

Utilizzo: --add-condition {avg,min,max,total,count} [NAMESPACE.] METRICA [{=,!=,>,>=,<=<} THRESHOLD] [{<,>,}><DYNAMIC edizione Standard NSITIVITY VIOLATIONS of EVALUATIONS [since DATETIME]] [where DIMENSION {includes,excludes} VALUE [or VALUE ...] [e DIMENSION {includes,excludes} VALUE [o VALUE ...] ...]]

La sensibilità può essere "bassa", "media", "alta".

Le violazioni possono essere il numero di violazioni per attivare un avviso. Deve essere minore o uguale alla valutazione.

Le valutazioni possono essere il numero di periodi di valutazione per la soglia dinamica.

Datetime può essere la data da cui iniziare ad apprendere i dati cronologici delle metriche e calcolare le soglie dinamiche (in formato ISO8601).

È possibile eseguire query sulle dimensioni aggiungendo la parola chiave 'where' e è possibile eseguire query su più dimensioni combinandole con la parola chiave 'and'.

I valori per METRICa, DIMENSION e valori THRESHOLD appropriati possono essere ottenuti dal az monitor metrics list-definitions comando .

A causa della limitazione del server, quando una regola di avviso contiene più criteri, l'uso delle dimensioni è limitato a un valore per dimensione all'interno di ogni criterio.

È possibile specificare più condizioni usando più --add-condition argomenti. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

--auto-mitigate

Risolvere automaticamente l'avviso.

valori accettati: 0, 1, f, false, n, no, t, true, y, yes
--description

Descrizione in testo libero della regola.

--enabled

Indica se la regola di avviso della metrica è abilitata.

valori accettati: 0, 1, f, false, n, no, t, true, y, yes
--evaluation-frequency

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

--force-string

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

valori accettati: 0, 1, f, false, n, no, t, true, y, yes
--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 avviso.

--remove

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

--remove-actions

Elenco delimitato da spazi dei nomi dei gruppi di azioni da rimuovere. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

--remove-conditions

Elenco delimitato da spazi di nomi di condizione da rimuovere. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

--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. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

--set

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

--severity

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

--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] ...]. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

--window-size

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

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.