Configurar as regras de alerta gerenciado da Grafana

Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana que oferecem suporte à versão 10.x do Grafana.

Para espaços de trabalho do Grafana que suportam a versão 9.x do Grafana, consulte. Trabalhando na versão 9 do Grafana

Para espaços de trabalho do Grafana que suportam a versão 8.x do Grafana, consulte. Trabalhando na versão 8 da Grafana

As regras gerenciadas pelo Grafana são o tipo de regra de alerta mais flexível. Eles permitem que você crie alertas que podem agir com base nos dados de qualquer uma das nossas fontes de dados suportadas. Além de oferecer suporte a várias fontes de dados, você também pode adicionar expressões para transformar seus dados e definir condições de alerta. O uso de imagens em notificações de alerta também é suportado. Esse é o único tipo de regra que permite alertas de várias fontes de dados em uma única definição de regra.

Várias instâncias de alerta podem ser criadas como resultado de uma regra de alerta (também conhecida como alerta multidimensional).

As regras de alerta gerenciadas do Grafana só podem ser editadas ou excluídas por usuários com permissões de edição para a pasta que armazena as regras.

Se você excluir um recurso de alerta criado na interface do usuário, não poderá mais recuperá-lo. Para fazer um backup de sua configuração e poder restaurar recursos de alerta excluídos, crie seus recursos de alerta usando o Terraform ou a API de alertas.

Nos procedimentos a seguir, analisaremos o processo de criação de suas regras de alerta gerenciadas pelo Grafana.

Para criar uma regra de alerta gerenciada pelo Grafana, use o fluxo de criação de alertas no espaço de trabalho e siga estas etapas para ajudá-lo.

Definir nome da regra de alerta

1. Escolha Alertas e IRM -> Regras de alerta -> + Nova regra de alerta.

2. Insira um nome para identificar sua regra de alerta.

   Esse nome é exibido na lista de regras de alerta. Também é o alertname rótulo de cada instância de alerta criada a partir dessa regra.

Em seguida, defina uma consulta para obter os dados que você deseja medir e uma condição que precisa ser atendida antes que uma regra de alerta seja acionada.

Para definir a consulta e a condição

1. Selecione uma fonte de dados.

2. No menu suspenso Opções, especifique um intervalo de tempo.

   nota

   O Grafana Alerting suporta apenas intervalos de tempo relativos fixos, por exemplo,. now-24hr: now

   Ele não suporta intervalos de tempo absolutos: 2021-12-02 00:00:00 to 2021-12-05 23:59:592 ou intervalos de tempo semi-relativos:now/d to: now.

3. Adicione uma consulta.

   Para adicionar várias consultas, escolha Adicionar consulta.

   Todas as regras de alerta são gerenciadas pela Grafana por padrão. Se você quiser mudar para uma regra de alerta gerenciada pela fonte de dados, clique em Alternar para a regra de alerta gerenciada pela fonte de dados.

4. Adicione uma ou mais expressões.

   1. Para cada expressão, selecione a condição Clássica para criar uma única regra de alerta ou escolha entre as opções Matemática, Redução e Reamostragem para gerar um alerta separado para cada série.

      nota

      Ao usar o Prometheus, você pode usar um vetor instantâneo e funções integradas, para não precisar adicionar expressões adicionais.

   2. Escolha Visualizar para verificar se a expressão foi bem-sucedida.

5. [Opcional] Para adicionar um limite de recuperação, ative o botão Limite de recuperação personalizado e preencha um valor para quando sua regra de alerta deve parar de ser acionada.

   Você só pode adicionar um limite de recuperação em uma consulta e essa deve ser a condição de alerta.

6. Escolha Definir como condição de alerta na consulta ou expressão que você deseja definir como condição de alerta.

Use a avaliação da regra de alerta para determinar com que frequência uma regra de alerta deve ser avaliada e com que rapidez ela deve mudar seu estado.

Para fazer isso, você precisa garantir que sua regra de alerta esteja no grupo de avaliação correto e definir um período pendente que funcione melhor para seu caso de uso.

Para definir o comportamento de avaliação de alertas

1. Selecione uma pasta ou escolha + Nova pasta.

2. Selecione um grupo de avaliação ou clique em + Novo grupo de avaliação.

   Se você estiver criando um novo grupo de avaliação, especifique o intervalo para o grupo.

   Todas as regras do mesmo grupo são avaliadas simultaneamente no mesmo intervalo de tempo.

3. Insira um período pendente.

   O período pendente é o período em que uma regra de alerta pode violar a condição até ser acionada.

   Quando uma condição é atendida, o alerta entra no estado Pendente. Se a condição permanecer ativa pelo período especificado, o alerta passará para o estado de disparo, caso contrário, ele será revertido para o estado Normal.

4. Ative as notificações de alerta de pausa, se necessário.

   nota

   Pause a avaliação da regra de alerta para evitar alertas ruidosos enquanto ajusta seus alertas. A pausa interrompe a avaliação da regra de alerta e não cria nenhuma instância de alerta. Isso é diferente dos horários de silenciamento, que impedem a entrega de notificações, mas ainda permitem a avaliação das regras de alerta e a criação de instâncias de alerta.

   Você pode pausar a avaliação da regra de alerta para evitar alertas ruidosos enquanto ajusta seus alertas. A pausa interrompe a avaliação da regra de alerta e não cria nenhuma instância de alerta. Isso é diferente dos horários de silenciamento, que impedem a entrega de notificações, mas ainda permitem a avaliação das regras de alerta e a criação de instâncias de alerta.

5. Em Configurar sem dados e tratamento de erros, configure o comportamento de alerta na ausência de dados.

   Use as diretrizes mais adiante nesta seção.

Adicione rótulos às suas regras de alerta para definir qual política de notificação deve lidar com suas instâncias de alerta de disparo.

Todas as regras e instâncias de alerta, independentemente de seus rótulos, correspondem à política de notificação padrão. Se não houver políticas aninhadas ou nenhuma política aninhada corresponder aos rótulos na regra de alerta ou na instância de alerta, a política de notificação padrão será a política correspondente.

Como configurar notificações

1. Adicione marcadores se quiser alterar a forma como suas notificações são roteadas.

   Adicione rótulos personalizados selecionando pares de valores-chave existentes no menu suspenso ou adicione novos rótulos inserindo a nova chave ou valor.

2. Visualize a configuração do roteamento da sua instância de alerta.

   Com base nos rótulos adicionados, as instâncias de alerta são roteadas para as políticas de notificação exibidas.

   Expanda cada política de notificação para ver mais detalhes.

3. Escolha Ver detalhes para ver os detalhes do roteamento de alertas e uma prévia.

Adicione anotações para fornecer mais contexto sobre o alerta em sua mensagem de notificação de alerta.

As anotações adicionam metadados para fornecer mais informações sobre o alerta em sua mensagem de notificação de alerta. Por exemplo, adicione uma anotação de resumo para informar qual valor causou o disparo do alerta ou em qual servidor ele aconteceu.

Para adicionar anotações

1. [Opcional] Adicione um resumo.

   Breve resumo do que aconteceu e por quê.

2. [Opcional] Adicione uma descrição.

   Descrição do que a regra de alerta faz.

3. [Opcional] Adicione um URL do Runbook.

   Página da web onde você guarda seu caderno de notas para o alerta

4. [Opcional] Adicionar uma anotação personalizada

5. [Opcional] Adicione um link para painel e painel.

   Vincula alertas a painéis em um painel.

6. Selecione a apção Salvar regra.

Regra única e multidimensional

Para alertas gerenciados pela Grafana, você pode criar uma regra com uma condição clássica ou criar uma regra multidimensional.

• Regra com condição clássica

  Use a expressão de condição clássica para criar uma regra que aciona um único alerta quando sua condição for atendida. Para uma consulta que retorna várias séries, o Grafana não rastreia o estado de alerta de cada série. Como resultado, o Grafana envia apenas um único alerta, mesmo quando as condições de alerta são atendidas para várias séries.

• Regra multidimensional

  Para gerar um alerta separado para cada série, crie uma regra multidimensional. Use Resample expressões MathReduce, ou para criar uma regra multidimensional. Por exemplo: .

  • Adicione uma Reduce expressão para cada consulta para agregar valores no intervalo de tempo selecionado em um único valor (não é necessário para regras que usam dados numéricos).

  • Adicione uma Math expressão com a condição para a regra. Não é necessário caso uma consulta ou expressão de redução já retorne 0 se a regra não for acionada, ou um número positivo se ela for acionada. Alguns exemplos: $B > 70 se ele deve ser acionado caso o valor da consulta/expressão B seja maior que 70. $B < $C * 100caso deva disparar se o valor de B for menor que o valor de C multiplicado por 100. Se as consultas que estão sendo comparadas tiverem várias séries em seus resultados, as séries de consultas diferentes serão correspondidas se tiverem os mesmos rótulos ou se uma for um subconjunto da outra.

nota

Grafana não oferece suporte a consultas de alerta com variáveis de modelo. Mais informações estão disponíveis em https://community.grafana.com/t/ template-variables-are-not - supported-in-alert-queries - while-setting-up-alert /2514.

Não configure dados e tratamento de erros

Configure o comportamento do alerta quando a avaliação da regra de alerta não retornar nenhum dado ou um erro.

nota

As regras de alerta configuradas para serem acionadas quando uma avaliação não retorna dados ou o erro só são acionadas quando toda a duração do período de avaliação termina. Isso significa que, em vez de ser acionada imediatamente quando a condição da regra de alerta é violada, a regra de alerta espera até que a hora definida como campo Para termine e, em seguida, é acionada, reduzindo o ruído do alerta e permitindo problemas temporários de disponibilidade de dados.

Se a avaliação da regra de alerta não retornar dados, você poderá definir o estado da regra de alerta para que apareça da seguinte forma:

Sem dados	Descrição
Sem dados	Cria um novo alerta DatasourceNoData com o nome e o UID da regra de alerta e o UID da fonte de dados que não retornou dados como rótulos.
Geração de alertas	Define o estado da regra de alerta comoAlerting. A regra de alerta espera até que a hora definida no campo Para termine antes de disparar.
Ok	Define o estado da regra de alerta comoNormal.

Se sua avaliação retornar um erro, você poderá definir o estado em sua regra de alerta para que apareça da seguinte forma:

Erro	Descrição
Erro	Cria uma instância de alerta DatasourceError com o nome e o UID da regra de alerta e o UID da fonte de dados que não retornou dados como rótulos.
Geração de alertas	Define o estado da regra de alerta comoAlerting. A regra de alerta espera até que a hora definida no campo Para termine antes de disparar.
Ok	Define o estado da regra de alerta comoNormal.

Resolva instâncias de alerta obsoletas

Uma instância de alerta é considerada obsoleta se sua dimensão ou série tiver desaparecido completamente dos resultados da consulta em dois intervalos de avaliação.

Instâncias de alerta obsoletas que estão nos Error estadosAlerting/NoData/são automaticamente marcadas como Resolved e a grafana_state_reason anotação é adicionada à instância de alerta com o motivo. MissingSeries

Crie alertas a partir de painéis

Crie alertas de qualquer tipo de painel. Isso significa que você pode reutilizar as consultas no painel e criar alertas com base nelas.

1. Navegue até um painel na seção Painéis.

2. No canto superior direito do painel, escolha os três pontos (elipses).

3. No menu suspenso, selecione Mais... e escolha Nova regra de alerta.

Isso abrirá o formulário da regra de alerta, permitindo que você configure e crie seu alerta com base na consulta do painel atual.