Criar ou editar uma regra de alerta de métrica

Este artigo mostra como criar uma nova regra de alerta de métrica ou editar uma regra de alerta de métrica existente. Para saber mais sobre alertas, confira a visão geral dos alertas.

Você cria uma regra de alerta combinando os recursos a serem monitorados, os dados de monitoramento do recurso e as condições que deseja disparar o alerta. Em seguida, você pode definir grupos de ações e regras de processamento de alerta para determinar o que acontece quando um alerta é disparado.

Os alertas disparados por essas regras de alerta incluem um conteúdo que usa o esquema de alerta comum.

Pré-requisitos

Para criar uma regra de alerta de métrica, você deve ter as seguintes permissões:

  • Permissão de leitura no recurso de destino da regra de alerta.
  • Permissão de gravação no grupo de recursos no qual a regra de alerta é criada. Se você estiver criando a regra de alerta no portal do Azure, a regra de alerta será criada por padrão no mesmo grupo de recursos em que reside o recurso de destino.
  • Permissão de leitura em qualquer grupo de ações associado à regra de alerta, se aplicável.

Criar ou editar uma regra de alerta na home page do portal

Siga estas etapas:

  1. No portal, selecione Monitor>Alertas.

  2. Abra o menu + Criar e selecione Regra de alerta.

    Captura de tela que mostra as etapas usadas para criar uma regra de alerta.

Criar ou editar uma regra de alerta de um recurso específico

Siga estas etapas:

  1. No portal, navegue até o recurso.

  2. Selecione Alertas no painel esquerdo e, em seguida, selecione + Criar>Regra de alerta.

  3. O escopo da regra de alerta é definido como o recurso que você selecionou. Continue com a definição das condições para a regra de alerta.

    Captura de tela que mostra as etapas para criar uma nova regra de alerta a partir de um recurso selecionado.

Editar uma regra de alerta existente

Siga estas etapas:

  1. No portal, na página inicial ou em um recurso específico, selecione Alertas no painel esquerdo.

  2. Selecione Regras de alertas.

  3. Selecione a regra de alerta que você deseja editar e selecione Editar.

    Captura de tela que mostra as etapas para editar uma regra de alerta existente.

  4. Selecione qualquer uma das guias da regra de alerta para editar as configurações.

Configurar o escopo da regra de alerta

Siga estas etapas:

  1. No painel Selecionar um recurso, defina o escopo da regra de alerta. Filtre o conteúdo por assinatura, tipo de recurso ou local do recurso.

  2. Escolha Aplicar.

    Captura de tela que mostra o painel de seleção de recursos para a criação de uma regra de alerta.

Configurar as condições da regra de alerta

Siga estas etapas:

  1. Na guia Condição, quando você selecione o campo Nome do sinal, os sinais mais usados serão exibidos na lista suspensa. Selecione um desses sinais populares ou selecione Ver todos os sinais se quiser escolher um sinal diferente para a condição.

    Captura de tela mostrando os sinais populares ao criar uma regra de alerta.

  2. (Opcional) Se você optou por Ver todos os sinais na etapa anterior, use o painel Selecione um sinal para pesquisar o nome do sinal ou filtrar a lista de sinais. Filtrar por:

    Esta tabela descreve os serviços disponíveis para regras de alerta de métrica:

    Fonte do sinal Descrição
    Plataforma Para sinais de métrica, o serviço Monitor é o namespace de métrica. "Plataforma" significa que as métricas são fornecidas pelo provedor de recursos, ou seja, o Azure.
    Azure.ApplicationInsights Métricas relatadas pelo cliente, enviadas pelo SDK do Application Insights.
    Azure.VM.Windows.GuestMetrics Métricas de convidado da VM, coletadas por uma extensão em execução na VM. Pode incluir contadores de desempenho do sistema operacional internos e contadores de desempenho personalizados.
    <seu namespace personalizado> Um namespace de métrica personalizado, contendo métricas personalizadas enviadas com a API de Métricas do Azure Monitor.

    Selecione o Nome do sinal e Aplicar.

  3. Visualize os resultados do sinal de métrica selecionado na seção Versão prévia. Selecione valores para os campos a seguir.

    Campo Descrição
    Intervalo de horas O intervalo de tempo a ser incluído nos resultados. Pode ser das últimas seis horas à última semana.
    Série temporal A série temporal a ser incluída nos resultados.
  4. Na seção Lógica de alerta:

    Campo Descrição
    Limite Selecione essa opção se o limite precisar ser avaliado com base em um valor estático ou dinâmico.
    Um limite estático avalia a regra usando o valor limite configurado por você.
    Os limites dinâmicos usam algoritmos de machine learning para aprender continuamente os padrões de comportamento de métrica e calcular os limites apropriados para um comportamento inesperado. Você pode saber mais sobre como usar limites dinâmicos para alertas de métrica.
    Operador Selecione o operador usado para comparar o valor de métrica com o limite.
    No caso de limites dinâmicos, as regras de alerta podem usar limites personalizados com base no comportamento da métrica para limites superiores e inferiores na mesma regra. Selecione um destes operadores:
    – Maior que o limite superior ou menor que o limite inferior (padrão)
    – Maior que o limite superior
    – Menor do que o limite inferior
    Tipo de agregação Selecione a função de agregação a ser aplicada nos pontos de dados: Soma, Contagem, Média, Mínimo ou Máximo.
    Valor limite Se você selecionou um limite estático, insira o valor limite para a lógica da condição.
    Unidade Se o sinal de métrica selecionado oferecer suporte a diferentes unidades, como bytes, KB, MB e GB, e se você tiver selecionado um limite estático, insira a unidade para a lógica da condição.
    Sensibilidade do limite Se você tiver selecionado um limite dinâmico, insira o nível de confidencialidade. O nível de confidencialidade afeta a quantidade de desvio do padrão da série de métricas necessário para disparar um alerta.
    - Alto: os limites são rígidos e próximos do padrão da série da métrica. Uma regra de alerta é disparada ao menor desvio, resultando em mais alertas.
    - Médio: os limites são menos rígidos e mais equilibrados. Há menos alertas do que com alta sensibilidade (padrão).
    - Baixo: os limites são flexíveis, permitindo um maior desvio do padrão da série de métricas. Uma regra de alerta só é disparada quando há desvios grandes, resultando em menos alertas.
    Granularidade de agregação Selecione o intervalo usado para agrupar os pontos de dados por meio da função de tipo de agregação. Escolha uma Granularidade de agregação (período) maior do que a Frequência de avaliação para reduzir a probabilidade de perder a primeira avaliação de uma série temporal adicionada.
    Frequência de avaliação Selecione a frequência com que a regra de alerta deve ser executada. Selecione uma frequência menor que a granularidade de agregação a fim de gerar uma janela deslizante para a avaliação.
  5. (Opcional) Você pode configurar a divisão por dimensões.

    As dimensões são pares nome-valor que contêm dados adicionais sobre o valor da métrica. Usando dimensões, você pode filtrar as métricas e monitorar séries temporais específicas, em vez de monitorar a agregação de todos os valores dimensionais.

    Se você selecionar mais de um valor de dimensão, cada série temporal resultante da combinação disparará seu próprio alerta e será cobrada separadamente. Por exemplo, a métrica de transações de uma conta de armazenamento pode ter uma dimensão de nome da API que contenha o nome da API chamada por transação (por exemplo, GetBlob, DeleteBlob e PutPage). Você poderá optar por disparar um alerta quando houver um alto número de transações em uma API específica (os dados agregados). Ou, então, você pode usar dimensões para alertar apenas quando o número de transações for alto para APIs específicas.

    Campo Descrição
    Nome da dimensão As dimensões podem ser colunas de número ou cadeia de caracteres. As dimensões são usadas para monitorar séries temporárias específicas e fornecem contexto para um alerta acionado.
    A divisão na coluna ID de Recurso do Azure transforma o recurso especificado no destino do alerta. Se detectada, a coluna ResourceID é selecionada automaticamente e altera o contexto do alerta disparado para o recurso do registro.
    Operador O operador usado no nome e no valor da dimensão.
    Valores de dimensão Os valores de dimensão se baseiam nos dados de métrica das últimas 48 horas. Selecione Adicionar valor personalizado para adicionar valores de dimensão personalizados.
    Incluir todos os valores futuros Selecione este campo para incluir quaisquer valores futuros adicionados à dimensão selecionada.
  6. (Opcional) Na seção Quando avaliar:

    Campo Descrição
    Verificar a cada Escolha a frequência com que a regra de alerta verificará se a condição foi atendida.
    Período de retrospectiva Selecione o período em que os dados serão verificados a cada vez. Por exemplo, a cada um minuto, analise os últimos cinco.
  7. (Opcional) Na seção Opções avançadas, é possível especificar quantas falhas em um período específico dispiram um alerta. Por exemplo, você poderá especificar que só deseja disparar um alerta se houver três falhas na última hora. A política de negócios do aplicativo deve determinar essa configuração.

    Selecione valores para estes campos:

    Campo Descrição
    Número de violações O número de violações no período configurado que dispara o alerta.
    Período de avaliação O período no qual ocorre o número de violações.
    Ignorar dados antes de Use essa configuração para selecionar a data da qual os dados históricos de métrica começarão a ser usados para calcular os limites dinâmicos. Por exemplo, se um recurso estava em execução no modo de teste e é movido para produção, o ideal é desconsiderar o comportamento da métrica enquanto o recurso está em teste.
  8. Selecione Concluído. Após configurar as condições da regra de alerta, você poderá configurar os detalhes da regra de alerta para concluir a criação do alerta ou, opcionalmente, poderá também adicionar ações e tags à regra de alerta.

Configurar as ações da regra de alerta

(Opcional) Siga essas etapas para adicionar ações à sua regra de alerta:

  1. Selecione a guia Ações.

  2. Selecione ou crie os grupos de ações necessários.

    Captura de tela que mostra a guia Ações quando uma regra de alerta é criada.

Configurar os detalhes da regra de alerta

Siga estas etapas:

  1. Na guia Detalhes, defina os Detalhes do projeto.

    • Selecione a Assinatura.
    • Selecione o Grupo de recursos.
  2. Defina os Detalhes da regra de alerta.

    Captura de tela que mostra a guia Detalhes quando uma regra de alerta é criada.

  3. Selecione o nível de Severidade.

  4. Insira valores para o Nome da regra de alerta e a Descrição da regra de alerta.

  5. (Opcional) Se você estiver criando uma regra de alerta de métrica que monitora uma métrica personalizada com o escopo definido como uma das seguintes regiões e desejar garantir que o processamento de dados da regra de alerta ocorra nessa região, opte por processar a regra de alerta em uma destas regiões:

    • Norte da Europa
    • Europa Ocidental
    • Suécia Central
    • Centro-Oeste da Alemanha
  6. (Opcional) Na seção Opções avançadas, você pode definir várias opções.

    Campo Descrição
    Habilitar na criação Selecione para que a regra de alerta comece a ser executada assim que você terminar de criá-la.
    Resolver alertas automaticamente (versão prévia) Selecione para tornar o alerta com estado. Quando um alerta é do tipo com estado, ele é resolvido quando a condição não é mais atendida.
    Se você não marcar essa caixa de seleção, os alertas de métrica serão sem estado. Alertas sem estado são acionados sempre que a condição é atendida, mesmo que o alerta tenha sido acionado.
    A frequência de notificações de alertas de métrica sem estado difere com base na frequência configurada da regra de alerta:
    Frequência de alerta de menos de cinco minutos: enquanto a condição continua a ser atendida, uma notificação é enviada no intervalo de um a seis minutos.
    Frequência de alerta de mais de cinco minutos: enquanto a condição continua sendo atendida, uma notificação é enviada entre a frequência configurada e dobra o valor da frequência. Por exemplo, para uma regra de alerta com uma frequência de 15 minutos, uma notificação é enviada no intervalo de 15 a 30 minutos.
  7. (Opcional) Na seção Propriedades personalizadas, se essa regra de alerta contiver grupos de ações, você poderá adicionar suas próprias propriedades para incluir no conteúdo da notificação de alerta. Você pode usar essas propriedades nas ações que o grupo de ações chama, como por um webhook, função do Azure ou ação de aplicativo lógico.

    As propriedades personalizadas são especificadas como pares de chave/valor usando textos estáticos, um valor dinâmico extraído do payload do alerta ou uma combinação de ambos.

    O formato para extrair um valor dinâmico do conteúdo de alerta é: ${<path to schema field>}. Por exemplo: ${data.essentials.monitorCondition}.

    Use o formato do esquema de alerta comum para especificar o campo no conteúdo, independentemente dos grupos de ações configurados para a regra de alerta usarem o esquema comum.

    Observação

    • As propriedades personalizadas são adicionadas ao payload do alerta, mas não aparecem no modelo de email ou nos detalhes do alerta no portal do Azure.

    Captura de tela mostrando as propriedades personalizadas para a criação de uma nova regra de alerta.

    Os exemplos a seguir usam valores em Propriedades personalizadas para utilizar dados de um payload que usa o esquema de alerta comum.

    Este exemplo cria uma marca Detalhes Adicionais com dados referentes à hora de início e à hora de término da janela:

    • Nome: Additional Details
    • Valor: Evaluation windowStartTime: ${data.alertContext.condition.windowStartTime}. windowEndTime: ${data.alertContext.condition.windowEndTime}
    • Resultado: AdditionalDetails:Evaluation windowStartTime: 2023-04-04T14:39:24.492Z. windowEndTime: 2023-04-04T14:44:24.492Z

    Esse exemplo adiciona dados referentes ao motivo da resolução ou do disparo do alerta:

    • Nome: Alert ${data.essentials.monitorCondition} reason
    • Valor: ${data.alertContext.condition.allOf[0].metricName} ${data.alertContext.condition.allOf[0].operator} ${data.alertContext.condition.allOf[0].threshold} ${data.essentials.monitorCondition}. The value is ${data.alertContext.condition.allOf[0].metricValue}
    • Resultados potenciais:
      • Alert Resolved reason: Percentage CPU GreaterThan5 Resolved. The value is 3.585
      • Alert Fired reason": "Percentage CPU GreaterThan5 Fired. The value is 10.585
  8. Assim que o escopo, as condições e os detalhes tiverem sido configurados, você poderá selecionar o botão Revisar + criar a qualquer momento.

Configurar marcas de regra de alerta

(Opcional) Siga essas etapas para adicionar tags à sua regra de alerta:

  1. Selecione a guia Marcas.

  2. Defina as marcas necessárias no recurso de regra de alerta.

    Captura de tela que mostra a guia Marcas quando uma regra de alerta é criada.

Examinar e criar a regra de alerta

Siga estas etapas:

  1. Na guia Examinar + criar, a regra é validada e fornece informações sobre quaisquer problemas.

  2. Quando a validação for aprovada e você tiver examinado as configurações, selecione o botão Criar.

    Captura de tela que mostra a guia Revisar e criar quando uma regra de alerta é criada.

Restrições de nomenclatura para regras de alerta de métrica

Considere as seguintes restrições para nomes de regra de alerta de métrica:

  • Depois de criados, os nomes das regras de alerta de métrica não podem ser alterados (renomeados).
  • Os nomes de regra de alerta de métrica devem ser exclusivos em um grupo de recursos.
  • Os nomes de regra de alerta de métrica não podem conter os seguintes caracteres: * # & + : <> ? @ % { } \ /
  • Os nomes de regra de alerta de métrica não podem terminar com um espaço ou um ponto.
  • O nome do grupo de recursos combinado e o nome da regra de alerta não podem exceder 252 caracteres.

Observação

Se o nome da regra de alerta contiver caracteres que não são alfabéticos nem numéricos (por exemplo: espaços, sinais de pontuação ou símbolos), esses caracteres poderão ser codificados por URL quando recuperados por determinados clientes.

Restrições ao usar dimensões em uma regra de alerta de métrica com várias condições

Os alertas de métricas dão suporte a alertas em métricas multidimensionais e à definição de várias condições (até 5 condições por regra de alerta).

Ao usar dimensões em uma regra de alerta que contenha várias condições, considere as seguintes restrições:

  • Só é possível selecionar um valor por dimensão dentro de cada condição.

  • Você não pode usar a opção Selecionar todos os valores atuais e futuros. Selecione o asterisco (*).

  • Quando as métricas configuradas em condições diferentes dão suporte à mesma dimensão, um valor de dimensão configurado precisa ser definido explicitamente da mesma forma para todas essas métricas e nas condições relevantes.

    Por exemplo:

    • Pense em uma regra de alerta de métrica que é definida em uma conta de armazenamento e que monitora duas condições:
      • Total de Transações> 5
      • SuccessE2ELatency média > 250 ms
    • Você quer atualizar a primeira condição e monitorar apenas as transações em que a dimensão ApiName é igual a "GetBlob".
    • Como as métricas de Transações e SuccessE2ELatency dão suporte a uma dimensão ApiName, você precisará atualizar ambas as condições e fazer com que elas especifiquem a dimensão ApiName com um valor "GetBlob".

Considerations when creating an alert rule that contains multiple criteria

  • You can only select one value per dimension within each criterion.
  • You can't use an asterisk (*) as a dimension value.
  • When metrics that are configured in different criteria support the same dimension, a configured dimension value must be explicitly set in the same way for all those metrics. For a Resource Manager template example, see Create a metric alert with a Resource Manager template.