Compartir a través de

az monitor metrics

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.

 Core GA
az monitor metrics alert condition

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

 Core GA
az monitor metrics alert condition create

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

 Core Preview
az monitor metrics alert create

Cree una regla de alertas basada en métricas.

 Core GA
az monitor metrics alert delete

Elimine una regla de alertas basada en métricas.

 Core GA
az monitor metrics alert dimension

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

 Core GA
az monitor metrics alert dimension create

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

 Core Preview
az monitor metrics alert list

Enumera las reglas de alertas basadas en métricas.

 Core GA
az monitor metrics alert show

Mostrar una regla de alertas basada en métricas.

 Core GA
az monitor metrics alert update

Actualice una regla de alertas basada en métricas.

 Core GA
az monitor metrics list

Enumere los valores de métrica de un recurso.

 Core GA
az monitor metrics list-definitions

Enumere las definiciones de métricas para el recurso.

 Core GA
az monitor metrics list-namespaces

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

 Core Preview
az monitor metrics list-sub

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

 Core GA
az monitor metrics list-sub-definitions

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

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

Propiedad Valor
Parameter group: Target Resource Arguments

Parámetros opcionales

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--aggregation

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

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

Propiedad Valor
Valor de: az monitor metrics list-definitions
--end-time

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

Propiedad Valor
Parameter group: Time Arguments
--filter

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

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

--interval

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

Propiedad Valor
Parameter group: Time Arguments
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.

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

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

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

Propiedad Valor
Parameter group: Time Arguments
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>.

Propiedad Valor
Parameter group: Target Resource Arguments
--resource-namespace

Espacio de nombres del proveedor de recursos de destino.

Propiedad Valor
Parameter group: Target Resource Arguments
--resource-parent

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

Propiedad Valor
Parameter group: Target Resource Arguments
--resource-type

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

Propiedad Valor
Parameter group: Target Resource Arguments
--start-time

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

Propiedad Valor
Parameter group: Time Arguments
--top

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

Propiedad Valor
Valor predeterminado: 10
Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Output format.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

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. (autogenerated)

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.

Propiedad Valor
Parameter group: Target Resource Arguments

Parámetros opcionales

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--namespace

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

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

Propiedad Valor
Parameter group: Target Resource Arguments
--resource-namespace

Espacio de nombres del proveedor de recursos de destino.

Propiedad Valor
Parameter group: Target Resource Arguments
--resource-parent

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

Propiedad Valor
Parameter group: Target Resource Arguments
--resource-type

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

Propiedad Valor
Parameter group: Target Resource Arguments
Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Output format.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--start-time

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

Propiedad Valor
Parameter group: Time Arguments
Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Output format.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--aggregation

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

Propiedad Valor
Parameter group: Body Arguments
--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.

Propiedad Valor
Parameter group: Body Arguments
Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--filter

The $filter is used to reduce the set of metric data returned.
Example:
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 ''.

Propiedad Valor
Parameter group: Body Arguments
--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.

Propiedad Valor
Parameter group: Body Arguments
--metricnames

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

Propiedad Valor
Parameter group: Body Arguments
--metricnamespace

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

Propiedad Valor
Parameter group: Body Arguments
--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.

Propiedad Valor
Parameter group: Body Arguments
--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.

Propiedad Valor
Parameter group: Body Arguments
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.

Propiedad Valor
Parameter group: Body Arguments
--timespan

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

Propiedad Valor
Parameter group: Body Arguments
--top

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

Propiedad Valor
Parameter group: Body Arguments
--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.

Propiedad Valor
Parameter group: Body Arguments
Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Output format.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--metricnamespace

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

Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Output format.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False