Compartir a través de

az monitor metrics

  • Referencia

Vea las métricas de recursos de Azure.

Comandos

Nombre Description Tipo Estado
az monitor metrics alert

Administrar reglas de alertas de métricas casi en tiempo real.

 Principal GA
az monitor metrics alert condition

Administrar condiciones de regla de alertas de métricas casi en tiempo real.

 Principal GA
az monitor metrics alert condition create

Cree una condición de regla de alertas de métricas.

 Principal Vista previa
az monitor metrics alert create

Cree una regla de alertas basada en métricas.

 Principal GA
az monitor metrics alert delete

Elimine una regla de alertas basada en métricas.

 Principal GA
az monitor metrics alert dimension

Administrar dimensiones de regla de alertas de métricas casi en tiempo real.

 Principal GA
az monitor metrics alert dimension create

Cree una dimensión de regla de alertas de métricas.

 Principal Vista previa
az monitor metrics alert list

Enumera las reglas de alertas basadas en métricas.

 Principal GA
az monitor metrics alert show

Mostrar una regla de alertas basada en métricas.

 Principal GA
az monitor metrics alert update

Actualice una regla de alertas basada en métricas.

 Principal GA
az monitor metrics list

Enumere los valores de métrica de un recurso.

 Principal GA
az monitor metrics list-definitions

Enumere las definiciones de métricas para el recurso.

 Principal GA
az monitor metrics list-namespaces

Enumere los espacios de nombres de métricas para el recurso.

 Principal Vista previa
az monitor metrics list-sub

Enumera los datos de métricas de una suscripción. Los parámetros se pueden especificar en el cuerpo.

 Principal GA
az monitor metrics list-sub-definitions

Enumere las definiciones de métricas de la suscripción.

 Principal GA

az monitor metrics list

Editar

Enumere los valores de métrica de un 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]

Ejemplos

Enumeración del uso de CPU de una máquina virtual durante la última hora

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

Enumerar la latencia de E2E correcta de una cuenta de almacenamiento y dividir la serie de datos en función del nombre de la API

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

Enumerar la latencia E2E correcta de una cuenta de almacenamiento y dividir la serie de datos en función del nombre de LA API y del tipo geográfico

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

Enumerar la latencia E2E correcta de una cuenta de almacenamiento y dividir la serie de datos en función del nombre de LA API y del tipo geográfico mediante el parámetro "--filter"

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

Enumere la latencia E2E correcta de una cuenta de almacenamiento y divida la serie de datos en función del nombre de LA API y del tipo geográfico. Limita el nombre de la API a "DeleteContainer"

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

Enumeración de transacciones de una cuenta de almacenamiento al día desde el 2017-01-01

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

Enumerar los valores de metadatos de una cuenta de almacenamiento en la dimensión de nombre de api de la métrica de transacción desde 2017

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

Parámetros requeridos

--resource

Nombre o identificador del recurso de destino.

Parámetros opcionales

--aggregation

Lista de tipos de agregación (separados por espacios) que se van a recuperar.

valores aceptados: Average, Count, Maximum, Minimum, None, Total
valor de: az monitor metrics list-definitions
--dimension

La lista de dimensiones (separadas por espacios) en la que se consultan las métricas.

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

Hora de finalización de la consulta. El valor predeterminado es la hora actual. Formato: hora (aaaa-mm-dd) (hh:mm:ss.xxxxx) zona horaria (+/-hh:mm).

--filter

Cadena utilizada para reducir el conjunto de datos de métricas devueltos. P. ej. "BlobType eq '*'".

Para obtener una lista completa de filtros, consulte la referencia de cadena de filtro en https://docs.microsoft.com/rest/api/monitor/metrics/list.

--interval

Intervalo en el que se van a agregar métricas, en formato ##h##m.

valor predeterminado: 1m
--metadata

Devuelve los valores de metadatos en lugar de los datos de métricas.

--metrics

Lista separada por espacios de nombres de métricas que se van a recuperar.

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

Espacio de nombres para el que se van a consultar las definiciones de métricas.

valor de: az monitor metrics list-namespaces
--offset

Desplazamiento de tiempo del intervalo de consultas, en formato ##d##h.

Se puede usar con --start-time o --end-time. Si se usa con --start-time, la hora de finalización se calculará agregando el desplazamiento. Si se usa con --end-time (valor predeterminado), la hora de inicio se calculará restando el desplazamiento. Si se proporcionan --start-time y --end-time, se omitirá --offset.

valor predeterminado: 1h
--orderby

Agregación que se va a usar para ordenar los resultados y la dirección de la ordenación. Solo se puede especificar un pedido. Ejemplos: suma asc.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--resource-namespace

Espacio de nombres del proveedor de recursos de destino.

--resource-parent

Ruta de acceso primaria del recurso de destino, si procede.

--resource-type

Tipo de recurso de destino. También puede aceptar el formato de espacio de nombres o tipo (por ejemplo: "Microsoft.Compute/virtualMachines").

--start-time

Hora de inicio de la consulta. Formato: hora (aaaa-mm-dd) (hh:mm:ss.xxxxx) zona horaria (+/-hh:mm).

--top

Número máximo de registros que se van a recuperar.

valor predeterminado: 10
Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az monitor metrics list-definitions

Editar

Enumere las definiciones de métricas para el recurso.

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

Ejemplos

Enumere las definiciones de métricas para el recurso. (generado automáticamente)

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

Parámetros requeridos

--resource

Nombre o identificador del recurso de destino.

Parámetros opcionales

--namespace

Espacio de nombres para el que se van a consultar las definiciones de métricas.

valor de: az monitor metrics list-namespaces
--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--resource-namespace

Espacio de nombres del proveedor de recursos de destino.

--resource-parent

Ruta de acceso primaria del recurso de destino, si procede.

--resource-type

Tipo de recurso de destino. También puede aceptar el formato de espacio de nombres o tipo (por ejemplo: "Microsoft.Compute/virtualMachines").

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az monitor metrics list-namespaces

Editar
Vista previa

Este comando está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Enumere los espacios de nombres de métricas para el recurso.

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

Ejemplos

Enumere los espacios de nombres de métricas para el recurso.

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

Parámetros requeridos

--resource-uri

Identificador del recurso.

Parámetros opcionales

--start-time

Hora de inicio de la consulta. Formato: hora (aaaa-mm-dd) (hh:mm:ss.xxxxx) zona horaria (+/-hh:mm).

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az monitor metrics list-sub

Editar

Enumera los datos de métricas de una suscripción. Los parámetros se pueden especificar en el cuerpo.

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 requeridos

--region

Región en la que residen las métricas que desea.

Parámetros opcionales

--aggregation

Lista de tipos de agregación (separados por comas) que se van a recuperar.

--auto-adjust-timegrain

Cuando se establece en true, si esta métrica no admite el intervalo de tiempo pasado, la API devolverá el resultado mediante el intervalo de tiempo más cercano admitido. Cuando se establece en false, se devuelve un error para parámetros de intervalo de tiempo no válidos. El valor predeterminado es false.

valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--filter

El $filter se usa para reducir el conjunto de datos de métricas devueltos.
Ejemplo:
La métrica contiene metadatos A, B y C.
- Devuelve toda la serie temporal de C donde A = a1 y B = b1 o b2
$filter=A eq 'a1' y B eq 'b1' o B eq 'b2' y C eq '*'
- Variante no válida:
$filter=A eq 'a1' y B eq 'b1' y C eq '*' o B = 'b2'
Esto no es válido porque el operador lógico o no puede separar dos nombres de metadatos diferentes.
- Devuelve todas las series temporales donde A = a1, B = b1 y C = c1:
$filter=A eq 'a1' y B eq 'b1' y C eq 'c1'
: devuelve todas las series temporales donde A = a1
$filter=A eq 'a1' y B eq '' y C eq ''.

--interval

Intervalo (es decir, timegrain) de la consulta en formato de duración ISO 8601. El valor predeterminado es PT1M. Caso especial para el valor "FULL" que devuelve un único punto de datos para todo el intervalo de tiempo solicitado. Ejemplos: PT15M, PT1H, P1D, FULL.

--metricnames

Nombres de las métricas (separadas por comas) que se van a recuperar.

--metricnamespace

Espacio de nombres de métrica donde residen las métricas que desea.

--order-by

Agregación que se va a usar para ordenar los resultados y la dirección de la ordenación. Solo se puede especificar un pedido. Ejemplos: suma asc.

--result-type

Reduce el conjunto de datos recopilados. La sintaxis permitida depende de la operación. Consulte la descripción de la operación para obtener más información.

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

Nombres de dimensión por los que se resumen los resultados. Por ejemplo, si solo desea ver valores de métricas con un filtro como "City eq Seattle o City eq Tacoma", pero no quiere ver valores independientes para cada ciudad, puede especificar "RollUpBy=City" para ver los resultados de Seattle y Tacoma inscritos en una serie de veces.

--timespan

El intervalo de tiempo de la consulta. Es una cadena con el siguiente formato "startDateTime_ISO/endDateTime_ISO".

--top

Número máximo de registros que se van a recuperar. Válido solo si se especifica $filter. El valor predeterminado es 10.

--validate-dimensions

Cuando se establece en false, se omitirán los valores de parámetro de filtro no válidos. Cuando se establece en true, se devuelve un error para los parámetros de filtro no válidos. El valor predeterminado es true.

valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az monitor metrics list-sub-definitions

Editar

Enumere las definiciones de métricas de la suscripción.

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

Parámetros requeridos

--region

Región en la que residen las métricas que desea.

Parámetros opcionales

--metricnamespace

Espacio de nombres de métrica donde residen las métricas que desea.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.