Condividi tramite


az monitor metrics

Visualizzare le metriche delle risorse di Azure.

Comandi

Nome Descrizione Tipo Status
az monitor metrics alert

Gestire le regole di avviso delle metriche near realtime.

Core GA
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 list

Elencare i valori delle metriche per una risorsa.

Core GA
az monitor metrics list-definitions

Elencare le definizioni delle metriche per la risorsa.

Core GA
az monitor metrics list-namespaces

Elencare gli spazi dei nomi delle metriche per la risorsa.

Core Preview
az monitor metrics list-sub

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

Core GA
az monitor metrics list-sub-definitions

Elencare le definizioni delle metriche per la sottoscrizione.

Core GA

az monitor metrics list

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.

Proprietà Valore
Parameter group: Target Resource Arguments

Parametri facoltativi

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--aggregation

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

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

Proprietà Valore
Valore da: az monitor metrics list-definitions
--end-time

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

Proprietà Valore
Parameter group: Time Arguments
--filter

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

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

--interval

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

Proprietà Valore
Parameter group: Time Arguments
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.

Proprietà Valore
Valore da: az monitor metrics list-definitions
--namespace

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

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

Proprietà Valore
Parameter group: Time Arguments
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 usando az configure --defaults group=<name>.

Proprietà Valore
Parameter group: Target Resource Arguments
--resource-namespace

Spazio dei nomi del provider di risorse di destinazione.

Proprietà Valore
Parameter group: Target Resource Arguments
--resource-parent

Percorso padre della risorsa di destinazione, se applicabile.

Proprietà Valore
Parameter group: Target Resource Arguments
--resource-type

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

Proprietà Valore
Parameter group: Target Resource Arguments
--start-time

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

Proprietà Valore
Parameter group: Time Arguments
--top

Numero massimo di record da recuperare.

Proprietà Valore
Valore predefinito: 10
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 list-definitions

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. (autogenerated)

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

Parametri necessari

--resource

Nome o ID della risorsa di destinazione.

Proprietà Valore
Parameter group: Target Resource Arguments

Parametri facoltativi

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--namespace

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

Proprietà Valore
Valore da: az monitor metrics list-namespaces
--resource-group -g

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

Proprietà Valore
Parameter group: Target Resource Arguments
--resource-namespace

Spazio dei nomi del provider di risorse di destinazione.

Proprietà Valore
Parameter group: Target Resource Arguments
--resource-parent

Percorso padre della risorsa di destinazione, se applicabile.

Proprietà Valore
Parameter group: Target Resource Arguments
--resource-type

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

Proprietà Valore
Parameter group: Target Resource 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/.

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

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--start-time

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

Proprietà Valore
Parameter group: Time 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/.

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

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--aggregation

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

Proprietà Valore
Parameter group: Body Arguments
--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 è false.

Proprietà Valore
Parameter group: Body Arguments
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.
Example:
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' e C 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' eq 'c1'
- Restituisce tutte le serie temporali in cui A = a1
$filter=A eq 'a1' e B eq '' e C eq ''.

Proprietà Valore
Parameter group: Body Arguments
--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.

Proprietà Valore
Parameter group: Body Arguments
--metricnames

Nomi delle metriche (delimitate da virgole) da recuperare.

Proprietà Valore
Parameter group: Body Arguments
--metricnamespace

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

Proprietà Valore
Parameter group: Body Arguments
--order-by

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

Proprietà Valore
Parameter group: Body Arguments
--result-type

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

Proprietà Valore
Parameter group: Body Arguments
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.

Proprietà Valore
Parameter group: Body Arguments
--timespan

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

Proprietà Valore
Parameter group: Body Arguments
--top

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

Proprietà Valore
Parameter group: Body Arguments
--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.

Proprietà Valore
Parameter group: Body Arguments
Valori accettati: 0, 1, f, false, n, no, t, true, y, yes
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 list-sub-definitions

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--metricnamespace

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

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