Compartir a través de

az monitor activity-log alert

  • Referencia

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.

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

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

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

 Principal GA
az monitor activity-log alert create

Cree una regla de alerta de registro de actividad predeterminada.

 Principal GA
az monitor activity-log alert delete

Elimine una alerta del registro de actividad.

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

 Principal GA
az monitor activity-log alert scope

Administrar reglas de alertas del registro de actividad.

 Principal GA
az monitor activity-log alert scope add

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

 Principal GA
az monitor activity-log alert scope remove

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

 Principal GA
az monitor activity-log alert show

Obtenga una alerta del registro de actividad.

 Principal GA
az monitor activity-log alert update

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

 Principal GA

az monitor activity-log alert create

Editar

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

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

Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
Valor predeterminado: False
--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 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 activity-log alert delete

Editar

Elimine una alerta del registro de actividad.

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

Parámetros opcionales

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

Nombre de la alerta del registro de actividad.

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

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

Editar

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

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

Editar

Obtenga una alerta del registro de actividad.

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

Parámetros opcionales

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

Nombre de la alerta del registro de actividad.

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

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

Editar

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

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

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

Nombre de la alerta del registro de actividad.

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

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

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.

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

--remove

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

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

--subscription

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

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