az monitor metrics alert

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.	Core	GA
az monitor metrics alert condition create	Creare una condizione della regola di avviso per le metriche.	Core	Preview
az monitor metrics alert create	Creare una regola di avviso basata su metriche.	Core	GA
az monitor metrics alert delete	Eliminare una regola di avviso basata sulle metriche.	Core	GA
az monitor metrics alert dimension	Gestire le dimensioni delle regole di avviso delle metriche quasi in tempo reale.	Core	GA
az monitor metrics alert dimension create	Creare una dimensione della regola di avviso delle metriche.	Core	Preview
az monitor metrics alert list	Elencare le regole di avviso basate sulle metriche.	Core	GA
az monitor metrics alert show	Visualizzare una regola di avviso basata sulle metriche.	Core	GA
az monitor metrics alert update	Aggiornare una regola di avviso basata su metriche.	Core	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 --target-resource-region]
                                [--severity]
                                [--tags]
                                [--target-resource-type --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

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

Proprietà	Valore
Valori accettati:	false, true

--description

Descrizione in testo libero della regola.

--disabled

Creare la regola in uno stato disabilitato.

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

Proprietà	Valore
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".

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

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

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

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

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

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

Modifica

Aggiornare una regola di avviso basata su metriche.

az monitor metrics alert update [--add]
                                [--add-action --add-actions]
                                [--add-condition --add-conditions]
                                [--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

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

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

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

Proprietà	Valore
Gruppo di parametri:	Action Arguments

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

Proprietà	Valore
Gruppo di parametri:	Condition Arguments

--auto-mitigate

Risolvere automaticamente l'avviso.

Proprietà	Valore
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.

Proprietà	Valore
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.

Proprietà	Valore
Gruppo di parametri:	Generic Update Arguments
Valori accettati:	0, 1, f, false, n, no, t, true, y, yes

--ids

Proprietà	Valore
Gruppo di parametri:	Resource Id Arguments

--name -n

Nome della regola di avviso.

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

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

Proprietà	Valore
Gruppo di parametri:	Action Arguments

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

Proprietà	Valore
Gruppo di parametri:	Condition 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

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

Proprietà	Valore
Gruppo di parametri:	Generic Update Arguments

--severity

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

--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] ...]. 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 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 metrics alert

Comandi

az monitor metrics alert create

Esempio

Parametri necessari

Parametri facoltativi

az monitor metrics alert delete

Esempio

Parametri facoltativi

az monitor metrics alert list

Esempio

Parametri facoltativi

az monitor metrics alert show

Esempio

Parametri facoltativi

az monitor metrics alert update

Esempio

Parametri facoltativi

Commenti e suggerimenti