Alertmanager: Como Transformar um Fluxo de Alertas em Notificações Significativas

Situação familiar: seu sistema de monitoramento gera centenas de alertas, mas mensagens importantes se perdem nesse fluxo? Este é exatamente o problema que o Alertmanager resolve — um componente-chave do ecossistema Prometheus que transforma o caos de notificações em um sistema de alertas estruturado.

O que é o Alertmanager e por que você precisa dele?

Alertmanager é um serviço que processa alertas do Prometheus e de outros sistemas de monitoramento. Em vez de te inundar com centenas de notificações individuais, ele:

• Agrupa alertas relacionados
• Remove duplicatas
• Roteia notificações para as equipes certas
• Controla a frequência das mensagens

Imagine que vários serviços em um cluster caíram. Em vez de 10 e-mails separados, você recebe uma notificação listando todos os problemas — isso economiza tempo e nervos.

Recursos principais

1. Roteamento flexível de notificações

O Alertmanager permite configurar regras de roteamento complexas baseadas em labels de alertas. Por exemplo:

route:
  group_by: ['alertname', 'cluster']
  receiver: 'team-X-mails'
  routes:
  - matchers:
    - service=~"^(foo1|foo2|baz)$"
    receiver: team-X-mails

Isso significa que todos os alertas para os serviços foo1, foo2 e baz serão roteados para a equipe X via e-mail.

2. Suporte a múltiplas integrações

O Alertmanager suporta:

• E-mail
• Slack
• PagerDuty
• OpsGenie
• Webhook (para integrações com sistemas personalizados)

3. Supressão e inibição de alertas

Você pode configurar regras para evitar o "efeito avalanche":

inhibit_rules:
source_matchers:
    - severity="critical"
  target_matchers:
    - severity="warning"
  equal: ['alertname']

Essa regra ocultará alertas de warning se já existir uma notificação crítica para o mesmo alertname.

4. Alta disponibilidade

O Alertmanager suporta modo cluster pronto para uso. Basta especificar a lista de peers na inicialização:

--cluster.peer=alertmanager1:9094 --cluster.peer=alertmanager2:9094

Como funciona nos bastidores?

O Alertmanager é composto por vários componentes:

1. Alert dispatcher — recebe e processa notificações recebidas
2. Grouper — combina alertas relacionados
3. Routing service — determina para onde enviar a notificação
4. Integrations — envia mensagens para sistemas externos

Arquitetura do projeto:

Aplicações práticas

Caso 1: Roteamento de alertas para equipes

Em grandes empresas, diferentes equipes são responsáveis por diferentes serviços. O Alertmanager permite rotear automaticamente:

• Problemas de banco de dados — para DBAs
• Incidentes de servidor web — para DevOps
• Erros de lógica de negócio — para desenvolvedores

Caso 2: Configuração de escalação

Você pode configurar uma cadeia de notificações:

1. Primeiro alerta — para o Slack
2. Se o problema não for resolvido em 15 minutos — e-mail
3. Após uma hora — uma chamada via PagerDuty

Caso 3: Testando templates de notificação

O amtool embutido permite verificar templates de notificação sem realmente enviá-los:

amtool template render --template.text='{{ template "slack.default.markdown.v1" . }}'

Conclusão: Vale a pena usar?

O Alertmanager é indispensável para quem:

• Já usa o Prometheus
• Possui um sistema de monitoramento complexo
• Quer organizar o fluxo de notificações
• Trabalha em uma equipe distribuída

Se você ainda não enfrentou o problema de "spam de alertas", talvez não precise do Alertmanager. Mas quando seu sistema de monitoramento começar a gerar dezenas de notificações por hora — essa ferramenta se tornará um verdadeiro salva-vidas.

Você pode testar o Alertmanager em poucos minutos usando o Docker:

docker run --name alertmanager -d -p 127.0.0.1:9093:9093 quay.io/prometheus/alertmanager

Após a inicialização, a interface estará disponível em http://localhost:9093/