Mục lục
Thông báo qua email và chat rất dễ bị bỏ lỡ giữa lúc sự cố xảy ra. Với những cảnh báo nguy cấp, Echobell có thể biến thông báo webhook của Grafana thành cuộc gọi thật, kèm khả năng leo thang và gọi lại. Bài viết này hướng dẫn toàn bộ quá trình thiết lập.
Tài liệu liên quan:
- Echobell là gì → /docs/what-is-echobell
- Các loại thông báo và cơ chế gọi lại → /docs/notification
- Tổng quan về webhook → /docs/webhook
- Tài liệu tích hợp Grafana → /docs/developer/grafana
Điều kiện cần có
- Tài khoản Echobell với một kênh đang hoạt động và webhook URL của kênh đó (xem /docs/webhook)
- Quyền quản trị trên hệ thống Grafana của bạn
- Ít nhất một quy tắc cảnh báo đã được cấu hình
Thiết lập
Bước 1 — Tạo contact point kiểu Webhook trong Grafana
- Vào Alerting → Contact points
- Nhấn New contact point và chọn Webhook
- Đặt tên dễ nhận biết, ví dụ "Echobell Phone Calls"
Bước 2 — Thêm webhook URL của Echobell
Đặt URL thành webhook của kênh:
https://hook.echobell.one/t/<channel-token>
Sao chép URL này trong phần cài đặt kênh của Echobell (chi tiết tại /docs/webhook). Hãy coi đây là thông tin bí mật và thay mới nếu bị lộ.
Bước 3 — Kiểm tra tích hợp
Nhấn Test trong Grafana để gửi một cảnh báo mẫu. Bạn sẽ nhận được cuộc gọi từ Echobell chỉ trong vài giây.
Bước 4 — Gắn vào notification policy
- Vào Alerting → Notification policies
- Tạo mới hoặc chỉnh sửa một policy nhắm tới các cảnh báo nguy cấp của bạn
- Thêm contact point "Echobell Phone Calls"
Từ giờ Grafana sẽ định tuyến các cảnh báo khớp điều kiện tới Echobell.
Thực hành tốt
- Chỉ dành cuộc gọi cho cảnh báo ưu tiên cao; dùng chat hoặc email cho mức nghiêm trọng thấp hơn
- Cấu hình số lần gọi lại và thời gian chờ trong Echobell để hạn chế mệt mỏi vì cảnh báo (/docs/notification)
- Thiết lập leo thang tới đồng đội nếu cuộc gọi đầu tiên không có người nghe
- Dùng khung giờ yên tĩnh để tránh bị đánh thức bởi việc không gấp
- Chia sẻ kênh với nhóm trực on-call và luôn cập nhật danh sách trực
Tùy chọn nâng cao
- Chia sẻ kênh với đồng đội để phủ sóng rộng hơn
- Tùy chỉnh nội dung đọc lên theo từng loại cảnh báo bằng mẫu
- Cấu hình số lần gọi lại và các nhánh leo thang
- Đặt liên hệ dự phòng để tăng độ bền
Tài liệu đầy đủ: /docs/developer/grafana
Xử lý sự cố
- Không nhận được cuộc gọi: kiểm tra notification policy có định tuyến tới contact point Echobell hay không
- Webhook trả về 4xx: xác nhận webhook URL chính xác và kênh vẫn đang hoạt động
- Quá nhiều cuộc gọi: thu hẹp phạm vi của policy hoặc hạ bớt ngưỡng mức độ nghiêm trọng
- Quá ít cuộc gọi: nâng mức độ nghiêm trọng hoặc thêm bộ lọc nhãn để cảnh báo nguy cấp khớp với policy
Liên quan
- Cảnh báo webhook cho hệ thống tùy chỉnh → /blog/get-notified-with-webhook-mcp
- Thông báo khi GitHub Actions thất bại → /blog/github-actions-notifications
- Tài liệu lập trình cho Grafana → /docs/developer/grafana