Integrazione Prometheus Alertmanager - avvisi mobili

Crea un canale Echobell

1. Apri l'app Echobell
2. Crea un nuovo canale (ad esempio "Prometheus Alerts")
3. Scegli un colore per riconoscerlo a colpo d'occhio

Configura i modelli di notifica

Il payload webhook di Alertmanager contiene campi strutturati come status, commonLabels, commonAnnotations, externalURL e un array alerts. Puoi richiamare questi campi direttamente nei modelli di Echobell.

Modelli consigliati:

Modello del titolo:

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

Modello del corpo:

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

Modello di link opzionale (Impostazioni avanzate):

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

In questo modo, dentro il record dell'avviso trovi un link diretto al grafico o alla dashboard che ha fatto scattare la regola. Se generatorURL non è presente, viene usato externalURL come ripiego.

Metodo di integrazione A — Webhook (consigliato)

1. Nel tuo canale Echobell, copia l'URL del webhook dalla sezione Triggers
2. In Alertmanager, aggiungi un receiver webhook che invii i dati a quell'URL

Esempio minimo di 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

Note:

• con send_resolved: true ricevi una notifica anche quando gli avvisi rientrano (lo status diventa resolved)
• Echobell legge il corpo JSON così com'è, quindi i modelli qui sopra vengono resi correttamente

Metodo di integrazione B — Email (alternativa)

Se preferisci o devi usare l'email, ricorri al receiver email di Alertmanager e invia i messaggi all'indirizzo email associato al canale.

1. In Echobell, copia l'indirizzo email del canale dalla sezione Triggers
2. Configura un receiver email in Alertmanager usando modelli semplici

Esempio:

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>

Nei modelli Echobell per i trigger via email puoi usare variabili come subject, text e html, che Echobell mette a disposizione automaticamente.

Crea una regola di avviso di esempio

Ecco una piccola regola di esempio per provare il flusso:

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"

Quando questo avviso scatta, Alertmanager invia l'evento al receiver configurato ed Echobell avvisa chi è iscritto al canale.