Integrasi Prometheus Alertmanager - Peringatan di Ponsel

Buat Saluran Echobell

1. Buka aplikasi Echobell
2. Buat saluran baru (misalnya, "Prometheus Alerts")
3. Pilih warna agar mudah dikenali

Konfigurasikan Templat Notifikasi

Payload webhook Alertmanager berisi field terstruktur seperti status, commonLabels, commonAnnotations, externalURL, dan array alerts. Anda bisa merujuk field-field ini langsung di templat Echobell.

Templat yang disarankan:

Templat judul:

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

Templat isi:

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

Templat Tautan opsional (Pengaturan Lanjutan):

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

Ini menampilkan tautan langsung ke grafik atau dasbor yang sedang menyala di dalam catatan peringatan Anda. Kalau generatorURL tidak ada, nilainya jatuh ke externalURL.

Metode Integrasi A — Webhook (Disarankan)

1. Di saluran Echobell Anda, salin URL Webhook dari bagian Pemicu
2. Di Alertmanager, tambahkan webhook receiver yang mengirim POST ke URL itu

Contoh alertmanager.yml minimal:

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

Catatan:

• send_resolved: true juga akan memberi tahu saat peringatan pulih (status menjadi resolved)
• Echobell membaca body JSON apa adanya, jadi templat di atas akan dirender dengan benar

Metode Integrasi B — Email (Alternatif)

Kalau Anda lebih suka atau memang harus memakai email, gunakan email receiver Alertmanager dan kirim ke alamat email yang terikat pada saluran tersebut.

1. Di Echobell, salin alamat email saluran dari bagian Pemicu
2. Konfigurasikan email receiver di Alertmanager dan pakai templat sederhana

Contoh potongan konfigurasi:

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>

Di templat Echobell untuk pemicu email, Anda bisa memakai variabel seperti subject, text, dan html yang disediakan Echobell secara otomatis.

Buat Contoh Aturan Peringatan

Berikut contoh aturan sederhana untuk menguji alurnya:

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"

Begitu peringatan ini menyala, Alertmanager akan mengirim peristiwanya ke receiver yang Anda konfigurasikan dan Echobell akan memberi tahu para pelanggan saluran tersebut.