Compartir a través de


az monitor activity-log alert

Administrar reglas de alertas del registro de actividad.

Comandos

Nombre Description Tipo Estado
az monitor activity-log alert action-group

Administrar reglas de alertas del registro de actividad.

Core GA
az monitor activity-log alert action-group add

Agregue grupos de acciones a esta regla de alertas del registro de actividad. También se puede usar para sobrescribir las propiedades de webhook existentes de grupos de acciones concretos.

Core GA
az monitor activity-log alert action-group remove

Quite los grupos de acciones de esta regla de alertas del registro de actividad.

Core GA
az monitor activity-log alert create

Cree una regla de alerta de registro de actividad predeterminada.

Core GA
az monitor activity-log alert delete

Elimine una alerta del registro de actividad.

Core GA
az monitor activity-log alert list

Enumera las reglas de alertas del registro de actividad en un grupo de recursos o en la suscripción actual.

Core GA
az monitor activity-log alert scope

Administrar reglas de alertas del registro de actividad.

Core GA
az monitor activity-log alert scope add

Agregue ámbitos a esta regla de alertas del registro de actividad.

Core GA
az monitor activity-log alert scope remove

Quita los ámbitos de esta regla de alertas del registro de actividad.

Core GA
az monitor activity-log alert show

Obtenga una alerta del registro de actividad.

Core GA
az monitor activity-log alert update

Actualice una nueva alerta del registro de actividad o actualice una existente.

Core GA

az monitor activity-log alert create

Cree una regla de alerta de registro de actividad predeterminada.

Este comando creará un registro de actividad predeterminado con una condición que se compara si el campo "categoría" de las actividades es igual a "ServiceHealth". La alerta del registro de actividad recién creada no tiene ningún grupo de acciones asociado.

az monitor activity-log alert create --activity-log-alert-name --name
                                     --resource-group
                                     [--action-group]
                                     [--all-of]
                                     [--condition]
                                     [--description]
                                     [--disable {0, 1, f, false, n, no, t, true, y, yes}]
                                     [--scope]
                                     [--tags]
                                     [--webhook-properties]

Ejemplos

Cree una regla de alertas con la configuración predeterminada.

az monitor activity-log alert create -n AlertName -g ResourceGroup

Cree una regla de alerta con condición sobre el registro de estado del servicio de nivel de error.

az monitor activity-log alert create -n AlertName -g ResourceGroup --condition category=ServiceHealth and level=Error

Cree una regla de alertas con un grupo de acciones y especifique las propiedades del webhook.

az monitor activity-log alert create -n AlertName -g ResourceGroup -a /subscriptions/{SubID}/resourceGroups/{ResourceGroup}/providers/microsoft.insights/actionGroups/{ActionGroup} -w usage=test owner=jane

Cree una regla de alertas que esté deshabilitada inicialmente.

az monitor activity-log alert create -n AlertName -g ResourceGroup --disable

Parámetros requeridos

--activity-log-alert-name --name -n

Nombre de la alerta del registro de actividad.

--resource-group -g

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

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--action-group -a

Agregue un grupo de acciones. Acepta identificadores de grupo de acciones separados por espacios. El identificador puede ser el nombre del grupo de acciones o su identificador de recurso. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--all-of

Lista de condiciones de regla de alertas del registro de actividad. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--condition -c

Condición que hará que la regla de alerta se active. El formato es FIELD=VALUE[ y FIELD=VALUE...] Los valores posibles para el campo son 'resourceId', 'category', 'caller', 'level', 'operationName', 'resourceGroup', 'resourceProvider', 'status', 'subStatus', 'resourceType', o cualquier elemento que empiece por 'properties'. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--description

Descripción de esta regla de alerta del registro de actividad.

--disable

Deshabilite la regla de alertas del registro de actividad después de crearla.

Propiedad Valor
Valor predeterminado: False
Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--scope -s

Lista de cadenas que se usarán como prefijos. La regla de alerta solo se aplicará a los registros de actividad con resourceID que se encuentran en uno de estos prefijos. Si no se proporciona, se usará subscriptionId. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--tags

Etiquetas del recurso. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--webhook-properties -w

Propiedades de webhook separadas por espacios en formato "key[=value]". Estas propiedades están asociadas a los grupos de acciones agregados en este comando. Para cualquier receptor de webhook de este grupo de acciones, estos datos se anexan a la carga del webhook. Para adjuntar diferentes propiedades de webhook a diferentes grupos de acciones, agregue los grupos de acciones en comandos de acción de actualización independientes. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar 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

Formato de salida.

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 activity-log alert delete

Elimine una alerta del registro de actividad.

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

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--activity-log-alert-name --name -n

Nombre de la alerta del registro de actividad.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--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
Grupo de parámetros: Resource Id Arguments
--resource-group -g

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

Propiedad Valor
Grupo de parámetros: 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
Grupo de parámetros: 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

Formato de salida.

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

Enumera las reglas de alertas del registro de actividad en un grupo de recursos o en la suscripción actual.

az monitor activity-log alert list [--resource-group]

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

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

Formato de salida.

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

Obtenga una alerta del registro de actividad.

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

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--activity-log-alert-name --name -n

Nombre de la alerta del registro de actividad.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--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
Grupo de parámetros: Resource Id Arguments
--resource-group -g

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

Propiedad Valor
Grupo de parámetros: 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
Grupo de parámetros: 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

Formato de salida.

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

Actualice una nueva alerta del registro de actividad o actualice una existente.

az monitor activity-log alert update [--activity-log-alert-name --name]
                                     [--add]
                                     [--all-of]
                                     [--condition]
                                     [--description]
                                     [--enabled {0, 1, f, false, n, no, t, true, y, yes}]
                                     [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                                     [--ids]
                                     [--remove]
                                     [--resource-group]
                                     [--set]
                                     [--subscription]
                                     [--tags]

Ejemplos

Actualización de la condición

az monitor activity-log alert update -n AlertName -g ResourceGroup --condition category=ServiceHealth and level=Error

Deshabilite una regla de alertas.

az monitor activity-log alert update -n AlertName -g ResourceGroup --enable false

Actualice los detalles de esta regla de alertas del registro de actividad.

az monitor activity-log alert update --enabled true --name MyActivityLogAlerts --resource- group MyResourceGroup --subscription MySubscription

Actualice los detalles de esta alerta del registro de actividad.

az monitor activity-log alert update --name MyActivityLogAlerts --resource-group MyResourceGroup --tags key=value

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--activity-log-alert-name --name -n

Nombre de la alerta del registro de actividad.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--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
Grupo de parámetros: Generic Update Arguments
--all-of

Lista de condiciones de regla de alertas del registro de actividad. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--condition -c

Condición que hará que la regla de alerta se active. El formato es FIELD=VALUE[ y FIELD=VALUE...] Los valores posibles para el campo son 'resourceId', 'category', 'caller', 'level', 'operationName', 'resourceGroup', 'resourceProvider', 'status', 'subStatus', 'resourceType', o cualquier elemento que empiece por 'properties'. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--description

Descripción de esta regla de alerta del registro de actividad.

--enabled

Indica si esta regla de alerta del registro de actividad está habilitada. Si una regla de alerta del registro de actividad no está habilitada, no se activará ninguna de sus acciones.

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

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

Propiedad Valor
Grupo de parámetros: 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
Grupo de parámetros: Resource Id Arguments
--remove

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

Propiedad Valor
Grupo de parámetros: Generic Update Arguments
--resource-group -g

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

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--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
Grupo de parámetros: Generic Update 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
Grupo de parámetros: Resource Id Arguments
--tags

Etiquetas del recurso. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar 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

Formato de salida.

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