az monitor metrics

  • Riferimento

Visualizzare le metriche delle risorse di Azure.

Comandi

Nome Descrizione Tipo Stato
az monitor metrics alert

Gestire le regole di avviso delle metriche near realtime.

 Memoria centrale Disponibilità generale
az monitor metrics alert condition

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

 Memoria centrale Disponibilità generale
az monitor metrics alert condition create

Creare una condizione della regola di avviso per le metriche.

 Memoria centrale Anteprima
az monitor metrics alert create

Creare una regola di avviso basata su metriche.

 Memoria centrale Disponibilità generale
az monitor metrics alert delete

Eliminare una regola di avviso basata sulle metriche.

 Memoria centrale Disponibilità generale
az monitor metrics alert dimension

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

 Memoria centrale Disponibilità generale
az monitor metrics alert dimension create

Creare una dimensione della regola di avviso delle metriche.

 Memoria centrale Anteprima
az monitor metrics alert list

Elencare le regole di avviso basate sulle metriche.

 Memoria centrale Disponibilità generale
az monitor metrics alert show

Visualizzare una regola di avviso basata sulle metriche.

 Memoria centrale Disponibilità generale
az monitor metrics alert update

Aggiornare una regola di avviso basata su metriche.

 Memoria centrale Disponibilità generale
az monitor metrics list

Elencare i valori delle metriche per una risorsa.

 Memoria centrale Disponibilità generale
az monitor metrics list-definitions

Elencare le definizioni delle metriche per la risorsa.

 Memoria centrale Disponibilità generale
az monitor metrics list-namespaces

Elencare gli spazi dei nomi delle metriche per la risorsa.

 Memoria centrale Anteprima
az monitor metrics list-sub

Elenca i dati delle metriche per una sottoscrizione. I parametri possono essere specificati nel corpo.

 Memoria centrale Disponibilità generale
az monitor metrics list-sub-definitions

Elencare le definizioni delle metriche per la sottoscrizione.

 Memoria centrale Disponibilità generale

az monitor metrics list

Modifica

Elencare i valori delle metriche per una risorsa.

az monitor metrics list --resource
                        [--aggregation {Average, Count, Maximum, Minimum, None, Total}]
                        [--dimension]
                        [--end-time]
                        [--filter]
                        [--interval]
                        [--metadata]
                        [--metrics]
                        [--namespace]
                        [--offset]
                        [--orderby]
                        [--resource-group]
                        [--resource-namespace]
                        [--resource-parent]
                        [--resource-type]
                        [--start-time]
                        [--top]

Esempio

Elencare l'utilizzo della CPU di una macchina virtuale per l'ultima ora

az monitor metrics list --resource {ResourceName} --metric "Percentage CPU"

Elencare la latenza E2E riuscita di un account di archiviazione e dividere la serie di dati in base al nome dell'API

az monitor metrics list --resource {ResourceName} --metric SuccessE2ELatency \
                        --dimension ApiName

Elencare la latenza E2E riuscita di un account di archiviazione e suddividere la serie di dati in base al nome dell'API e al tipo geografico

az monitor metrics list --resource {ResourceName} --metric SuccessE2ELatency \
                        --dimension ApiName GeoType

Elencare la latenza E2E riuscita di un account di archiviazione e suddividere la serie di dati in base al nome DELL'API e al tipo geografico usando il parametro "--filter"

az monitor metrics list --resource {ResourceName} --metric SuccessE2ELatency \
                        --filter "ApiName eq '*' and GeoType eq '*'"

Elencare la latenza E2E riuscita di un account di archiviazione e suddividere la serie di dati in base al nome dell'API e al tipo geografico. Limita il nome dell'API a 'DeleteContainer'

az monitor metrics list --resource {ResourceName} --metric SuccessE2ELatency \
                        --filter "ApiName eq 'DeleteContainer' and GeoType eq '*'"

Elencare le transazioni di un account di archiviazione al giorno dal 2017-01-01

az monitor metrics list --resource {ResourceName} --metric Transactions \
                        --start-time 2017-01-01T00:00:00Z \
                        --interval PT24H

Elencare i valori dei metadati per un account di archiviazione nella dimensione del nome API della metrica delle transazioni dal 2017

az monitor metrics list --resource {ResourceName} --metric Transactions \
                        --filter "ApiName eq '*'" \
                        --start-time 2017-01-01T00:00:00Z

Parametri necessari

--resource

Nome o ID della risorsa di destinazione.

Parametri facoltativi

--aggregation

Elenco di tipi di aggregazione (separati da spazi) da recuperare.

valori accettati: Average, Count, Maximum, Minimum, None, Total
valore da: az monitor metrics list-definitions
--dimension

L'elenco di dimensioni (separate da spazi) in cui vengono eseguite query sulle metriche.

valore da: az monitor metrics list-definitions
--end-time

Ora di fine della query. Il valore predefinito è l'ora corrente. Formato: fuso orario (aaaaa-mm-gg) (hh:mm:ss.xxxxx) fuso orario (+/-hh:mm).

--filter

Stringa usata per ridurre il set di dati delle metriche restituiti. Ad esempio: "BlobType eq '*'".

Per un elenco completo dei filtri, vedere il riferimento alla stringa di filtro in https://docs.microsoft.com/rest/api/monitor/metrics/list.

--interval

Intervallo in cui aggregare le metriche, in formato ##h##m.

valore predefinito: 1m
--metadata

Restituisce i valori dei metadati anziché i dati delle metriche.

--metrics

Elenco delimitato da spazi dei nomi delle metriche da recuperare.

valore da: az monitor metrics list-definitions
--namespace

Spazio dei nomi per cui eseguire query sulle definizioni delle metriche.

valore da: az monitor metrics list-namespaces
--offset

Offset temporale dell'intervallo di query, in formato ##d##h.

Può essere usato con --start-time o --end-time. Se usato con --start-time, l'ora di fine verrà calcolata aggiungendo l'offset. Se usato con --end-time (impostazione predefinita), l'ora di inizio verrà calcolata sottraendo l'offset. Se vengono forniti --start-time e --end-time, --offset verrà ignorato.

valore predefinito: 1h
--orderby

Aggregazione da utilizzare per l'ordinamento dei risultati e la direzione dell'ordinamento. È possibile specificare un solo ordine. Esempi: somma asc.

--resource-group -g

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

--resource-namespace

Spazio dei nomi del provider di risorse di destinazione.

--resource-parent

Percorso padre della risorsa di destinazione, se applicabile.

--resource-type

Tipo di risorsa di destinazione. Può anche accettare il formato spazio dei nomi/tipo (ad esempio: 'Microsoft.Compute/virtualMachines').

--start-time

Ora di inizio della query. Formato: fuso orario (aaaaa-mm-gg) (hh:mm:ss.xxxxx) fuso orario (+/-hh:mm).

--top

Numero massimo di record da recuperare.

valore predefinito: 10
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 list-definitions

Modifica

Elencare le definizioni delle metriche per la risorsa.

az monitor metrics list-definitions --resource
                                    [--namespace]
                                    [--resource-group]
                                    [--resource-namespace]
                                    [--resource-parent]
                                    [--resource-type]

Esempio

Elencare le definizioni delle metriche per la risorsa. (generato automaticamente)

az monitor metrics list-definitions --resource /subscriptions/{subscriptionID}/resourceGroups/{resourceGroup}/Microsoft.Network/networkSecurityGroups/{resourceName}

Parametri necessari

--resource

Nome o ID della risorsa di destinazione.

Parametri facoltativi

--namespace

Spazio dei nomi per cui eseguire query sulle definizioni delle metriche.

valore da: az monitor metrics list-namespaces
--resource-group -g

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

--resource-namespace

Spazio dei nomi del provider di risorse di destinazione.

--resource-parent

Percorso padre della risorsa di destinazione, se applicabile.

--resource-type

Tipo di risorsa di destinazione. Può anche accettare il formato spazio dei nomi/tipo (ad esempio: 'Microsoft.Compute/virtualMachines').

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

Modifica
Anteprima

Questo comando è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Elencare gli spazi dei nomi delle metriche per la risorsa.

az monitor metrics list-namespaces --resource-uri
                                   [--start-time]

Esempio

Elencare gli spazi dei nomi delle metriche per la risorsa.

az monitor metrics list-namespaces --resource /subscriptions/{subscriptionID}/resourceGroups/{resourceGroup}/Microsoft.Network/networkSecurityGroups/{resourceName} --start-time 2021-03-01T00:00:00Z

Parametri necessari

--resource-uri

Identificatore della risorsa.

Parametri facoltativi

--start-time

Ora di inizio della query. Formato: fuso orario (aaaaa-mm-gg) (hh:mm:ss.xxxxx) fuso orario (+/-hh:mm).

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

Modifica

Elenca i dati delle metriche per una sottoscrizione. I parametri possono essere specificati nel corpo.

az monitor metrics list-sub --region
                            [--aggregation]
                            [--auto-adjust-timegrain {0, 1, f, false, n, no, t, true, y, yes}]
                            [--filter]
                            [--interval]
                            [--metricnames]
                            [--metricnamespace]
                            [--order-by]
                            [--result-type {Data, Metadata}]
                            [--roll-up-by]
                            [--timespan]
                            [--top]
                            [--validate-dimensions {0, 1, f, false, n, no, t, true, y, yes}]

Parametri necessari

--region

Area in cui si trovano le metriche desiderate.

Parametri facoltativi

--aggregation

Elenco di tipi di aggregazione (delimitati da virgole) da recuperare.

--auto-adjust-timegrain

Se impostato su true, se l'intervallo di tempo passato non è supportato da questa metrica, l'API restituirà il risultato usando l'intervallo di tempo supportato più vicino. Se impostato su false, viene restituito un errore per i parametri timespan non validi. Il valore predefinito è falso.

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

Il $filter viene usato per ridurre il set di dati delle metriche restituiti.
Esempio:
La metrica contiene metadati A, B e C.
- Restituisce tutte le serie temporali di C dove A = a1 e B = b1 o b2
$filter=A eq 'a1' e B eq 'b1' o B eq 'b2' eq '*'
- Variante non valida:
$filter=A eq 'a1' e B eq 'b1' eq '*' o B = 'b2'
Non è valido perché l'operatore logico o non può separare due nomi di metadati diversi.
- Restituisce tutte le serie temporali in cui A = a1, B = b1 e C = c1:
$filter=A eq 'a1' e B eq 'b1' e C eq 'c1'
- Restituisce tutte le serie temporali in cui A = a1
$filter=A eq 'a1' e B eq '' eq ''.

--interval

Intervallo (ad esempio timegrain) della query nel formato di durata ISO 8601. Il valore predefinito è PT1M. Caso speciale per il valore 'FULL' che restituisce un singolo punto dati per l'intero intervallo di tempo richiesto. Esempi: PT15M, PT1H, P1D, FULL.

--metricnames

Nomi delle metriche (delimitate da virgole) da recuperare.

--metricnamespace

Spazio dei nomi della metrica in cui risiedono le metriche desiderate.

--order-by

Aggregazione da utilizzare per l'ordinamento dei risultati e la direzione dell'ordinamento. È possibile specificare un solo ordine. Esempi: somma asc.

--result-type

Riduce il set di dati raccolti. La sintassi consentita dipende dall'operazione. Per informazioni dettagliate, vedere la descrizione dell'operazione.

valori accettati: Data, Metadata
--roll-up-by

Nomi delle dimensioni per cui eseguire il rollup dei risultati. Ad esempio, se si vogliono visualizzare solo i valori delle metriche con un filtro come "City eq Seattle o City eq Tacoma", ma non si vogliono visualizzare valori separati per ogni città, è possibile specificare "RollUpBy=City" per visualizzare i risultati per Seattle e Tacoma distribuiti in un'unica occorrenza.

--timespan

Intervallo di tempo della query. Si tratta di una stringa con il formato seguente 'startDateTime_ISO/endDateTime_ISO'.

--top

Numero massimo di record da recuperare. Valido solo se viene specificato $filter. Il valore predefinito è 10.

--validate-dimensions

Se impostato su false, i valori dei parametri di filtro non validi verranno ignorati. Se impostato su true, viene restituito un errore per i parametri di filtro non validi. il valore predefinito è true.

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

Modifica

Elencare le definizioni delle metriche per la sottoscrizione.

az monitor metrics list-sub-definitions --region
                                        [--metricnamespace]

Parametri necessari

--region

Area in cui si trovano le metriche desiderate.

Parametri facoltativi

--metricnamespace

Spazio dei nomi della metrica in cui risiedono le metriche desiderate.

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.