Condividi tramite

az monitor metrics alert

  • Riferimento

Gestire le regole di avviso delle metriche near realtime.

Comandi

Nome Descrizione Tipo Status
az monitor metrics alert condition

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

 Nucleo GA
az monitor metrics alert condition create

Creare una condizione della regola di avviso per le metriche.

 Nucleo Anteprima
az monitor metrics alert create

Creare una regola di avviso basata su metriche.

 Nucleo GA
az monitor metrics alert delete

Eliminare una regola di avviso basata sulle metriche.

 Nucleo GA
az monitor metrics alert dimension

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

 Nucleo GA
az monitor metrics alert dimension create

Creare una dimensione della regola di avviso delle metriche.

 Nucleo Anteprima
az monitor metrics alert list

Elencare le regole di avviso basate sulle metriche.

 Nucleo GA
az monitor metrics alert show

Visualizzare una regola di avviso basata sulle metriche.

 Nucleo GA
az monitor metrics alert update

Aggiornare una regola di avviso basata su metriche.

 Nucleo GA

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] [{>,><,<} VIOLAZIONI dinamiche DI RISERVATEZZA delle VALUTAZIONI [da DATETIME]] [dove DIMENSION {includes,excludes} VALUE [o 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 comando az monitor metrics list-definitions.

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ù di un argomento --condition.

--name -n

Nome della regola di avviso.

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

--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ù di un argomento --action.

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

Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio della Guida e esci.

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

Aumentare il livello di dettaglio della registrazione. Usare --debug per i 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 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".

--name -n

Nome della regola di avviso.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando 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

Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio della Guida e esci.

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

Aumentare il livello di dettaglio della registrazione. Usare --debug per i 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 usando az configure --defaults group=<name>.

Parametri globali
--debug

Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio della Guida e esci.

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

Aumentare il livello di dettaglio della registrazione. Usare --debug per i 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 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".

--name -n

Nome della regola di avviso.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando 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

Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio della Guida e esci.

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

Aumentare il livello di dettaglio della registrazione. Usare --debug per i 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, string or JSON string>.

--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ù di un argomento --add-action. 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] [{>,><,<} VIOLAZIONI dinamiche DI RISERVATEZZA delle VALUTAZIONI [da DATETIME]] [dove DIMENSION {includes,excludes} VALUE [o 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 comando az monitor metrics list-definitions.

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ù di un argomento --add-condition. 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 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".

--name -n

Nome della regola di avviso.

--remove

Rimuovere una proprietà o un elemento da un elenco. Esempio: --remove property.list <indexToRemove> 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 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. 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=<value>.

--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 formato ##h##m##s.

Parametri globali
--debug

Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio della Guida e esci.

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

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