การเชื่อมต่อกับ Prometheus Alertmanager - แจ้งเตือนบนมือถือ

สร้างช่องใน Echobell

1. เปิดแอป Echobell
2. สร้างช่องใหม่ (เช่น "Prometheus Alerts")
3. เลือกสีเพื่อให้แยกแยะได้ง่าย

ตั้งค่าเทมเพลตการแจ้งเตือน

payload ของ webhook จาก Alertmanager มีฟิลด์ที่มีโครงสร้าง เช่น status, commonLabels, commonAnnotations, externalURL และอาร์เรย์ alerts คุณอ้างอิงฟิลด์เหล่านี้ได้โดยตรงในเทมเพลตของ Echobell

เทมเพลตที่แนะนำ:

เทมเพลตหัวข้อ:

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

เทมเพลตเนื้อหา:

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

Link Template (ในการตั้งค่าขั้นสูง) ซึ่งจะใส่หรือไม่ก็ได้:

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

ค่านี้จะแสดงลิงก์ตรงไปยังกราฟหรือแดชบอร์ดที่เกี่ยวข้องภายในบันทึกการแจ้งเตือนของคุณ หากไม่มี generatorURL ระบบจะถอยไปใช้ externalURL แทน

วิธีเชื่อมต่อแบบ A — Webhook (แนะนำ)

1. ในช่อง Echobell ของคุณ ให้คัดลอก Webhook URL จากส่วน Triggers
2. ใน Alertmanager ให้เพิ่ม webhook receiver ที่ส่งข้อมูลไปยัง URL นั้น

ตัวอย่าง 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

หมายเหตุ:

• send_resolved: true จะแจ้งเตือนเมื่อเหตุการณ์คลี่คลายด้วย (status เปลี่ยนเป็น resolved)
• Echobell อ่าน JSON body ตามที่ได้รับมาโดยตรง เทมเพลตข้างต้นจึงแสดงผลได้ถูกต้อง

วิธีเชื่อมต่อแบบ B — อีเมล (ทางเลือก)

หากคุณต้องการหรือจำเป็นต้องใช้อีเมล ให้ใช้ email receiver ของ Alertmanager แล้วส่งไปยังที่อยู่อีเมลที่ผูกกับช่อง

1. ใน Echobell ให้คัดลอกที่อยู่อีเมลของช่องจากส่วน Triggers
2. ตั้งค่า email receiver ใน Alertmanager และใช้เทมเพลตแบบง่าย ๆ

ตัวอย่างส่วนของไฟล์ตั้งค่า:

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>

ในเทมเพลตของ Echobell สำหรับทริกเกอร์อีเมล คุณใช้ตัวแปรอย่าง subject, text และ html ที่ Echobell เตรียมให้อัตโนมัติได้

สร้างกฎการแจ้งเตือนตัวอย่าง

นี่คือกฎตัวอย่างสั้น ๆ สำหรับทดสอบการทำงานทั้งหมด:

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"

เมื่อการแจ้งเตือนนี้ทำงาน Alertmanager จะส่งเหตุการณ์ไปยัง receiver ที่คุณตั้งค่าไว้ และ Echobell จะแจ้งเตือนผู้ติดตามของช่องนั้น