Partilhar via

az monitor metrics

Exiba métricas de recursos do Azure.

Comandos

Name Description Tipo Status
az monitor metrics alert

Gerencie regras de alerta de métricas quase em tempo real.

 Core disponibilidade geral
az monitor metrics alert condition

Gerencie as condições da regra de alerta métrico quase em tempo real.

 Core disponibilidade geral
az monitor metrics alert condition create

Crie uma condição de regra de alerta métrico.

 Core Preview
az monitor metrics alert create

Crie uma regra de alerta baseada em métricas.

 Core disponibilidade geral
az monitor metrics alert delete

Exclua uma regra de alerta baseada em métricas.

 Core disponibilidade geral
az monitor metrics alert dimension

Gerencie dimensões de regras de alerta de métricas quase em tempo real.

 Core disponibilidade geral
az monitor metrics alert dimension create

Crie uma dimensão de regra de alerta métrico.

 Core Preview
az monitor metrics alert list

Listar regras de alerta baseadas em métricas.

 Core disponibilidade geral
az monitor metrics alert show

Mostrar uma regra de alerta baseada em métricas.

 Core disponibilidade geral
az monitor metrics alert update

Atualize uma regra de alerta baseada em métricas.

 Core disponibilidade geral
az monitor metrics list

Liste os valores de métrica para um recurso.

 Core disponibilidade geral
az monitor metrics list-definitions

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

 Core disponibilidade geral
az monitor metrics list-namespaces

Liste os namespaces de métrica para o recurso.

 Core Preview
az monitor metrics list-sub

Lista os dados métricos de uma assinatura. Os parâmetros podem ser especificados no corpo.

 Core disponibilidade geral
az monitor metrics list-sub-definitions

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

 Core disponibilidade geral

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

Liste a latência E2E bem-sucedida de uma conta de armazenamento e divida 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

Liste a latência E2E bem-sucedida de uma conta de armazenamento e divida 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 '*'"

Liste a latência E2E bem-sucedida de uma conta de armazenamento e divida 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 para uma conta de armazenamento na dimensão de nome de 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 Obrigatórios

--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 tornar-se necessários para que o comando seja executado com êxito.

--aggregation

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

Propriedade Valor
Valores aceites: 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

Hora de fim da consulta. O padrão é a hora atual. Formato: data (aaaa-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 métricos retornados. eg. "BlobType eq '*'".

Para obter uma lista completa de filtros, consulte a referência da cadeia de caracteres de filtro em https://v4.hkg1.meaqua.org/rest/api/monitor/metrics/list.

--interval

O intervalo ao longo do qual agregar métricas, no formato ##h##m.

Propriedade Valor
Grupo de parâmetros: Time Arguments
Default value: 1m
--metadata

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

--metrics

Lista separada por espaço de nomes de métricas para recuperar.

Propriedade Valor
Valor de: az monitor metrics list-definitions
--namespace

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

Propriedade Valor
Valor de: az monitor metrics list-namespaces
--offset

Deslocamento de tempo do intervalo de consultas, 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, --offset será ignorado.

Propriedade Valor
Grupo de parâmetros: Time Arguments
Default value: 1h
--orderby

Agregação a ser usada para classificar resultados e a direção da classificação. Apenas uma ordem pode ser especificada. Exemplos: sum 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 de namespace/tipo (Ex: 'Microsoft.Compute/virtualMachines').

Propriedade Valor
Grupo de parâmetros: Target Resource Arguments
--start-time

Hora de início da consulta. Formato: data (aaaa-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
Default value: 10
Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: 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 Obrigatórios

--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 tornar-se necessários para que o comando seja executado com êxito.

--namespace

Namespace para 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 de namespace/tipo (Ex: 'Microsoft.Compute/virtualMachines').

Propriedade Valor
Grupo de parâmetros: Target Resource Arguments
Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False

az monitor metrics list-namespaces

Editar
Pré-visualizar

Este comando está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: 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 Obrigatórios

--resource-uri

O identificador do recurso.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--start-time

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

Propriedade Valor
Grupo de parâmetros: Time Arguments
Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False

az monitor metrics list-sub

Editar

Lista os dados métricos 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 Obrigatórios

--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 tornar-se necessários para que o comando seja executado com êxito.

--aggregation

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

Propriedade Valor
Grupo de parâmetros: Body Arguments
--auto-adjust-timegrain

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

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

O $filter é usado para reduzir o conjunto de dados métricos retornados.
Example:
A métrica contém metadados A, B e C.
- Retornar todas as séries temporais de C onde 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 lógico ou não pode separar dois nomes de metadados diferentes.
- Retornar todas as séries temporais onde 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 onde 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 (separadas por vírgula) a serem recuperadas.

Propriedade Valor
Grupo de parâmetros: Body Arguments
--metricnamespace

Namespace de métrica onde residem as métricas desejadas.

Propriedade Valor
Grupo de parâmetros: Body Arguments
--order-by

A agregação a ser usada para classificar resultados e a direção da classificação. Apenas uma ordem pode ser especificada. Exemplos: sum 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 aceites: Data, Metadata
--roll-up-by

Nome(s) da(s) dimensão(ões) para acumular resultados. Por exemplo, se você quiser ver apenas valores métricos 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 agrupados em uma série temporal.

Propriedade Valor
Grupo de parâmetros: Body Arguments
--timespan

O período de tempo da consulta. É uma string 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 apenas se $filter for especificado. O padrão é 10.

Propriedade Valor
Grupo de parâmetros: Body Arguments
--validate-dimensions

Quando definido como false, os valores de parâmetros 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 aceites: 0, 1, f, false, n, no, t, true, y, yes
Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: 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 Obrigatórios

--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 tornar-se necessários para que o comando seja executado com êxito.

--metricnamespace

Namespace de métrica onde residem as métricas desejadas.

Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False