Testador de rotas do Alertmanager — veja qual receiver corresponde antes de o alerta acionar alguém.

Cole a sua árvore de rotas (ou um alertmanager.yml completo — apenas o bloco route dele é lido) e as labels de um alerta de exemplo neste testador de rotas do Alertmanager online. Ele reproduz o percurso de roteamento do Alertmanager dentro do navegador e mostra qual receiver, ou quais receivers, o alerta alcançaria, o caminho exato da rota desde a raiz até o nó correspondente, se um continue: true fez disparar mais de um receiver, e o group_by efetivo após a herança. É uma simulação do despacho, sem enviar uma única notificação, então você descobre qual receiver corresponde ao alerta no Alertmanager antes de ele acionar alguém.

O amtool config routes test resolve a árvore de rotas do seu alertmanager.yml contra um conjunto de matchers de label e imprime os receivers que um alerta atingiria, espelhando como o Alertmanager em execução despacha. Esta página é um amtool routes test online no navegador: faz o mesmo percurso na árvore de rotas no lado do cliente, então você consegue testar o roteamento do Alertmanager sem instalar o amtool nem apontá-lo para uma config ao vivo. Cole a árvore, cole as labels e leia os receivers correspondentes e o caminho.

Quase sempre é ordem de rotas, uma regex não ancorada ou um continue faltando. Dentro de uma rota correspondente, as irmãs são avaliadas de cima para baixo e só a primeira correspondência é tomada — então uma regra ampla colocada acima de uma específica a esconde silenciosamente. Os padrões match_re e =~ são totalmente ancorados, então env=~"staging" nunca combina com staging-eu. Use este recurso para depurar rotas do Alertmanager: percorra a árvore contra as labels exatas e veja qual nó de fato combinou, o que deixa óbvia a resposta para "por que meu alerta está indo para o receiver errado".

Por padrão, assim que um alerta combina com uma rota em uma lista de irmãs, o Alertmanager para de varrer o restante daquela lista. Definir continue: true em uma rota correspondente diz ao Alertmanager para continuar avaliando também as irmãs seguintes, para que o alerta possa cair em mais de um receiver — a forma usual de as equipes espelharem todo alerta crítico para um receiver de auditoria ou de paging enquanto ainda o roteiam para a equipe dona. Ao testar o roteamento do Alertmanager aqui, a ferramenta marca cada receiver que um continue: true produz, para que você veja exatamente quais correspondências vieram do encadeamento.

Sim — mas só quando continue: true está definido em uma rota correspondente. Sem ele, a primeira irmã correspondente vence e a varredura para, então um alerta alcança exatamente um receiver por lista de rotas. Com continue: true, o alerta continua descendo pelas irmãs seguintes e pode se ramificar para vários receivers. Este testador mostra cada receiver na ordem em que dispara, para que você confirme que o fan-out é o que pretendia e veja claramente qual receiver corresponde ao alerta no Alertmanager.

Você não precisa de um Alertmanager em execução, e não precisa do amtool. Este é um testador de rotas do Alertmanager online, grátis e sem instalação: tudo roda 100% no lado do cliente, dentro da aba do seu navegador. Cole a sua árvore de rotas e as labels do alerta para testar a sua config de roteamento e simular o roteamento de alertas do Alertmanager no navegador. Nada é enviado e não há cadastro, então você pode colar com segurança nomes de receivers internos e labels de equipes privadas.

O editor da árvore de rotas do Prometheus visualiza a árvore, mas ainda deixa você raciocinar de cabeça sobre match vs. match_re vs. matchers, a ordenação de first-match e a herança — então ele pode parecer certo enquanto um alerta roteia para outro lugar. Se o editor da árvore de rotas não está combinando com as rotas que você espera, use isto como alternativa: testar os matchers do Alertmanager contra labels online. O testador percorre a semântica real e destaca o caminho correspondente, em vez de apenas desenhar a árvore de rotas do Alertmanager online.

Todo alerta entra pela rota raiz, que é o catch-all. Dentro de uma rota correspondente, as rotas filhas são avaliadas de cima para baixo, e o alerta desce para a primeira filha cujos matchers sejam todos satisfeitos — por exemplo, o primeiro nó que exige uma label severity="critical". Ele continua descendo por aquela subárvore; se uma rota correspondente não tiver nenhuma filha que combine, essa rota é o match terminal e o receiver dela dispara. A regra que as pessoas erram é ordem somada a first-match: apenas a primeira irmã correspondente é tomada, a menos que continue: true esteja definido.