Políticas de notificação

Este guia apresenta como direcionar alertas para diferentes contact points na Elven Observability usando políticas de notificação. Assim, cada alerta pode chegar ao canal responsável pelo time, serviço ou severidade, em vez de enviar todas as notificações ao mesmo destino.

Uma política compara os labels associados ao alerta com as condições configuradas na rota. Por exemplo, alertas com team=plataforma e severity=critical podem ser enviados ao contact point Jira da equipe de plataforma.

Pré-requisitos

Antes de criar uma política, confirme os itens a seguir:

• Você tem permissão para consultar e editar alertas e políticas de notificação no EO.
• O contact point de destino já foi criado e configurado. Para criar um destino, consulte Integrações para notificação de alertas.
• Você sabe quais labels existem nas regras de alerta que devem seguir essa rota. Os nomes e valores precisam coincidir com os configurados nas regras.
• Você conhece o contact point padrão atual e quem recebe alertas que não correspondem a uma política específica.

Exemplo de roteamento

Neste exemplo, alertas críticos da equipe de plataforma são enviados ao Jira. O nome do contact point é ilustrativo; use o destino existente no seu ambiente.

As labels são pares de chave e valor. Configure team e severity na própria regra de alerta; a política não cria labels ausentes.

Criando uma política de notificação

1. No menu do EO, acesse Alerts & IRM → Alerting → Notification configuration e abra a aba Notification policies.
2. Se o ambiente tiver mais de um Alertmanager, selecione o mesmo Alertmanager usado pelo contact point e pelas regras que deseja rotear. Em instalações comuns, o Grafana Alertmanager é o padrão.
3. Localize a política padrão e as políticas existentes. Verifique o contact point padrão e a ordem das rotas antes de adicionar uma nova.
4. Na política padrão, selecione + New child policy. Uma política filha acrescenta uma condição de roteamento sob a política selecionada.
5. Em Matching labels, adicione as condições que precisam coincidir. Para o exemplo, configure team como plataforma e severity como critical.
6. Em Contact point, escolha Jira - Plataforma ou o contact point correspondente ao seu ambiente.
7. Mantenha desativada a opção Continue matching subsequent sibling nodes, a menos que a mesma notificação deva ser enviada também às políticas irmãs que coincidirem.
8. Se não precisar de agrupamento ou tempos diferentes dos herdados da política superior, mantenha as configurações herdadas. Se houver uma necessidade operacional específica, combine os valores com a equipe responsável.
9. Selecione Save policy e confira se a nova rota aparece na árvore de políticas.

As políticas irmãs são avaliadas de cima para baixo. Organize rotas mais específicas antes das rotas amplas e confira se uma política anterior não captura o alerta antes da rota pretendida.

Associando uma regra de alerta às políticas

Uma política só recebe alertas que passam pelo roteamento de políticas e cujas labels correspondem às condições configuradas.

Para criar a regra e definir esses labels, consulte Criar regras de alerta com labels e notificações.

1. Acesse Alerting → Alert rules e abra a regra que deve ser roteada.
2. Na seção de labels da regra, confirme ou adicione as labels usadas pela política. No exemplo, team=plataforma e severity=critical.
3. Na configuração de notificações da regra, escolha o uso de políticas de notificação — em algumas versões da interface, a opção aparece como Use notification policy ou dentro de Advanced options.
4. Evite selecionar diretamente um contact point na regra quando a intenção for aplicar a árvore de políticas. O envio direto para um contact point ignora esse roteamento.
5. Salve a regra. Se a tela disponibilizar Preview routing, use a prévia para confirmar qual política receberá um alerta com aquelas labels.

Se a regra já estiver configurada para enviar diretamente a um contact point, altere o modo de notificação somente após confirmar o comportamento esperado com a equipe responsável pela regra.

Validando o roteamento

Faça a validação primeiro com uma regra de teste ou em um escopo controlado, usando labels que não desviem alertas de produção para um canal não aprovado.

1. Confira se o contact point selecionado existe no mesmo Alertmanager e está configurado corretamente.
2. Verifique se as labels da regra são exatamente as mesmas usadas nas condições da política, incluindo maiúsculas, minúsculas e valores.
3. Use Preview routing, quando disponível, para conferir a rota que corresponde às labels. A prévia mostra o roteamento; ela não comprova a entrega ao sistema de destino.
4. Gere um alerta de teste controlado ou aguarde uma ocorrência aprovada para validação.
5. Consulte o histórico de notificações do EO e confirme o recebimento no sistema de destino.
6. Para um destino Jira, confirme também se a issue apareceu no projeto esperado e se os campos estão corretos. O teste do contact point Jira pode criar uma issue real; combine o projeto de teste antes de executá-lo.

Resolução de problemas

• O alerta segue para o contact point padrão: confira se a regra está usando políticas de notificação e se todas as labels exigidas estão presentes e correspondem à política.
• O alerta não é encaminhado ao destino esperado: confirme o Alertmanager selecionado, o contact point associado à rota e a ordem das políticas irmãs.
• Mais de um destino recebe a notificação: confira se Continue matching subsequent sibling nodes está habilitado em uma rota que corresponde ao alerta.
• A prévia mostra a rota certa, mas não há entrega: consulte o histórico de notificações e verifique o estado e a configuração do contact point.
• A política não aparece na prévia da regra: verifique se a regra e a política pertencem ao mesmo Alertmanager e se a regra está usando o roteamento por políticas.

Glossário de Termos Técnicos

Alerta: notificação gerada quando uma condição monitorada é atendida, indicando um desvio em relação ao comportamento esperado.

Alertmanager: componente responsável por processar alertas e aplicar agrupamento, políticas e notificações.

Contact point: destino de notificação configurado na Elven Observability, como Jira, Telegram ou e-mail.

Label: par de chave e valor associado ao alerta, usado para classificá-lo e aplicar condições de roteamento.

Notification policy (política de notificação): regra de roteamento que compara labels e define o contact point, o agrupamento e os tempos de notificação aplicáveis.

Política padrão: rota usada para alertas que não correspondem a uma política mais específica.

Referências

• Alertas na Elven Observability
• Integrações para notificação de alertas
• Documentação do Grafana: configurar políticas de notificação
• Documentação do Grafana: configurar regras de alerta gerenciadas pelo Grafana