az monitor metrics

  • Referência

Exiba as métricas de recursos do Azure.

Comandos

Nome Description Tipo Status
az monitor metrics alert

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

 Núcleo GA
az monitor metrics alert condition

Gerencie condições de regra de alerta de métrica quase em tempo real.

 Núcleo GA
az monitor metrics alert condition create

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

 Núcleo Visualizar
az monitor metrics alert create

Crie uma regra de alerta baseada em métrica.

 Núcleo GA
az monitor metrics alert delete

Exclua uma regra de alerta baseada em métricas.

 Núcleo GA
az monitor metrics alert dimension

Gerencie dimensões de regra de alerta de métrica quase em tempo real.

 Núcleo GA
az monitor metrics alert dimension create

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

 Núcleo Visualizar
az monitor metrics alert list

Listar regras de alerta baseadas em métricas.

 Núcleo GA
az monitor metrics alert show

Mostrar uma regra de alerta baseada em métricas.

 Núcleo GA
az monitor metrics alert update

Atualizar uma regra de alerta baseada em métrica.

 Núcleo GA
az monitor metrics list

Listar os valores de métrica de um recurso.

 Núcleo GA
az monitor metrics list-definitions

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

 Núcleo GA
az monitor metrics list-namespaces

Liste os namespaces de métrica para o recurso.

 Núcleo Visualizar
az monitor metrics list-sub

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

 Núcleo GA
az monitor metrics list-sub-definitions

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

 Núcleo GA

az monitor metrics list

Editar

Listar os valores de métrica de 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 de sucesso 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 de sucesso 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 '*'"

Liste a latência E2E de sucesso 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 de uma conta de armazenamento na dimensão do 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.

Parâmetros Opcionais

--aggregation

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

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.

valor de: az monitor metrics list-definitions
--end-time

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

--filter

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

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

--interval

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

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étricas a serem recuperados.

valor de: az monitor metrics list-definitions
--namespace

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

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, --offset será ignorado.

valor padrão: 1h
--orderby

Agregação a ser usada para classificar resultados e a direção da classificação. Apenas uma ordem pode ser especificada. Exemplos: soma asc.

--resource-group -g

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

--resource-namespace

Namespace do provedor de recursos de destino.

--resource-parent

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

--resource-type

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

--start-time

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

--top

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

valor padrão: 10
Parâmetros Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--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 o detalhamento do log. Use --debug para logs de depuração completos.

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. (gerado automaticamente)

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.

Parâmetros Opcionais

--namespace

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

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

--resource-namespace

Namespace do provedor de recursos de destino.

--resource-parent

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

--resource-type

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

Parâmetros Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--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 o detalhamento do log. Use --debug para logs de depuração completos.

az monitor metrics list-namespaces

Editar
Versão Prévia

Este comando está em pré-visualização 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

--start-time

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

Parâmetros Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--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 o detalhamento do log. Use --debug para logs de depuração completos.

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 as métricas que você deseja residir.

Parâmetros Opcionais

--aggregation

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

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

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.
Exemplo:
A métrica contém metadados A, B e C.
- Retorne 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.
- Retorne 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 ''.

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

--metricnames

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

--metricnamespace

Namespace de métrica onde as métricas que você deseja residir.

--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: soma asc.

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

valores aceitos: Data, Metadata
--roll-up-by

Nome(s) da(s) dimensão(ões) para acumular resultados por. 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 temporal.

--timespan

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

--top

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

--validate-dimensions

Quando definido como false, os 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 é verdadeiro.

valores aceitos: 0, 1, f, false, n, no, t, true, y, yes
Parâmetros Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--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 o detalhamento do log. Use --debug para logs de depuração completos.

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 as métricas que você deseja residir.

Parâmetros Opcionais

--metricnamespace

Namespace de métrica onde as métricas que você deseja residir.

Parâmetros Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--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 o detalhamento do log. Use --debug para logs de depuração completos.