Compartir a través de

az monitor metrics alert

  • Referencia

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 Versión preliminar
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 Versión preliminar
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]
                                [--severity]
                                [--tags]
                                [--target-resource-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 [{=,!=,>>=,,<<=} UMBRAL] [{<,>,,><} INFRACCIONES DINÁMICAS DE CONFIDENCIALIDAD DE LAS 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 desde az monitor metrics list-definitions el 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 --condition argumento.

--name -n

Nombre de la regla de alerta.

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

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

--auto-mitigate

Resuelva automáticamente la alerta.

valores aceptados: false, true
--description

Descripción de texto libre de la regla.

--disabled

Cree la regla en un estado deshabilitado.

valores aceptados: false, true
valor predeterminado: False
--evaluation-frequency

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

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

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 a lo largo del cual se agregan métricas en formato "##h##m##s".

valor predeterminado: 5m
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 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

--ids

Uno o varios identificadores de recursos (delimitados por espacios). 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".

--name -n

Nombre de la regla de alerta.

--resource-group -g

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

--subscription

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

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

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

--ids

Uno o varios identificadores de recursos (delimitados por espacios). 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".

--name -n

Nombre de la regla de alerta.

--resource-group -g

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

--subscription

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

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

Editar

Actualice una regla de alertas basada en métricas.

az monitor metrics alert update [--add]
                                [--add-action]
                                [--add-condition]
                                [--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

--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 o JSON string>.

--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 --add-action argumento. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--add-condition --add-conditions

Agregue una condición que desencadene la regla.

Uso: --add-condition {avg,min,max,total,count} [NAMESPACE.] MÉTRICA [{=,!=,>>=,,<<=} UMBRAL] [{<,>,,><} INFRACCIONES DINÁMICAS DE CONFIDENCIALIDAD DE LAS 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 desde az monitor metrics list-definitions el 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 --add-condition argumento. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--auto-mitigate

Resuelva automáticamente la alerta.

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.

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

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

--force-string

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

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

Uno o varios identificadores de recursos (delimitados por espacios). 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".

--name -n

Nombre de la regla de alerta.

--remove

Quite una propiedad o un elemento de una lista. Ejemplo: --remove property.list OR --remove propertyToRemove.

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

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

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

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

--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 ##h##m##s formato.

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.