Compartir a través de

az monitor alert-processing-rule

  • Vista previa
  • Referencia

Nota:

Esta referencia forma parte de la extensión alertsmanagement para la CLI de Azure (versión 2.45.0 o posterior). La extensión instalará automáticamente la primera vez que ejecute un comando az monitor alert-processing-rule . Obtenga más información sobre las extensiones.

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

Administrar la regla de procesamiento de alertas con alertsmanagement.

Comandos

Nombre Description Tipo Estado
az monitor alert-processing-rule create

Creación de una regla de procesamiento de alertas.

 Extensión Vista previa
az monitor alert-processing-rule delete

Elimine una regla de procesamiento de alertas.

 Extensión Vista previa
az monitor alert-processing-rule list

Enumere todas las reglas de procesamiento de alertas en una suscripción o grupo de recursos.

 Extensión Vista previa
az monitor alert-processing-rule show

Obtener una regla de procesamiento de alertas.

 Extensión Vista previa
az monitor alert-processing-rule update

Habilite, deshabilite o actualice etiquetas para una regla de procesamiento de alertas.

 Extensión Vista previa

az monitor alert-processing-rule create

Vista previa

El grupo de comandos "monitor alert-processing-rule" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Creación de una regla de procesamiento de alertas.

az monitor alert-processing-rule create --name
                                        --resource-group
                                        --rule-type {AddActionGroups, RemoveAllActionGroups}
                                        --scopes
                                        [--action-groups]
                                        [--description]
                                        [--enabled {false, true}]
                                        [--filter-alert-context]
                                        [--filter-alert-rule-description]
                                        [--filter-alert-rule-id]
                                        [--filter-alert-rule-name]
                                        [--filter-monitor-condition]
                                        [--filter-monitor-service]
                                        [--filter-resource-group]
                                        [--filter-resource-type]
                                        [--filter-severity]
                                        [--filter-signal-type]
                                        [--filter-target-resource]
                                        [--schedule-end-datetime]
                                        [--schedule-recurrence]
                                        [--schedule-recurrence-2]
                                        [--schedule-recurrence-2-end-time]
                                        [--schedule-recurrence-2-start-time]
                                        [--schedule-recurrence-2-type {Daily, Monthly, Weekly}]
                                        [--schedule-recurrence-end-time]
                                        [--schedule-recurrence-start-time]
                                        [--schedule-recurrence-type {Daily, Monthly, Weekly}]
                                        [--schedule-start-datetime]
                                        [--schedule-time-zone]
                                        [--tags]

Ejemplos

Crear o actualizar una regla que agrega un grupo de acciones a todas las alertas de una suscripción

az monitor alert-processing-rule create \
--name 'AddActionGroupToSubscription' \
--rule-type AddActionGroups \
--scopes "/subscriptions/MySubscriptionId" \
--action-groups "/subscriptions/MySubscriptionId/resourcegroups/MyResourceGroup1/providers/microsoft.insights/actiongroups/ActionGroup1" \
--enabled true \
--resource-group alertscorrelationrg \
--description "Add ActionGroup1 to all alerts in the subscription"

Cree o actualice una regla que agregue dos grupos de acciones a todas las alertas de Sev0 y Sev1 en dos grupos de recursos.

az monitor alert-processing-rule create \
--name 'AddActionGroupsBySeverity' \
--rule-type AddActionGroups \
--action-groups "/subscriptions/MySubscriptionId/resourcegroups/MyResourceGroup1/providers/microsoft.insights/actiongroups/MyActionGroupId1" "/subscriptions/MySubscriptionId/resourceGroups/MyResourceGroup2/providers/microsoft.insights/actionGroups/MyActionGroup2" \
--scopes "/subscriptions/MySubscriptionId" \
--resource-group alertscorrelationrg \
--filter-severity Equals Sev0 Sev1 \
--description "Add AGId1 and AGId2 to all Sev0 and Sev1 alerts in these resourceGroups"

Cree o actualice una regla que quite todos los grupos de acciones de las alertas de una máquina virtual específica durante una ventana de mantenimiento puntual (1800-2000 en una fecha específica, Hora estándar del Pacífico).

az monitor alert-processing-rule create \
--name 'RemoveActionGroupsMaintenanceWindow' \
--rule-type RemoveAllActionGroups \
--scopes "/subscriptions/MySubscriptionId/resourceGroups/MyResourceGroup1/providers/Microsoft.Compute/virtualMachines/VMName" \
--resource-group alertscorrelationrg \
--schedule-start-datetime '2022-01-02 18:00:00' \
--schedule-end-datetime '2022-01-02 20:00:00' \
--schedule-time-zone 'Pacific Standard Time' \
--description "Removes all ActionGroups from all Alerts on VMName during the maintenance window"

Cree o actualice una regla que quite todos los grupos de acciones de todas las alertas de una suscripción procedentes de una regla de alerta específica.

az monitor alert-processing-rule create \
--name 'RemoveActionGroupsSpecificAlertRule' \
--rule-type RemoveAllActionGroups \
--scopes "/subscriptions/MySubscriptionId" \
--resource-group alertscorrelationrg \
--filter-alert-rule-id Equals "/subscriptions/MySubscriptionId/resourceGroups/MyResourceGroup1/providers/microsoft.insights/activityLogAlerts/RuleName" \
--description "Removes all ActionGroups from all Alerts that fire on above AlertRule"

Cree o actualice una regla que quite todos los grupos de acciones de todas las alertas de cualquier máquina virtual de dos grupos de recursos durante una ventana de mantenimiento periódica (2200-0400 cada sat y sol, hora estándar de la India)

az monitor alert-processing-rule create \
--name 'RemoveActionGroupsRecurringMaintenance' \
--rule-type RemoveAllActionGroups \
--scopes "/subscriptions/MySubscriptionId/resourceGroups/MyResourceGroup1" "/subscriptions/MySubscriptionId/resourceGroups/MyResourceGroup2" \
--resource-group alertscorrelationrg \
--filter-resource-type Equals "microsoft.compute/virtualmachines" \
--schedule-time-zone "India Standard Time" \
--schedule-recurrence-type Weekly \
--schedule-recurrence-start-time "22:00:00" \
--schedule-recurrence-end-time "04:00:00" \
--schedule-recurrence Sunday Saturday \
--description "Remove all ActionGroups from all Virtual machine Alerts during the recurring maintenance"

Cree o actualice una regla que quite todos los grupos de acciones fuera del horario comercial (Mon-Fri 09:00-17:00, Hora estándar del Este)

az monitor alert-processing-rule create \
--name 'RemoveActionGroupsOutsideBusinessHours' \
--rule-type RemoveAllActionGroups \
--scopes "/subscriptions/MySubscriptionId" \
--resource-group alertscorrelationrg \
--schedule-time-zone "Eastern Standard Time" \
--schedule-recurrence-type Daily \
--schedule-recurrence-start-time "17:00:00" \
--schedule-recurrence-end-time "09:00:00" \
--schedule-recurrence-2-type Weekly \
--schedule-recurrence-2 Saturday Sunday \
--description "Remove all ActionGroups outside business hours"

Parámetros requeridos

--name -n

Nombre de la regla de procesamiento de alertas.

--resource-group -g

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

--rule-type

Indique el tipo de la regla de procesamiento de alertas.

valores aceptados: AddActionGroups, RemoveAllActionGroups
--scopes

Lista de identificadores de recursos (delimitados por espacio) para el ámbito. La regla se aplicará a las alertas que se desencadenaron en los recursos dentro de ese ámbito.

Parámetros opcionales

--action-groups

Lista de identificadores de recursos (delimitados por espacio) de grupos de acciones que se van a agregar. Un uso de este argumento requiere que el tipo de regla sea AddActionGroups.

--description

Descripción de la regla de procesamiento de alertas.

--enabled

Indique si la regla de procesamiento de alertas especificada está habilitada o deshabilitada (el valor predeterminado está habilitado).

valores aceptados: false, true
--filter-alert-context

Filtre las alertas por contexto de alerta (carga).

El formato de filtro es donde Operator: uno de <Equals, NotEquals, Contains, DoesNotContain> Values: Lista de valores que deben coincidir con una condición determinada.

--filter-alert-rule-description

Filtre las alertas por descripción de la regla de alertas.

--filter-alert-rule-id

Filtre las alertas por identificador de alerta.

--filter-alert-rule-name

Filtre las alertas por nombre de regla de alerta.

--filter-monitor-condition

Filtre las alertas por condición de supervisión.

--filter-monitor-service

Filtre las alertas por servicio de supervisión.

--filter-resource-group

Filtre las alertas por grupo de recursos.

--filter-resource-type

Filtre las alertas por tipo de recurso.

--filter-severity

Filtre las alertas por gravedad <Sev0, Sev1, Sev2, Sev3, Sev4>.

--filter-signal-type

Filtre las alertas por tipo de señal.

--filter-target-resource

Filtre las alertas por recurso.

--schedule-end-datetime

Fecha de finalización de la regla. Formato: 'AAAA-MM-DD hh:mm:ss'.

--schedule-recurrence

Lista de valores de patrón de periodicidad.

--schedule-recurrence: lista de valores de patrón de periodicidad (delimitados por espacio). Para un tipo de periodicidad semanal, los valores permitidos son domingo a sábado. Para un tipo de periodicidad mensual, los valores permitidos son de 1 a 31 (días de mes).

--schedule-recurrence-2

Lista de valores de patrón de periodicidad para el segundo patrón de periodicidad.

--schedule-recurrence-2: lista de valores de patrón de periodicidad (delimitados por espacio). Para un tipo de periodicidad semanal, los valores permitidos son domingo a sábado. Para un tipo de periodicidad mensual, los valores permitidos son de 1 a 31 (días de mes).

--schedule-recurrence-2-end-time

Hora de finalización de cada periodicidad. Formato: hh:mm:ss.

--schedule-recurrence-2-start-time

Hora de inicio de cada periodicidad. Formato: hh:mm:ss.

--schedule-recurrence-2-type

Especifica cuándo se debe aplicar la regla de procesamiento. Valor predeterminado es Always.

valores aceptados: Daily, Monthly, Weekly
--schedule-recurrence-end-time

Hora de finalización de cada periodicidad. Formato: 'hh:mm:ss'.

--schedule-recurrence-start-time

Hora de inicio de cada periodicidad. Formato: 'hh:mm:ss'.

--schedule-recurrence-type

Especifica cuándo se debe aplicar la regla de procesamiento.

valores aceptados: Daily, Monthly, Weekly
--schedule-start-datetime

Fecha de inicio de la regla. Formato: 'AAAA-MM-DD hh:mm:ss'.

--schedule-time-zone

Programar zona horaria.

valor predeterminado: UTC
--tags

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

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 alert-processing-rule delete

Vista previa

El grupo de comandos "monitor alert-processing-rule" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Elimine una regla de procesamiento de alertas.

az monitor alert-processing-rule delete [--ids]
                                        [--name]
                                        [--resource-group]
                                        [--subscription]
                                        [--yes]

Ejemplos

Elimine una regla de procesamiento de alertas.

az monitor alert-processing-rule delete \
--resource-group myResourceGroup \
--name myRuleName

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 procesamiento de alertas.

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

--yes -y

No solicita confirmación.

valor predeterminado: False
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 alert-processing-rule list

Vista previa

El grupo de comandos "monitor alert-processing-rule" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Enumere todas las reglas de procesamiento de alertas en una suscripción o grupo de recursos.

az monitor alert-processing-rule list [--resource-group]

Ejemplos

Enumerar todas las reglas de procesamiento de alertas de la suscripción actual

az monitor alert-processing-rule list

Enumeración de todas las reglas de procesamiento de alertas en un grupo de recursos

az monitor alert-processing-rule 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 alert-processing-rule show

Vista previa

El grupo de comandos "monitor alert-processing-rule" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Obtener una regla de procesamiento de alertas.

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

Ejemplos

Obtención de una regla de procesamiento de alertas por nombre

az monitor alert-processing-rule show \
--name myRuleName \
--resource-group myRuleNameResourceGroup

Obtención de la regla de procesamiento de alertas por identificadores

az monitor alert-processing-rule show \
--ids ruleId1 ruleId2

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 procesamiento de alertas.

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

Vista previa

El grupo de comandos "monitor alert-processing-rule" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Habilite, deshabilite o actualice etiquetas para una regla de procesamiento de alertas.

az monitor alert-processing-rule update [--add]
                                        [--enabled {false, true}]
                                        [--force-string]
                                        [--ids]
                                        [--name]
                                        [--remove]
                                        [--resource-group]
                                        [--set]
                                        [--subscription]
                                        [--tags]

Ejemplos

PatchAlertProcessingRule

az monitor alert-processing-rule update \
--name "WeeklySuppression" \
--enabled false \
--tags key1="value1" key2="value2" --resource-group "alertscorrelationrg"

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

valor predeterminado: []
--enabled

Indique si la regla de procesamiento especificada está habilitada o deshabilitada (los valores son True y False).

valores aceptados: false, true
--force-string

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

valor predeterminado: False
--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 procesamiento de alertas.

--remove

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

valor predeterminado: []
--resource-group -g

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

--set

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

valor predeterminado: []
--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] ...]. Use "" para borrar las etiquetas existentes.

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.