Trabalhando com políticas de notificação - Amazon Managed Grafana
Trabalhar com notificações

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Trabalhando com políticas de notificação

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

Para espaços de trabalho do Grafana que suportam a versão 10.x do Grafana, consulte. Trabalhando na versão 10 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 políticas de notificação determinam como os alertas são encaminhados para os 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 depois por cada política secundária. Se você habilitar a Continue matching subsequent sibling nodes opção para uma política específica, a avaliação continuará mesmo após uma ou mais correspondências. 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 pela Grafana. As políticas de notificação para alertas do Alertmanager são somente para leitura.

Notificações de agrupamento

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 chamadosalertname=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 para ser group_by: [alertname] (sem usar o env rótulo, que é diferente para cada serviço). Com essa configuração em vigor, 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ão group_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 rótulos, 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 (sino) para abrir a página de Alerta.

  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 as 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 uma das opções a seguir.

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

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

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

  8. Escolha 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 (sino) para abrir a página de Alerta.

  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 mais adiante neste tópico.

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

  7. Opcionalmente, ative Continuar combinando os nós irmãos subsequentes para continuar combinando as políticas irmãos mesmo depois que o alerta corresponder à política atual. Quando essa política está habilitada, 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. Para salvar suas alterações, selecione Salvar política.

Para adicionar uma política aninhada

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

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

  3. Para salvar suas alterações, selecione Salvar política.

Para editar uma política específica

  1. Na página 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, em seguida, 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 marcadores de etiquetas ou pontos de contato.

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

  • Para pesquisar por etiqueta, insira uma correspondência de etiquetas válida no campo Pesquisar por etiqueta. Vários matchers 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 correspondências no 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 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 pelo 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 ao valor do rótulo. Ela pode corresponder como uma string ou como uma expressão regular, dependendo do operador escolhido.