Tích hợp Prometheus Alertmanager - Cảnh báo trên di động

Tạo một kênh Echobell

1. Mở ứng dụng Echobell
2. Tạo một kênh mới (ví dụ: "Prometheus Alerts")
3. Chọn một màu để dễ nhận biết

Cấu hình mẫu thông báo

Payload webhook của Alertmanager chứa các trường có cấu trúc như status, commonLabels, commonAnnotations, externalURL và một mảng alerts. Bạn có thể tham chiếu trực tiếp những trường này trong mẫu của Echobell.

Mẫu gợi ý:

Mẫu tiêu đề:

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

Mẫu nội dung:

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

Mẫu liên kết tùy chọn (Cài đặt nâng cao):

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

Cách này hiển thị một liên kết trực tiếp tới biểu đồ hoặc dashboard đang cảnh báo ngay trong bản ghi cảnh báo của bạn. Nếu không có generatorURL, hệ thống sẽ dùng externalURL thay thế.

Cách tích hợp A — Webhook (khuyên dùng)

1. Trong kênh Echobell, sao chép Webhook URL ở phần Triggers
2. Trong Alertmanager, thêm một webhook receiver gửi POST tới URL đó

Ví dụ alertmanager.yml tối giản:

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

Ghi chú:

• send_resolved: true cũng sẽ thông báo khi cảnh báo được xử lý xong (status chuyển thành resolved)
• Echobell đọc nguyên body JSON, nên các mẫu ở trên sẽ hiển thị đúng

Cách tích hợp B — Email (thay thế)

Nếu bạn thích hoặc buộc phải dùng email, hãy dùng email receiver của Alertmanager và gửi tới địa chỉ email gắn với kênh.

1. Trong Echobell, sao chép địa chỉ email của kênh ở mục Triggers
2. Cấu hình một email receiver trong Alertmanager và dùng các mẫu đơn giản

Đoạn cấu hình ví dụ:

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>

Trong mẫu Echobell dành cho kích hoạt qua email, bạn có thể dùng các biến như subject, text và html mà Echobell tự động cung cấp.

Tạo một quy tắc cảnh báo ví dụ

Đây là một quy tắc nhỏ để thử luồng hoạt động:

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"

Khi cảnh báo này kích hoạt, Alertmanager sẽ gửi sự kiện tới receiver bạn đã cấu hình và Echobell sẽ thông báo cho những người đăng ký kênh.