Trabalhar com políticas de notificação

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

Para espaços de trabalho do Grafana compatíveis com a versão 8.x do Grafana, consulteTrabalhando na versão 8 do Grafana.

As políticas de notificação determinam como os alertas são encaminhados aos pontos de contato. As políticas têm uma estrutura em árvore, na qual cada política pode ter uma ou mais políticas secundárias. Cada política, exceto a política raiz, também pode corresponder a rótulos de alerta específicos. Cada alerta é avaliado pela política raiz e, em seguida, pela política secundária. Se você habilitar aContinue matching subsequent sibling nodes opção para uma política específica, a avaliação continuará mesmo após uma ou mais partidas. As configurações de uma política principal e as informações do ponto de contato controlam o comportamento de um alerta que não corresponde a nenhuma das políticas secundárias. Uma política raiz controla qualquer alerta que não corresponda a uma política específica.

nota

Você pode criar e editar políticas de notificação para alertas gerenciados pelo Grafana. As políticas de notificação para alertas do Alertmanager são somente para leitura.

Agrupando notificações

O agrupamento categoriza as notificações de alerta de natureza semelhante em um único funil. Isso permite que você controle as notificações de alerta durante interrupções maiores, quando muitas partes de um sistema falham ao mesmo tempo, fazendo com que um grande número de alertas seja iniciado simultaneamente.

Exemplo de agrupamento

Suponha que você tenha 100 serviços conectados a um banco de dados em ambientes diferentes. Esses serviços são diferenciados pelo rótuloenv=environmentname. Existe uma regra de alerta para monitorar se seus serviços podem acessar o banco de dados. A regra de alerta cria alertas nomeadosalertname=DatabaseUnreachable.

Se ocorrer uma partição de rede, em que metade dos seus serviços não consiga mais acessar o banco de dados, 50 alertas diferentes serão iniciados. Para essa situação, você deseja receber uma notificação de uma única página (em vez de 50) com uma lista dos ambientes afetados.

Você pode configurar o agrupamento como sendogroup_by: [alertname] (sem usar oenv rótulo, que é diferente para cada serviço). Com essa configuração implementada, o Grafana envia uma única notificação compacta que contém todos os ambientes afetados por essa regra de alerta.

Grupos especiais

Grafana tem dois grupos especiais. O grupo padrãogroup_by: null agrupa todos os alertas em um único grupo. Você também pode usar um rótulo especial chamado... para agrupar alertas por todos os marcadores, desativando efetivamente o agrupamento e enviando cada alerta para seu próprio grupo.

Trabalhar com notificações

Os procedimentos a seguir mostram como criar e gerenciar políticas de notificação.

Para editar a política de notificação raiz

1. No console do Grafana, no menu Grafana, escolha o ícone de alerta (campainha) para abrir a página de alertas.

2. Escolha Políticas de notificação.

3. No menu suspenso Alertmanager, selecione o Alertmanager que você deseja editar.

4. Na seção Política raiz, escolha o ícone Editar (caneta).

5. Em Ponto de contato padrão, atualize o ponto de contato para o qual as notificações devem ser enviadas para regras quando as regras de alerta não corresponderem a nenhuma política específica.

6. Em Agrupar por, escolha os rótulos (ou grupos especiais) pelos quais agrupar os alertas.

7. Em Opções de temporização, selecione entre as opções a seguir.

   • Espera em grupo — Tempo de espera para armazenar os alertas do mesmo grupo antes de enviar uma notificação inicial. O padrão é 30 segundos.

   • Intervalo de grupo — Intervalo de tempo mínimo entre duas notificações para um grupo. O padrão é 5 minutos.

   • Intervalo de repetição — Intervalo mínimo antes de reenviar uma notificação, caso nenhum novo alerta tenha sido adicionado ao grupo. O padrão é 4 horas.

8. Escolha Save (Salvar) para salvar as alterações.

Para adicionar uma nova política específica de alto nível

1. No console do Grafana, no menu Grafana, escolha o ícone de alerta (campainha) para abrir a página de alertas.

2. Escolha Políticas de notificação.

3. No menu suspenso Alertmanager, selecione o Alertmanager que você deseja editar.

4. Na seção Roteamento específico, escolha Nova política específica.

5. Na seção Rótulos correspondentes, adicione um ou mais rótulos de alerta correspondentes. Mais informações sobre a correspondência de etiquetas estão disponíveis adiante neste tópico.

6. Em Ponto de contato, adicione o ponto de contato para o qual enviar notificações se o alerta corresponder a essa política específica. As políticas aninhadas substituem esse ponto de contato.

7. Opcionalmente, habilite Continuar combinando os nós irmãos subsequentes para continuar combinando as políticas de irmãos mesmo depois que o alerta corresponder à política atual. Quando essa política está ativada, você pode receber mais de uma notificação para o mesmo alerta.

8. Opcionalmente, selecione Substituir agrupamento para especificar um agrupamento diferente da política raiz.

9. Opcionalmente, selecione Substituir horários gerais para substituir as opções de tempo na política de notificação de grupo.

10. Escolha Salvar política para salvar as alterações.

Para adicionar uma política aninhada

1. Expanda a política específica sob a qual você deseja criar uma política aninhada.

2. Escolha Adicionar política aninhada e adicione os detalhes (como ao adicionar uma política específica de nível superior).

3. Escolha Salvar política para salvar as alterações.

Para editar uma política específica

1. Na página de alertas, escolha Políticas de notificação para abrir a página que lista as políticas existentes.

2. Selecione a política que você deseja editar e escolha o ícone Editar (caneta).

3. Faça qualquer alteração (como ao adicionar uma política específica de nível superior).

4. Escolha Salvar política.

Pesquisando políticas

Você pode pesquisar na árvore de políticas por combinadores de etiquetas ou pontos de contato.

• Para pesquisar por ponto de contato, insira o nome parcial ou completo de um ponto de contato no campo Pesquisar por ponto de contato.

• Para pesquisar por rótulo, insira um correspondente de rótulos válido no campo Pesquisar por rótulo. Vários combinadores podem ser inseridos, separados por uma vírgula. Por exemplo, uma entrada de correspondência válida pode serseverity=high, region=~EMEA|NA.

  nota

  Ao pesquisar por rótulo, todas as políticas correspondentes serão exatamente iguais. Não há suporte para correspondências parciais e de estilo regex.

Como funciona a correspondência de etiquetas

Uma política corresponde a um alerta se os rótulos do alerta corresponderem a todos os rótulos correspondentes especificados na política.

• Rótulo — O nome do rótulo a ser correspondente. Ele deve corresponder exatamente ao nome do rótulo do alerta.

• Operador — O operador usado para comparar o valor do rótulo com o valor do rótulo correspondente. Os operadores disponíveis são:

  • =Selecione rótulos cujo valor corresponda exatamente à string fornecida.

  • !=Selecione rótulos cujo valor não corresponda à string fornecida.

  • =~Selecione rótulos cujo valor corresponda ao valor interpretado por regex da string fornecida (a string fornecida é interpretada como uma expressão regular.

  • !=Selecione rótulos que não correspondam à expressão regular fornecida.

• Valor — O valor ao qual corresponder o valor do rótulo. Ele pode corresponder como uma string ou como uma expressão regular, dependendo do operador escolhido.