Compartilhar via

az monitor metrics alert

  • Referência

Gerenciar regras de alerta de métrica quase em tempo real.

Comandos

Nome Description Tipo Status
az monitor metrics alert condition

Gerenciar condições de regra de alerta de métrica quase em tempo real.

 Núcleo GA
az monitor metrics alert condition create

Crie uma condição de regra de alerta de métrica.

 Núcleo Visualizar
az monitor metrics alert create

Crie uma regra de alerta baseada em métrica.

 Núcleo GA
az monitor metrics alert delete

Exclua uma regra de alerta baseada em métricas.

 Núcleo GA
az monitor metrics alert dimension

Gerenciar dimensões de regra de alerta de métrica quase em tempo real.

 Núcleo GA
az monitor metrics alert dimension create

Crie uma dimensão de regra de alerta de métrica.

 Núcleo Visualizar
az monitor metrics alert list

Listar regras de alerta baseadas em métrica.

 Núcleo GA
az monitor metrics alert show

Mostrar uma regra de alerta baseada em métricas.

 Núcleo GA
az monitor metrics alert update

Atualize uma regra de alerta baseada em métrica.

 Núcleo GA

az monitor metrics alert create

Editar

Crie uma regra de alerta baseada em métrica.

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]

Exemplos

Crie um alerta de uso de CPU alto em uma VM sem nenhuma ação.

az monitor metrics alert create -n alert1 -g {ResourceGroup} --scopes {VirtualMachineID} --condition "avg Percentage CPU > 90" --description "High CPU"

Crie um alerta de uso de CPU alto em uma VM com ações de email e 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"

Crie um alerta quando uma conta de armazenamento mostrar um alto número de transações lentas usando filtros multidimensionais.

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"

Crie uma regra de alerta baseada em métrica que monitore uma 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

Crie um alerta de uso de CPU alto em várias VMs sem ações.

az monitor metrics alert create -n alert1 -g {ResourceGroup} --scopes {VirtualMachineID1} {VirtualMachineID2} {VirtualMachineID3} \
    --condition "avg Percentage CPU > 90" --description "High CPU" --region westus

Crie um alerta de uso dinâmico da CPU em várias VMs sem ações.

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 Exigidos

--condition

A condição que dispara a regra. Ele pode ser criado pelo comando 'az monitor metrics alert condition create'.

Uso: --condition {avg, min,max, total,count} [NAMESPACE.]METRIC [{=,!=,>,>=,<,<=} THRESHOLD] [{>,><,<} VIOLAÇÕES DINÂMICAS DE CONFIDENCIALIDADE de AVALIAÇÕES [desde DATETIME]] [em que DIMENSão {inclui, exclui} VALOR [ou VALOR ...] [e DIMENSION {includes,excludes} VALUE [ou VALUE ...] ...]] [com skipmetricvalidation]

A sensibilidade pode ser 'baixa', 'média', 'alta'.

Violações podem ser o número de violações para disparar um alerta. Deve ser menor ou igual à avaliação.

As avaliações podem ser o número de períodos de avaliação para o limite dinâmico.

Datetime pode ser a data da qual começar a aprender os dados históricos da métrica e calcular os limites dinâmicos (no formato ISO8601).

As dimensões podem ser consultadas adicionando a palavra-chave 'where' e várias dimensões podem ser consultadas combinando-as com a palavra-chave 'and'.

Os valores de METRIC, DIMENSION e THRESHOLD apropriados podem ser obtidos do comando az monitor metrics list-definitions.

Devido à limitação do servidor, quando uma regra de alerta contém vários critérios, o uso de dimensões é limitado a um valor por dimensão dentro de cada critério.

Várias condições podem ser especificadas usando mais de um argumento --condition.

--name -n

Nome da regra de alerta.

--resource-group -g

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

--scopes

Lista de escopos separados por espaço a que a regra se aplica. Os recursos especificados nesse parâmetro devem ser do mesmo tipo e existir no mesmo local.

Parâmetros Opcionais

--action -a

Adicione um grupo de ações e propriedades opcionais de webhook para disparar quando o alerta for disparado.

Uso: --action ACTION_GROUP_NAME_OR_ID [KEY=VAL [KEY=VAL ...]]

Vários grupos de ações podem ser especificados usando mais de um argumento --action.

--auto-mitigate

Resolva automaticamente o alerta.

Valores aceitos: false, true
--description

Descrição de texto livre da regra.

--disabled

Crie a regra em um estado desabilitado.

Valores aceitos: false, true
Valor padrão: False
--evaluation-frequency

Frequência com a qual avaliar a regra no formato "##h##m##s".

Valor padrão: 1m
--region --target-resource-region

A região dos recursos de destino em escopos. Isso deve ser fornecido quando os escopos são grupo de recursos ou assinatura.

--severity

Gravidade do alerta de 0 (crítico) para 4 (detalhado).

Valor padrão: 2
--tags

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

--target-resource-type --type

O tipo de recurso dos recursos de destino nos escopos. Isso deve ser fornecido quando os escopos são grupo de recursos ou assinatura.

--window-size

Tempo sobre o qual agregar métricas no formato "##h##m##s".

Valor padrão: 5m
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

Apenas mostrar 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 metrics alert delete

Editar

Exclua uma regra de alerta baseada em métricas.

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

Exemplos

Exclua uma regra de alerta baseada em métricas.

az monitor metrics alert delete --name MyAlertRule --resource-group MyResourceGroup

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

Apenas mostrar 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 metrics alert list

Editar

Listar regras de alerta baseadas em métrica.

az monitor metrics alert list [--resource-group]

Exemplos

Listar regras de alerta baseadas em métrica.

az monitor metrics alert 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

Apenas mostrar 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 metrics alert show

Editar

Mostrar uma regra de alerta baseada em métricas.

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

Exemplos

Mostrar uma regra de alerta baseada em métricas.

az --name MyAlertRule --resource-group MyResourceGroup

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

Apenas mostrar 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 metrics alert update

Editar

Atualize uma regra de alerta baseada em métrica.

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]

Exemplos

Desabilitar/Habilitar uma regra de alerta baseada em métrica.

az monitor metrics alert update --enabled false --name MyAlertRule --resource-group MyResourceGroup

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

--add-action --add-actions

Adicione um grupo de ações e propriedades opcionais de webhook para disparar quando o alerta for disparado.

Uso: --add-action ACTION_GROUP_NAME_OR_ID [KEY=VAL [KEY=VAL ...]]

Vários grupos de ações podem ser especificados usando mais de um argumento --add-action. Suporte a sintaxe abreviada, arquivo json e yaml-file. Tente "??" para mostrar mais.

--add-condition --add-conditions

Adicione uma condição que dispara a regra.

Uso: --add-condition {avg, min, max, total,count} [NAMESPACE.]METRIC [{=,!=,>,>=,<,<=} THRESHOLD] [{>,><,<} VIOLAÇÕES DINÂMICAS DE CONFIDENCIALIDADE de AVALIAÇÕES [desde DATETIME]] [em que DIMENSão {inclui, exclui} VALOR [ou VALOR ...] [e DIMENSION {includes,excludes} VALUE [ou VALUE ...] ...]]

A sensibilidade pode ser 'baixa', 'média', 'alta'.

Violações podem ser o número de violações para disparar um alerta. Deve ser menor ou igual à avaliação.

As avaliações podem ser o número de períodos de avaliação para o limite dinâmico.

Datetime pode ser a data da qual começar a aprender os dados históricos da métrica e calcular os limites dinâmicos (no formato ISO8601).

As dimensões podem ser consultadas adicionando a palavra-chave 'where' e várias dimensões podem ser consultadas combinando-as com a palavra-chave 'and'.

Os valores de METRIC, DIMENSION e THRESHOLD apropriados podem ser obtidos do comando az monitor metrics list-definitions.

Devido à limitação do servidor, quando uma regra de alerta contém vários critérios, o uso de dimensões é limitado a um valor por dimensão dentro de cada critério.

Várias condições podem ser especificadas usando mais de um argumento --add-condition. Suporte a sintaxe abreviada, arquivo json e yaml-file. Tente "??" para mostrar mais.

--auto-mitigate

Resolva automaticamente o alerta.

Valores aceitos: 0, 1, f, false, n, no, t, true, y, yes
--description

Descrição de texto livre da regra.

--enabled

Se a regra de alerta de métrica está habilitada.

Valores aceitos: 0, 1, f, false, n, no, t, true, y, yes
--evaluation-frequency

Frequência com a qual avaliar a regra no formato ##h##m##s.

--force-string

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

Valores aceitos: 0, 1, f, false, n, no, t, true, y, yes
--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 alerta.

--remove

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

--remove-actions

Lista separada por espaço de nomes de grupo de ações a serem removidos. Suporte a sintaxe abreviada, arquivo json e yaml-file. Tente "??" para mostrar mais.

--remove-conditions

Lista separada por espaço de nomes de condição a serem removidos. Suporte a sintaxe abreviada, arquivo json e yaml-file. Tente "??" para mostrar mais.

--resource-group -g

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

--scopes

Lista de escopos separados por espaço a que a regra se aplica. Os recursos especificados nesse parâmetro devem ser do mesmo tipo e existir no mesmo local. Suporte a sintaxe abreviada, arquivo json e yaml-file. Tente "??" para mostrar mais.

--set

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

--severity

Gravidade do alerta de 0 (crítico) para 4 (detalhado).

--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] ...]. Suporte a sintaxe abreviada, arquivo json e yaml-file. Tente "??" para mostrar mais.

--window-size

Tempo sobre o qual agregar métricas no formato ##h##m##s.

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

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