Compartilhar via

az monitor alert-processing-rule

  • Versão Prévia
  • Referência

Observação

Essa referência faz parte da extensão de alertsmanagement para a CLI do Azure (versão 2.45.0 ou superior). A extensão instalará automaticamente na primeira vez que você executar um comando az monitor alert-processing-rule. Saiba mais sobre extensões.

Esse grupo de comandos está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Gerenciar a regra de processamento de alertas com alertsmanagement.

Comandos

Nome Description Tipo Status
az monitor alert-processing-rule create

Crie uma regra de processamento de alerta.

 Extensão Versão prévia
az monitor alert-processing-rule delete

Exclua uma regra de processamento de alerta.

 Extensão Versão prévia
az monitor alert-processing-rule list

Lista todas as regras de processamento de alerta em uma assinatura ou grupo de recursos.

 Extensão Versão prévia
az monitor alert-processing-rule show

Obtenha uma regra de processamento de alerta.

 Extensão Versão prévia
az monitor alert-processing-rule update

Habilitar, desabilitar ou atualizar marcas para uma regra de processamento de alerta.

 Extensão Versão prévia

az monitor alert-processing-rule create

Versão Prévia

O grupo de comandos 'monitor alert-processing-rule' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Crie uma regra de processamento de alerta.

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]

Exemplos

Criar ou atualizar uma regra que adiciona um grupo de ações a todos os alertas em uma assinatura

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"

Criar ou atualizar uma regra que adiciona dois grupos de ações a todos os alertas Sev0 e Sev1 em dois 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"

Criar ou atualizar uma regra que remove todos os grupos de ações de alertas em uma VM específica durante uma janela de manutenção única (1800-2000 em uma data específica, Hora Padrão do 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"

Criar ou atualizar uma regra que remove todos os grupos de ações de todos os alertas em uma assinatura proveniente de uma regra 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"

Criar ou atualizar uma regra que remove todos os grupos de ações de todos os alertas em qualquer VM em dois grupos de recursos durante uma janela de manutenção recorrente (2200-0400 a cada Sat e Sun, India Standard Time)

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"

Criar ou atualizar uma regra que remove todos os grupos de ações fora do horário comercial (Mon-Fri 09:00-17:00, Horário Padrão do Leste)

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 Exigidos

--name -n

Nome da regra de processamento de alerta.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--rule-type

Indique o tipo da regra de processamento de alerta.

Valores aceitos: AddActionGroups, RemoveAllActionGroups
--scopes

Lista de IDs de recurso (delimitadas por espaço) para escopo. A regra será aplicada a alertas disparados em recursos dentro desse escopo.

Parâmetros Opcionais

--action-groups

Lista de IDs de recurso (delimitadas por espaço) de grupos de ações a serem adicionados. Um uso desse argumento requer que o tipo de regra seja AddActionGroups.

--description

Descrição da regra de processamento de alerta.

--enabled

Indique se a regra de processamento de alerta fornecida está habilitada ou desabilitada (o padrão está habilitado).

Valores aceitos: false, true
--filter-alert-context

Filtrar alertas por contexto de alerta (conteúdo).

O formato de filtro é onde Operador: um dos valores de <Equals, NotEquals, Contains, DoesNotContain> Values: List of values to match for a given condition.

--filter-alert-rule-description

Filtrar alertas por descrição da regra de alerta.

--filter-alert-rule-id

Filtrar alertas por ID de alerta.

--filter-alert-rule-name

Filtrar alertas pelo nome da regra de alerta.

--filter-monitor-condition

Filtrar alertas por condição de monitor.

--filter-monitor-service

Filtrar alertas pelo serviço de monitor.

--filter-resource-group

Filtrar alertas por grupo de recursos.

--filter-resource-type

Filtrar alertas por tipo de recurso.

--filter-severity

Filtrar alertas por gravidade <Sev0, Sev1, Sev2, Sev3, Sev4>.

--filter-signal-type

Filtrar alertas por tipo de sinal.

--filter-target-resource

Filtrar alertas por recurso.

--schedule-end-datetime

Data de término da regra. Formato: 'YYYY-MM-DD hh:mm:ss'.

--schedule-recurrence

Lista de valores de padrão de recorrência.

--schedule-recurrence: lista de valores de padrão de recorrência (delimitado por espaço). Para um tipo de recorrência semanal, os valores permitidos são de domingo a sábado. Para um tipo de recorrência mensal, os valores permitidos são de 1 a 31 (dias do mês).

--schedule-recurrence-2

Lista de valores de padrão de recorrência para o segundo padrão de recorrência.

--schedule-recurrence-2: lista de valores de padrão de recorrência (delimitado por espaço). Para um tipo de recorrência semanal, os valores permitidos são de domingo a sábado. Para um tipo de recorrência mensal, os valores permitidos são de 1 a 31 (dias do mês).

--schedule-recurrence-2-end-time

Hora de término para cada recorrência. Formato: hh:mm:ss.

--schedule-recurrence-2-start-time

Hora de início para cada recorrência. Formato: hh:mm:ss.

--schedule-recurrence-2-type

Especifica quando a regra de processamento deve ser aplicada. Padrão para Always.

Valores aceitos: Daily, Monthly, Weekly
--schedule-recurrence-end-time

Hora de término para cada recorrência. Formato: 'hh:mm:ss'.

--schedule-recurrence-start-time

Hora de início para cada recorrência. Formato: 'hh:mm:ss'.

--schedule-recurrence-type

Especifica quando a regra de processamento deve ser aplicada.

Valores aceitos: Daily, Monthly, Weekly
--schedule-start-datetime

Data de início da regra. Formato: 'YYYY-MM-DD hh:mm:ss'.

--schedule-time-zone

Agendar fuso horário.

Valor padrão: UTC
--tags

Marcas separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar marcas existentes.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

az monitor alert-processing-rule delete

Versão Prévia

O grupo de comandos 'monitor alert-processing-rule' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Exclua uma regra de processamento de alerta.

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

Exemplos

Exclua uma regra de processamento de alerta.

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

Parâmetros Opcionais

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

--name -n

Nome da regra de processamento de alerta.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--yes -y

Não solicite confirmação.

Valor padrão: False
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

az monitor alert-processing-rule list

Versão Prévia

O grupo de comandos 'monitor alert-processing-rule' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Lista todas as regras de processamento de alerta em uma assinatura ou grupo de recursos.

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

Exemplos

Listar todas as regras de processamento de alerta na assinatura atual

az monitor alert-processing-rule list

Listar todas as regras de processamento de alerta em um grupo de recursos

az monitor alert-processing-rule list \
--resource-group myResourceGroup

Parâmetros Opcionais

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

az monitor alert-processing-rule show

Versão Prévia

O grupo de comandos 'monitor alert-processing-rule' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Obtenha uma regra de processamento de alerta.

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

Exemplos

Obter uma regra de processamento de alerta por nome

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

Obter a regra de processamento de alertas por IDs

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

Parâmetros Opcionais

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

--name -n

Nome da regra de processamento de alerta.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

az monitor alert-processing-rule update

Versão Prévia

O grupo de comandos 'monitor alert-processing-rule' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Habilitar, desabilitar ou atualizar marcas para uma regra de processamento de alerta.

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

Exemplos

PatchAlertProcessingRule

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

Parâmetros Opcionais

--add

Adicione um objeto a uma lista de objetos especificando um caminho e pares de valor de chave. Exemplo: --add property.listProperty <key=value, string or JSON string>.

Valor padrão: []
--enabled

Indique se a regra de processamento fornecida está habilitada ou desabilitada (os valores são True e False).

Valores aceitos: false, true
--force-string

Ao usar 'set' ou 'add', preserve literais de cadeia de caracteres em vez de tentar converter em JSON.

Valor padrão: False
--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

--name -n

Nome da regra de processamento de alerta.

--remove

Remova uma propriedade ou um elemento de uma lista. Exemplo: --remove property.list <indexToRemove> OR --remove propertyToRemove.

Valor padrão: []
--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--set

Atualize um objeto especificando um caminho de propriedade e um valor a ser definido. Exemplo: --set property1.property2=<value>.

Valor padrão: []
--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--tags

Marcas separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar marcas existentes.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.