Compartilhar via

az monitor metrics alert

  • Referência

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

Comandos

Nome Description Tipo Status
az monitor metrics alert condition

Gerencie 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

Gerencie 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étricas.

 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

Atualizar 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 alto uso da CPU 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 alto uso da CPU 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 alto uso 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 > 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 aciona a regra. Ele pode ser criado pelo comando 'az monitor metrics alert condition create'.

Uso: --condition {avg,min,max,total,count} [NAMESPACE.] METRIC [{=,!=,,=,,=} THRESHOLD] [{,,} dinâmico VIOLAÇÕES DE SENSIBILIDADE DE AVALIAÇÕES [desde DATETIME]] [onde DIMENSION {inclui,exclui>>><<><} VALOR [ou VALOR ...]< [e DIMENSÃO {inclui,exclui} VALOR [ou VALOR ...] ...]] [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 limiar dinâmico.

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

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

Valores para valores METRIC, DIMENSION e THRESHOLD apropriados podem ser obtidos a partir do az monitor metrics list-definitions comando.

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

--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 separada por espaço de escopos aos quais a regra se aplica. Os recursos especificados neste 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 de webhook opcionais para disparar quando o alerta for disparado.

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

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

--auto-mitigate

Resolva automaticamente o alerta.

valores aceitos: false, true
--description

Descrição em 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 do(s) recurso(s) de destino nos escopos. Isso deve ser fornecido quando o escopo é grupo de recursos ou assinatura.

--severity

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

valor padrão: 2
--tags

Tags separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar as tags existentes.

--target-resource-type --type

O tipo de recurso do(s) recurso(s) de destino em escopos. Isso deve ser fornecido quando o escopo é grupo de recursos ou assinatura.

--window-size

Tempo para agregar métricas no formato "##h##m##s".

valor padrão: 5m
Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--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 o detalhamento do 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 um ID de recurso completo contendo todas as informações dos argumentos 'Resource Id'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--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 o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--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 o detalhamento do log. Use --debug para logs de depuração completos.

az monitor metrics alert list

Editar

Listar regras de alerta baseadas em métricas.

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

Exemplos

Listar regras de alerta baseadas em métricas.

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 o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--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 o detalhamento do 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 um ID de recurso completo contendo todas as informações dos argumentos 'Resource Id'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--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 o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--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 o detalhamento do log. Use --debug para logs de depuração completos.

az monitor metrics alert update

Editar

Atualizar 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

Desativar/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 valores de chave. Exemplo: --add property.listProperty <key=value, string ou string> JSON.

--add-action --add-actions

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

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

Vários grupos de ação podem ser especificados usando mais de um --add-action argumento. Suporte taquigráfico-sintaxe, json-file e yaml-file. Tente "??" para mostrar mais.

--add-condition --add-conditions

Adicione uma condição que acione a regra.

Uso: --add-condition {avg,min,max,total,count} [NAMESPACE.] METRIC [{=,!=,,=,,=} THRESHOLD] [{,,} dinâmico VIOLAÇÕES DE SENSIBILIDADE DE AVALIAÇÕES [desde DATETIME]] [onde DIMENSION {inclui,exclui>>><<><} VALOR [ou VALOR ...]< [e DIMENSÃO {inclui,exclui} VALOR [ou VALOR ...] ...]]

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 limiar dinâmico.

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

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

Valores para valores METRIC, DIMENSION e THRESHOLD apropriados podem ser obtidos a partir do az monitor metrics list-definitions comando.

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 --add-condition argumento. Suporte taquigráfico-sintaxe, json-file 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 em 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 ##h##m##s formato.

--force-string

Ao usar 'set' ou 'add', preserve literais de cadeia de caracteres em vez de tentar converter para 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 um ID de recurso completo contendo todas as informações dos argumentos 'Resource Id'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--name -n

Nome da regra de alerta.

--remove

Remova uma propriedade ou um elemento de uma lista. Exemplo: --remove property.list OU --remove propertyToRemove.

--remove-actions

Lista separada por espaço de nomes de grupos de ação a serem removidos. Suporte taquigráfico-sintaxe, json-file e yaml-file. Tente "??" para mostrar mais.

--remove-conditions

Lista separada por espaço de nomes de condição a serem removidos. Suporte taquigráfico-sintaxe, json-file 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 separada por espaço de escopos aos quais a regra se aplica. Os recursos especificados neste parâmetro devem ser do mesmo tipo e existir no mesmo local. Suporte taquigráfico-sintaxe, json-file e yaml-file. Tente "??" para mostrar mais.

--set

Atualize um objeto especificando um caminho de propriedade e um valor a serem definidos. Exemplo: --set property1.property2=.

--severity

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

--subscription

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

--tags

Tags separadas por espaço: key[=value] [key[=value] ...]. Suporte taquigráfico-sintaxe, json-file e yaml-file. Tente "??" para mostrar mais.

--window-size

Tempo para agregar métricas no ##h##m##s formato.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--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 o detalhamento do log. Use --debug para logs de depuração completos.