Partilhar via

az monitor metrics alert

  • Referência

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

Comandos

Name Description Tipo Estado
az monitor metrics alert condition

Gerencie as condições da regra de alerta métrico quase em tempo real.

 Principal GA
az monitor metrics alert condition create

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

 Principal Pré-visualizar
az monitor metrics alert create

Crie uma regra de alerta baseada em métricas.

 Principal GA
az monitor metrics alert delete

Exclua uma regra de alerta baseada em métricas.

 Principal GA
az monitor metrics alert dimension

Gerencie dimensões de regras de alerta de métricas quase em tempo real.

 Principal GA
az monitor metrics alert dimension create

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

 Principal Pré-visualizar
az monitor metrics alert list

Listar regras de alerta baseadas em métricas.

 Principal GA
az monitor metrics alert show

Mostrar uma regra de alerta baseada em métricas.

 Principal GA
az monitor metrics alert update

Atualize uma regra de alerta baseada em métricas.

 Principal GA

az monitor metrics alert create

Editar

Crie uma regra de alerta baseada em métricas.

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 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 grande 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étricas 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 dinâmico de 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 > dynamic medium 2 of 4 since 2020-10-01T10:23:00.000Z"
    --description "Dynamic CPU"
    --window-size 5m
    --region westus

Parâmetros Obrigatórios

--condition

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

Uso: --condition {avg,min,max,total,count} [NAMESPACE.] MÉTRICA [{=,!=,,=,><<>,=} LIMIAR] [{,,} dinâmica 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'.

As 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 métricos e calcular os limites dinâmicos (em formato ISO8601).

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

Os valores para METRIC, DIMENSION e valores 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

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

--scopes

Lista separada por espaços dos 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 acionado.

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

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

--auto-mitigate

Resolva automaticamente o alerta.

valores aceites: false, true
--description

Descrição em texto livre da regra.

--disabled

Crie a regra em um estado desabilitado.

valores aceites: false, true
valor predefinido: False
--evaluation-frequency

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

valor predefinido: 1m
--region --target-resource-region

A região do(s) recurso(s) 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) a 4 (detalhado).

valor predefinido: 2
--tags

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

--target-resource-type --type

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

--window-size

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

valor predefinido: 5m
Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. 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

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--name -n

Nome da regra de alerta.

--resource-group -g

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. 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

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

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. 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

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--name -n

Nome da regra de alerta.

--resource-group -g

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az monitor metrics alert update

Editar

Atualize uma regra de alerta baseada em métricas.

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/Ativar uma regra de alerta baseada em métricas.

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 ou JSON string>.

--add-action --add-actions

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

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 --add-action argumento. Suporta sintaxe taquigráfica, 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.] MÉTRICA [{=,!=,,=,><<>,=} LIMIAR] [{,,} dinâmica 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'.

As 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 métricos e calcular os limites dinâmicos (em formato ISO8601).

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

Os valores para METRIC, DIMENSION e valores 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. Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

--auto-mitigate

Resolva automaticamente o alerta.

valores aceites: 0, 1, f, false, n, no, t, true, y, yes
--description

Descrição em texto livre da regra.

--enabled

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

valores aceites: 0, 1, f, false, n, no, t, true, y, yes
--evaluation-frequency

Frequência com que se avalia a regra em ##h##m##s formato.

--force-string

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

valores aceites: 0, 1, f, false, n, no, t, true, y, yes
--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. 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 OR --remove propertyToRemove.

--remove-actions

Lista separada por espaços de nomes de grupos de ações a serem removidos. Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

--remove-conditions

Lista separada por espaço de nomes de condições a serem removidos. Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

--resource-group -g

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

--scopes

Lista separada por espaços dos escopos aos quais a regra se aplica. Os recursos especificados neste parâmetro devem ser do mesmo tipo e existir no mesmo local. Suporta sintaxe taquigráfica, json-file 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=.

--severity

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--tags

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

--window-size

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

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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