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. |
Núcleo | GA |
az monitor metrics alert condition |
Gerenciar 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 |
Gerenciar 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étrica. |
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 |
Atualize uma regra de alerta baseada em métrica. |
Núcleo | GA |
az monitor metrics list |
Liste os valores de métrica para 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
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
Nome ou ID do recurso de destino.
Parâmetros Opcionais
A lista de tipos de agregação (separados por espaço) a serem recuperados.
A lista de dimensões (separadas por espaço) nas quais as métricas são consultadas.
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).
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.
O intervalo sobre o qual agregar métricas, no formato ##h##m.
Retorna os valores de metadados em vez de dados de métrica.
Lista separada por espaço de nomes de métrica a serem recuperados.
Namespace para o qual consultar definições de métrica.
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.
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.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>
.
Namespace do provedor de recursos de destino.
Caminho pai do recurso de destino, se aplicável.
Tipo de recurso de destino. Também pode aceitar o formato namespace/tipo (por exemplo: 'Microsoft.Compute/virtualMachines').
Hora de início da consulta. Formato: data (yyyy-mm-dd) hora (hh:mm:ss.xxxxx) fuso horário (+/-hh:mm).
Número máximo de registros a serem recuperados.
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
Mostre esta mensagem de ajuda e saia.
Apenas mostrar erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.
az monitor metrics list-definitions
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
Nome ou ID do recurso de destino.
Parâmetros Opcionais
Namespace para o qual consultar definições de métrica.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>
.
Namespace do provedor de recursos de destino.
Caminho pai do recurso de destino, se aplicável.
Tipo de recurso de destino. Também pode aceitar o formato namespace/tipo (por exemplo: 'Microsoft.Compute/virtualMachines').
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
Mostre esta mensagem de ajuda e saia.
Apenas mostrar erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.
az monitor metrics list-namespaces
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
O identificador do recurso.
Parâmetros Opcionais
Hora de início da consulta. Formato: data (yyyy-mm-dd) hora (hh:mm:ss.xxxxx) fuso horário (+/-hh:mm).
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
Mostre esta mensagem de ajuda e saia.
Apenas mostrar erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.
az monitor metrics list-sub
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
A região onde residem as métricas desejadas.
Parâmetros Opcionais
A lista de tipos de agregação (vírgula separada) a ser recuperada.
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.
O $filter é usado para reduzir o conjunto de dados de métrica retornados.
Exemplo:
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 ''.
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.
Os nomes das métricas (vírgula separadas) a serem recuperadas.
Namespace de métrica em que as métricas desejadas residem.
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.
Reduz o conjunto de dados coletados. A sintaxe permitida depende da operação. Consulte a descrição da operação para obter detalhes.
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.
O período de tempo da consulta. É uma cadeia de caracteres com o seguinte formato 'startDateTime_ISO/endDateTime_ISO'.
O número máximo de registros a serem recuperados. Válido somente se $filter for especificado. O padrão é 10.
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.
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
Mostre esta mensagem de ajuda e saia.
Apenas mostrar erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.
az monitor metrics list-sub-definitions
Liste as definições de métrica para a assinatura.
az monitor metrics list-sub-definitions --region
[--metricnamespace]
Parâmetros Exigidos
A região onde residem as métricas desejadas.
Parâmetros Opcionais
Namespace de métrica em que as métricas desejadas residem.
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
Mostre esta mensagem de ajuda e saia.
Apenas mostrar erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.