az monitor metrics

Exibir métricas de recursos do Azure.

Comandos

Nome	Description	Tipo	Status
az monitor metrics alert	Gerenciar regras de alerta de métrica quase em tempo real.	Core	GA
az monitor metrics alert condition	Gerenciar condições de regra de alerta de métrica quase em tempo real.	Core	GA
az monitor metrics alert condition create	Crie uma condição de regra de alerta de métrica.	Core	Preview
az monitor metrics alert create	Crie uma regra de alerta baseada em métrica.	Core	GA
az monitor metrics alert delete	Exclua uma regra de alerta baseada em métricas.	Core	GA
az monitor metrics alert dimension	Gerenciar dimensões de regra de alerta de métrica quase em tempo real.	Core	GA
az monitor metrics alert dimension create	Crie uma dimensão de regra de alerta de métrica.	Core	Preview
az monitor metrics alert list	Listar regras de alerta baseadas em métrica.	Core	GA
az monitor metrics alert show	Mostrar uma regra de alerta baseada em métricas.	Core	GA
az monitor metrics alert update	Atualize uma regra de alerta baseada em métrica.	Core	GA
az monitor metrics list	Liste os valores de métrica para um recurso.	Core	GA
az monitor metrics list-definitions	Liste as definições de métrica para o recurso.	Core	GA
az monitor metrics list-namespaces	Liste os namespaces de métrica para o recurso.	Core	Preview
az monitor metrics list-sub	Lista os dados de métrica de uma assinatura. Os parâmetros podem ser especificados no corpo.	Core	GA
az monitor metrics list-sub-definitions	Liste as definições de métrica para a assinatura.	Core	GA

az monitor metrics list

Editar

Liste os valores de métrica para um recurso.

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]

Exemplos

Listar o uso da CPU de uma VM na última hora

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

Listar a latência E2E bem-sucedida de uma conta de armazenamento e dividir a série de dados com base no nome da API

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

Listar a latência E2E bem-sucedida de uma conta de armazenamento e dividir a série de dados com base no nome da API e no tipo geográfico

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

Listar a latência E2E bem-sucedida de uma conta de armazenamento e dividir a série de dados com base no nome da API e no tipo geográfico usando o parâmetro "--filter"

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

Listar a latência E2E bem-sucedida de uma conta de armazenamento e dividir a série de dados com base no nome da API e no tipo geográfico. Limita o nome da API a 'DeleteContainer'

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

Listar transações de uma conta de armazenamento por dia desde 2017-01-01

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

Listar os valores de metadados de uma conta de armazenamento na dimensão de nome da aPI da métrica de transação desde 2017

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

Parâmetros Exigidos

--resource

Nome ou ID do recurso de destino.

Propriedade	Valor
Grupo de parâmetros:	Target Resource Arguments

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--aggregation

A lista de tipos de agregação (separados por espaço) a serem recuperados.

Propriedade	Valor
Valores aceitos:	Average, Count, Maximum, Minimum, None, Total
Valor de:	az monitor metrics list-definitions

--dimension

A lista de dimensões (separadas por espaço) nas quais as métricas são consultadas.

Propriedade	Valor
Valor de:	az monitor metrics list-definitions

--end-time

A hora de término da consulta. O padrão é a hora atual. Formato: data (yyyy-mm-dd) hora (hh:mm:ss.xxxxx) fuso horário (+/-hh:mm).

Propriedade	Valor
Grupo de parâmetros:	Time Arguments

--filter

Uma cadeia de caracteres usada para reduzir o conjunto de dados de métrica retornados. eg. "BlobType eq '*'".

Para obter uma lista completa de filtros, consulte a referência de cadeia de caracteres de filtro em https://learn.microsoft.com/rest/api/monitor/metrics/list.

--interval

O intervalo sobre o qual agregar métricas, no formato ##h##m.

Propriedade	Valor
Grupo de parâmetros:	Time Arguments
Valor padrão:	1m

--metadata

Retorna os valores de metadados em vez de dados de métrica.

--metrics

Lista separada por espaço de nomes de métrica a serem recuperados.

Propriedade	Valor
Valor de:	az monitor metrics list-definitions

--namespace

Namespace para o qual consultar definições de métrica.

Propriedade	Valor
Valor de:	az monitor metrics list-namespaces

--offset

Deslocamento de tempo do intervalo de consulta, no formato ##d##h.

Pode ser usado com --start-time ou --end-time. Se usado com --start-time, a hora de término será calculada adicionando o deslocamento. Se usado com --end-time (padrão), a hora de início será calculada subtraindo o deslocamento. Se --start-time e --end-time forem fornecidos, o deslocamento será ignorado.

Propriedade	Valor
Grupo de parâmetros:	Time Arguments
Valor padrão:	1h

--orderby

Agregação a ser usada para classificar os resultados e a direção da classificação. Somente uma ordem pode ser específica. Exemplos: soma asc.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Propriedade	Valor
Grupo de parâmetros:	Target Resource Arguments

--resource-namespace

Namespace do provedor de recursos de destino.

Propriedade	Valor
Grupo de parâmetros:	Target Resource Arguments

--resource-parent

Caminho pai do recurso de destino, se aplicável.

Propriedade	Valor
Grupo de parâmetros:	Target Resource Arguments

--resource-type

Tipo de recurso de destino. Também pode aceitar o formato namespace/tipo (por exemplo: 'Microsoft.Compute/virtualMachines').

Propriedade	Valor
Grupo de parâmetros:	Target Resource Arguments

--start-time

A hora de início da consulta. Formato: data (yyyy-mm-dd) hora (hh:mm:ss.xxxxx) fuso horário (+/-hh:mm).

Propriedade	Valor
Grupo de parâmetros:	Time Arguments

--top

Número máximo de registros a serem recuperados.

Propriedade	Valor
Valor padrão:	10

Parâmetros Globais

--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Formato de saída.

Propriedade	Valor
Valor padrão:	json
Valores aceitos:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

az monitor metrics list-definitions

Editar

Liste as definições de métrica para o recurso.

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

Exemplos

Liste as definições de métrica para o recurso. (autogenerated)

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

Parâmetros Exigidos

--resource

Nome ou ID do recurso de destino.

Propriedade	Valor
Grupo de parâmetros:	Target Resource Arguments

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--namespace

Namespace para o qual consultar definições de métrica.

Propriedade	Valor
Valor de:	az monitor metrics list-namespaces

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Propriedade	Valor
Grupo de parâmetros:	Target Resource Arguments

--resource-namespace

Namespace do provedor de recursos de destino.

Propriedade	Valor
Grupo de parâmetros:	Target Resource Arguments

--resource-parent

Caminho pai do recurso de destino, se aplicável.

Propriedade	Valor
Grupo de parâmetros:	Target Resource Arguments

--resource-type

Tipo de recurso de destino. Também pode aceitar o formato namespace/tipo (por exemplo: 'Microsoft.Compute/virtualMachines').

Propriedade	Valor
Grupo de parâmetros:	Target Resource Arguments

Parâmetros Globais

--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Formato de saída.

Propriedade	Valor
Valor padrão:	json
Valores aceitos:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

az monitor metrics list-namespaces

Editar

Versão Prévia

Esse comando está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Liste os namespaces de métrica para o recurso.

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

Exemplos

Liste os namespaces de métrica para o recurso.

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

Parâmetros Exigidos

--resource-uri

O identificador do recurso.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--start-time

A hora de início da consulta. Formato: data (yyyy-mm-dd) hora (hh:mm:ss.xxxxx) fuso horário (+/-hh:mm).

Propriedade	Valor
Grupo de parâmetros:	Time Arguments

Parâmetros Globais

--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Formato de saída.

Propriedade	Valor
Valor padrão:	json
Valores aceitos:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

az monitor metrics list-sub

Editar

Lista os dados de métrica de uma assinatura. Os parâmetros podem ser especificados no 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}]

Parâmetros Exigidos

--region

A região onde residem as métricas desejadas.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--aggregation

A lista de tipos de agregação (vírgula separada) a ser recuperada.

Propriedade	Valor
Grupo de parâmetros:	Body Arguments

--auto-adjust-timegrain

Quando definido como true, se o período de tempo passado não for suportado por essa métrica, a API retornará o resultado usando o período de tempo mais próximo com suporte. Quando definido como false, um erro é retornado para parâmetros de tempo de tempo inválidos. O padrão é false.

Propriedade	Valor
Grupo de parâmetros:	Body Arguments
Valores aceitos:	0, 1, f, false, n, no, t, true, y, yes

--filter

O $filter é usado para reduzir o conjunto de dados de métrica retornados.
Example:
A métrica contém metadados A, B e C.
- Retornar todas as séries temporais de C em que A = a1 e B = b1 ou b2
$filter=A eq 'a1' e B eq 'b1' ou B eq 'b2' e C eq '*'
– Variante inválida:
$filter=A eq 'a1' e B eq 'b1' e C eq '*' ou B = 'b2'
Isso é inválido porque o operador ou lógica não pode separar dois nomes de metadados diferentes.
- Retornar todas as séries temporais em que A = a1, B = b1 e C = c1:
$filter=A eq 'a1' e B eq 'b1' e C eq 'c1'
- Retornar todas as séries temporais em que A = a1
$filter=A eq 'a1' e B eq '' e C eq ''.

Propriedade	Valor
Grupo de parâmetros:	Body Arguments

--interval

O intervalo (ou seja, timegrain) da consulta no formato de duração ISO 8601. O padrão é PT1M. Caso especial para o valor 'FULL' que retorna um único ponto de dados para todo o período de tempo solicitado. exemplos: PT15M, PT1H, P1D, FULL.

Propriedade	Valor
Grupo de parâmetros:	Body Arguments

--metricnames

Os nomes das métricas (vírgula separadas) a serem recuperadas.

Propriedade	Valor
Grupo de parâmetros:	Body Arguments

--metricnamespace

Namespace de métrica em que as métricas desejadas residem.

Propriedade	Valor
Grupo de parâmetros:	Body Arguments

--order-by

A agregação a ser usada para classificar os resultados e a direção da classificação. Somente uma ordem pode ser especificada. Exemplos: soma asc.

Propriedade	Valor
Grupo de parâmetros:	Body Arguments

--result-type

Reduz o conjunto de dados coletados. A sintaxe permitida depende da operação. Consulte a descrição da operação para obter detalhes.

Propriedade	Valor
Grupo de parâmetros:	Body Arguments
Valores aceitos:	Data, Metadata

--roll-up-by

Nome(s) da dimensão pelo qual os resultados serão acumulados. Por exemplo, se você quiser ver apenas valores de métrica com um filtro como 'City eq Seattle ou City eq Tacoma', mas não quiser ver valores separados para cada cidade, você pode especificar 'RollUpBy=City' para ver os resultados de Seattle e Tacoma acumulados em uma série de horários.

Propriedade	Valor
Grupo de parâmetros:	Body Arguments

--timespan

O período de tempo da consulta. É uma cadeia de caracteres com o seguinte formato 'startDateTime_ISO/endDateTime_ISO'.

Propriedade	Valor
Grupo de parâmetros:	Body Arguments

--top

O número máximo de registros a serem recuperados. Válido somente se $filter for especificado. O padrão é 10.

Propriedade	Valor
Grupo de parâmetros:	Body Arguments

--validate-dimensions

Quando definido como false, valores de parâmetro de filtro inválidos serão ignorados. Quando definido como true, um erro é retornado para parâmetros de filtro inválidos. O padrão é true.

Propriedade	Valor
Grupo de parâmetros:	Body Arguments
Valores aceitos:	0, 1, f, false, n, no, t, true, y, yes

Parâmetros Globais

--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Formato de saída.

Propriedade	Valor
Valor padrão:	json
Valores aceitos:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

az monitor metrics list-sub-definitions

Editar

Liste as definições de métrica para a assinatura.

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

Parâmetros Exigidos

--region

A região onde residem as métricas desejadas.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--metricnamespace

Namespace de métrica em que as métricas desejadas residem.

Parâmetros Globais

--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Formato de saída.

Propriedade	Valor
Valor padrão:	json
Valores aceitos:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

Comentários

Esta página foi útil?

Compartilhar via

az monitor metrics

Comandos

az monitor metrics list

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az monitor metrics list-definitions

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az monitor metrics list-namespaces

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az monitor metrics list-sub

Parâmetros Exigidos

Parâmetros Opcionais

az monitor metrics list-sub-definitions

Parâmetros Exigidos

Parâmetros Opcionais

Comentários