Compartir a través de

az monitor metrics alert

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

Comandos

Nombre Description Tipo Estado
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 alert create

Editar

Cree una regla de alertas basada en métricas.

az monitor metrics alert create --condition
                                --name
                                --resource-group
                                --scopes
                                [--action]
                                [--auto-mitigate {false, true}]
                                [--description]
                                [--disabled {false, true}]
                                [--evaluation-frequency]
                                [--region --target-resource-region]
                                [--severity]
                                [--tags]
                                [--target-resource-type --type]
                                [--window-size]

Ejemplos

Cree una alerta de uso elevado de CPU en una máquina virtual sin acción.

az monitor metrics alert create -n alert1 -g {ResourceGroup} --scopes {VirtualMachineID} --condition "avg Percentage CPU > 90" --description "High CPU"

Cree una alerta de uso elevado de CPU en una máquina virtual con acciones de correo electrónico y webhook.

az monitor metrics alert create -n alert1 -g {ResourceGroup} --scopes {VirtualMachineID} \
    --condition "avg Percentage CPU > 90" --window-size 5m --evaluation-frequency 1m \
    --action "/subscriptions/<subscriptionId>/resourceGroups/<resourceGroupName>/providers/Microsoft.Insights/actionGroups/<actionGroupName>" apiKey={APIKey} type=HighCPU \
    --description "High CPU"

Cree una alerta cuando una cuenta de almacenamiento muestre un gran número de transacciones lentas mediante filtros multidimensionales.

az monitor metrics alert create -g {ResourceGroup} -n alert1 --scopes {StorageAccountId} \
    --description "Storage Slow Transactions" \
    --condition "total transactions > 5 where ResponseType includes Success" \
    --condition "avg SuccessE2ELatency > 250 where ApiName includes GetBlob"

Cree una regla de alerta basada en métricas que supervise una métrica personalizada.

az monitor metrics alert create -n "metric alert rule on a custom metric" -g "Demos" --scopes {VirtualMachineID} \
    --condition "max Azure.VM.Windows.GuestMetrics.Memory\Available Bytes > 90" \
    --window-size 5m --evaluation-frequency 1m

Cree una alerta de uso elevado de CPU en varias máquinas virtuales sin acciones.

az monitor metrics alert create -n alert1 -g {ResourceGroup} --scopes {VirtualMachineID1} {VirtualMachineID2} {VirtualMachineID3} \
    --condition "avg Percentage CPU > 90" --description "High CPU" --region westus

Cree una alerta de uso dinámico de CPU en varias máquinas virtuales sin acciones.

az monitor metrics alert create -n alert1 -g {ResourceGroup} --scopes {VirtualMachineID1} {VirtualMachineID2} {VirtualMachineID3} \
    --condition "avg Percentage CPU > dynamic medium 2 of 4 since 2020-10-01T10:23:00.000Z"
    --description "Dynamic CPU"
    --window-size 5m
    --region westus

Parámetros requeridos

--condition

Condición que desencadena la regla. Se puede crear mediante el comando "az monitor metrics alert condition create".

Uso: --condition {avg,min,max,total,count} [NAMESPACE.]MÉTRICA [{=,!=,>,>=,<,<=} THRESHOLD] [{>,><,<} INFRACCIONES de CONFIDENCIALIDAD dinámicas de EVALUACIONES [desde DATETIME]] [donde DIMENSION {includes,excludes} VALUE [o VALUE ...] [y DIMENSION {includes,excludes} VALUE [or VALUE ...] ...]] [with skipmetricvalidation]

La sensibilidad puede ser "baja", "media", "alta".

Las infracciones pueden ser el número de infracciones para desencadenar una alerta. Debe ser menor o igual que la evaluación.

Las evaluaciones pueden ser el número de períodos de evaluación para el umbral dinámico.

Datetime puede ser la fecha desde la que empezar a aprender los datos históricos de la métrica y calcular los umbrales dinámicos (en formato ISO8601).

Las dimensiones se pueden consultar agregando la palabra clave "where" y se pueden consultar varias dimensiones mediante la combinación de ellas con la palabra clave "and".

Los valores de METRIC, DIMENSION y los valores THRESHOLD adecuados se pueden obtener de az monitor metrics list-definitions comando.

Debido a la limitación del servidor, cuando una regla de alerta contiene varios criterios, el uso de dimensiones se limita a un valor por dimensión dentro de cada criterio.

Se pueden especificar varias condiciones mediante más de un argumento --condition.

--name -n

Nombre de la regla de alertas.

--resource-group -g

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

--scopes

Lista separada por espacios de ámbitos a los que se aplica la regla. Los recursos especificados en este parámetro deben ser del mismo tipo y existir en la misma ubicación.

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.

--action -a

Agregue un grupo de acciones y las propiedades de webhook opcionales que se activarán cuando se desencadene la alerta.

Uso: --action ACTION_GROUP_NAME_OR_ID [KEY=VAL [KEY=VAL ...]]

Se pueden especificar varios grupos de acciones mediante más de un argumento --action.

--auto-mitigate

Resuelva automáticamente la alerta.

Propiedad Valor
Valores aceptados: false, true
--description

Descripción de texto libre de la regla.

--disabled

Cree la regla en un estado deshabilitado.

Propiedad Valor
Valor predeterminado: False
Valores aceptados: false, true
--evaluation-frequency

Frecuencia con la que se va a evaluar la regla en formato "##h##m##s".

Propiedad Valor
Valor predeterminado: 1m
--region --target-resource-region

Región de los recursos de destino en ámbitos. Esto debe proporcionarse cuando los ámbitos son grupos de recursos o suscripción.

--severity

Gravedad de la alerta de 0 (crítico) a 4 (detallado).

Propiedad Valor
Valor predeterminado: 2
--tags

Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.

--target-resource-type --type

Tipo de recurso de los recursos de destino en ámbitos. Esto debe proporcionarse cuando los ámbitos son grupos de recursos o suscripción.

--window-size

Tiempo con el que agregar métricas en formato "##h##m##s".

Propiedad Valor
Valor predeterminado: 5m
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 alert delete

Editar

Elimine una regla de alertas basada en métricas.

az monitor metrics alert delete [--ids]
                                [--name]
                                [--resource-group]
                                [--subscription]

Ejemplos

Elimine una regla de alertas basada en métricas.

az monitor metrics alert delete --name MyAlertRule --resource-group MyResourceGroup

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.

--ids

Uno o varios identificadores de recursos (delimitados por espacio). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

Propiedad Valor
Parameter group: Resource Id Arguments
--name -n

Nombre de la regla de alertas.

Propiedad Valor
Parameter group: Resource Id Arguments
--resource-group -g

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

Propiedad Valor
Parameter group: Resource Id Arguments
--subscription

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

Propiedad Valor
Parameter group: Resource Id 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.

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

Editar

Enumera las reglas de alertas basadas en métricas.

az monitor metrics alert list [--resource-group]

Ejemplos

Enumera las reglas de alertas basadas en métricas.

az monitor metrics alert list --resource-group MyResourceGroup

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.

--resource-group -g

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

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

Editar

Mostrar una regla de alertas basada en métricas.

az monitor metrics alert show [--ids]
                              [--name]
                              [--resource-group]
                              [--subscription]

Ejemplos

Mostrar una regla de alertas basada en métricas.

az --name MyAlertRule --resource-group MyResourceGroup

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.

--ids

Uno o varios identificadores de recursos (delimitados por espacio). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

Propiedad Valor
Parameter group: Resource Id Arguments
--name -n

Nombre de la regla de alertas.

Propiedad Valor
Parameter group: Resource Id Arguments
--resource-group -g

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

Propiedad Valor
Parameter group: Resource Id Arguments
--subscription

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

Propiedad Valor
Parameter group: Resource Id 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.

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

Editar

Actualice una regla de alertas basada en métricas.

az monitor metrics alert update [--add]
                                [--add-action --add-actions]
                                [--add-condition --add-conditions]
                                [--auto-mitigate {0, 1, f, false, n, no, t, true, y, yes}]
                                [--description]
                                [--enabled {0, 1, f, false, n, no, t, true, y, yes}]
                                [--evaluation-frequency]
                                [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                                [--ids]
                                [--name]
                                [--remove]
                                [--remove-actions]
                                [--remove-conditions]
                                [--resource-group]
                                [--scopes]
                                [--set]
                                [--severity]
                                [--subscription]
                                [--tags]
                                [--window-size]

Ejemplos

Deshabilite o habilite una regla de alertas basada en métricas.

az monitor metrics alert update --enabled false --name MyAlertRule --resource-group MyResourceGroup

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.

--add

Agregue un objeto a una lista de objetos especificando una ruta de acceso y pares clave-valor. Ejemplo: --add property.listProperty <key=value, string or JSON string>.

Propiedad Valor
Parameter group: Generic Update Arguments
--add-action --add-actions

Agregue un grupo de acciones y las propiedades de webhook opcionales que se activarán cuando se desencadene la alerta.

Uso: --add-action ACTION_GROUP_NAME_OR_ID [KEY=VAL [KEY=VAL ...]]

Se pueden especificar varios grupos de acciones mediante más de un argumento --add-action. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

Propiedad Valor
Parameter group: Action Arguments
--add-condition --add-conditions

Agregue una condición que desencadene la regla.

Uso: --add-condition {avg,min,max,total,count} [NAMESPACE.]MÉTRICA [{=,!=,>,>=,<,<=} THRESHOLD] [{>,><,<} INFRACCIONES de CONFIDENCIALIDAD dinámicas de EVALUACIONES [desde DATETIME]] [donde DIMENSION {includes,excludes} VALUE [o VALUE ...] [y DIMENSION {includes,excludes} VALUE [or VALUE ...] ...]]

La sensibilidad puede ser "baja", "media", "alta".

Las infracciones pueden ser el número de infracciones para desencadenar una alerta. Debe ser menor o igual que la evaluación.

Las evaluaciones pueden ser el número de períodos de evaluación para el umbral dinámico.

Datetime puede ser la fecha desde la que empezar a aprender los datos históricos de la métrica y calcular los umbrales dinámicos (en formato ISO8601).

Las dimensiones se pueden consultar agregando la palabra clave "where" y se pueden consultar varias dimensiones mediante la combinación de ellas con la palabra clave "and".

Los valores de METRIC, DIMENSION y los valores THRESHOLD adecuados se pueden obtener de az monitor metrics list-definitions comando.

Debido a la limitación del servidor, cuando una regla de alerta contiene varios criterios, el uso de dimensiones se limita a un valor por dimensión dentro de cada criterio.

Se pueden especificar varias condiciones mediante más de un argumento --add-condition. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

Propiedad Valor
Parameter group: Condition Arguments
--auto-mitigate

Resuelva automáticamente la alerta.

Propiedad Valor
Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--description

Descripción de texto libre de la regla.

--enabled

Indica si la regla de alertas de métricas está habilitada.

Propiedad Valor
Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--evaluation-frequency

Frecuencia con la que se evalúa la regla en formato ##h##m##s.

--force-string

Al usar 'set' o 'add', conserve los literales de cadena en lugar de intentar convertir en JSON.

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

Uno o varios identificadores de recursos (delimitados por espacio). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

Propiedad Valor
Parameter group: Resource Id Arguments
--name -n

Nombre de la regla de alertas.

Propiedad Valor
Parameter group: Resource Id Arguments
--remove

Quite una propiedad o un elemento de una lista. Ejemplo: --remove property.list <indexToRemove> O --remove propertyToRemove.

Propiedad Valor
Parameter group: Generic Update Arguments
--remove-actions

Lista separada por espacios de nombres de grupo de acciones que se van a quitar. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

Propiedad Valor
Parameter group: Action Arguments
--remove-conditions

Lista separada por espacios de nombres de condición que se van a quitar. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

Propiedad Valor
Parameter group: Condition Arguments
--resource-group -g

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

Propiedad Valor
Parameter group: Resource Id Arguments
--scopes

Lista separada por espacios de ámbitos a los que se aplica la regla. Los recursos especificados en este parámetro deben ser del mismo tipo y existir en la misma ubicación. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--set

Actualice un objeto especificando una ruta de acceso de propiedad y un valor que se va a establecer. Ejemplo: --set property1.property2=<value>.

Propiedad Valor
Parameter group: Generic Update Arguments
--severity

Gravedad de la alerta de 0 (crítico) a 4 (detallado).

--subscription

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

Propiedad Valor
Parameter group: Resource Id Arguments
--tags

Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--window-size

Tiempo a lo largo del cual se van a agregar métricas en formato ##h##m##s.

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.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False