Integração com Prometheus Alertmanager - Alertas no celular

Criar um canal do Echobell

1. Abra o app do Echobell
2. Crie um novo canal (por exemplo, "Prometheus Alerts")
3. Escolha uma cor para identificá-lo com facilidade

Configurar os modelos de notificação

O payload de webhook do Alertmanager contém campos estruturados como status, commonLabels, commonAnnotations, externalURL e um array alerts. Você pode referenciar esses campos diretamente nos modelos do Echobell.

Modelos sugeridos:

Modelo de título:

{{commonLabels.alertname}} - {{status}}

Modelo de corpo:

🔔 Alert: {{commonLabels.alertname}}
📊 Severity: {{commonLabels.severity}}
🖥️ Instance: {{alerts[0].labels["instance"]}}
⏰ Starts: {{alerts[0].startsAt}}
ℹ️ Summary: {{commonAnnotations.summary}}
🧾 Description: {{commonAnnotations.description}}

Modelo de link opcional (Configurações avançadas):

{{alerts[0].generatorURL || externalURL}}

Isso exibe um link direto para o gráfico ou o dashboard que disparou o alerta dentro do registro do alerta. Se generatorURL não estiver presente, ele usa externalURL como alternativa.

Método de integração A — Webhook (recomendado)

1. No seu canal do Echobell, copie a URL do webhook na seção Gatilhos
2. No Alertmanager, adicione um receiver de webhook que envie os dados para essa URL

Exemplo mínimo de alertmanager.yml:

route:
  receiver: echobell-webhook

receivers:
  - name: echobell-webhook
    webhook_configs:
      - url: "https://hook.echobell.one/t/<channel-token>"
        send_resolved: true
        http_config:
          follow_redirects: true

Observações:

• send_resolved: true também notifica quando os alertas são resolvidos (o status passa a ser resolved)
• O Echobell lê o corpo JSON como ele é, então os modelos acima serão renderizados corretamente

Método de integração B — E-mail (alternativa)

Se você preferir ou precisar usar e-mail, utilize o receiver de e-mail do Alertmanager e envie as mensagens para o endereço de e-mail vinculado ao canal.

1. No Echobell, copie o endereço de e-mail do canal na seção Gatilhos
2. Configure um receiver de e-mail no Alertmanager e use modelos simples

Exemplo de trecho:

receivers:
  - name: echobell-email
    email_configs:
      - to: "PASTE_CHANNEL_EMAIL_ADDRESS"
        send_resolved: true
        subject: "{{ .CommonLabels.alertname }} - {{ .Status }}"
        html: |
          <p><strong>Summary:</strong> {{ .CommonAnnotations.summary }}</p>
          <p>{{ .CommonAnnotations.description }}</p>
          <p>
            <a href='{{ (index .Alerts 0).GeneratorURL }}' target='_blank' rel='noopener'>Open in Prometheus</a>
          </p>

Nos modelos do Echobell para gatilhos por e-mail, você pode usar variáveis como subject, text e html, que o Echobell fornece automaticamente.

Criar uma regra de alerta de exemplo

Veja uma pequena regra de exemplo para testar o fluxo:

groups:
  - name: example
    rules:
      - alert: HighCPU
        expr: avg(rate(process_cpu_seconds_total[5m])) > 0.8
        for: 2m
        labels:
          severity: critical
        annotations:
          summary: "High CPU usage"
          description: "CPU has been over 80% for 2 minutes"

Assim que esse alerta disparar, o Alertmanager enviará o evento para o receiver configurado e o Echobell notificará os inscritos no canal.