Đăng ký sự kiện
HƯỚNG DẪN ĐĂNG KÝ SỰ KIỆN TRÊN VPANEL
Trang Event Subscriptions là nơi bạn quyết định sự kiện hệ thống nào sẽ trở thành cảnh báo, và kênh nào sẽ nhận cảnh báo đó. Một subscription là một quy tắc dạng "khi sự kiện này xảy ra, gửi thông báo qua các kênh này". Nếu không có subscription, sự kiện chỉ được ghi vào event log nội bộ — không email, không Telegram.
1. Truy cập Event Subscriptions
Đăng nhập Admin Panel ở cổng :2087. Ở thanh bên trái, mở Notifications và chọn Subscriptions.
Thành phần giao diện
| Thành phần | Mô tả |
|---|---|
| Add Subscription | Mở hộp thoại tạo mới. |
| Bảng subscription | Hiển thị tên sự kiện, các kênh đã chọn, mức nghiêm trọng tối thiểu, trạng thái bật/tắt. |
| Enable / Disable | Tạm ngưng subscription mà không xóa. |
| Edit / Delete | Sửa hoặc xóa subscription. |
2. Nhóm sự kiện có sẵn
| Nhóm | Ví dụ sự kiện |
|---|---|
| Tài khoản | account.created, account.suspended, account.terminated |
| SSL | ssl.issued, ssl.renewal_failed, ssl.expiring_soon (30 / 14 / 7 / 1 ngày) |
| Backup | backup.completed, backup.failed, backup.destination_offline |
| Dịch vụ | service.down, service.recovered, service.restart_required |
| Bảo mật | security.brute_force_detected, security.root_password_changed, security.2fa_enabled |
| Tài nguyên | resource.disk_high, resource.memory_pressure, resource.cpu_saturated |
mail.queue_backlog, mail.bounce_rate_high, mail.relay_auth_failed |
Danh sách đầy đủ được liệt kê ở Notifications → Events Reference trong panel.
3. Tạo subscription
Nhấn Add Subscription. Trong hộp thoại:
- Event — chọn một sự kiện cụ thể hoặc dùng wildcard
ssl.*để bắt cả nhóm. - Minimum Severity —
info,warning,error,critical. Sự kiện dưới mức này sẽ bị quy tắc bỏ qua. - Channels — tích chọn một hoặc nhiều kênh đã tạo ở trang Channels.
- Cooldown — thời gian chặn lặp (phút); tránh sự kiện "nhấp nháy" làm ngập kênh.
- Filter — điều kiện lọc nâng cao, ví dụ chỉ báo khi
account.suspendedthuộc góienterprise. - Nhấn Save.
Subscription có hiệu lực ngay lập tức. Sự kiện phù hợp tiếp theo sẽ được fan-out tới các kênh đã chọn.
4. Cấu hình cơ bản khuyến nghị
Với hệ thống production, tối thiểu nên có các quy tắc sau:
backup.failed→ email admin + Telegram opsssl.renewal_failed→ email adminssl.expiring_soon(14 ngày) → email adminservice.down→ Telegram ops với cooldown 5 phútsecurity.brute_force_detected→ Telegram opsresource.disk_high→ email admin với cooldown 60 phút
Bổ sung các subscription chi tiết hơn khi đã nắm được mức nhiễu bình thường.
5. Test subscription
Một số sự kiện có thể bắn thử để kiểm tra. Mở subscription và nhấn Fire Test Event — vPanel phát ra một sự kiện giả khớp với quy tắc và gửi qua tất cả kênh đã cấu hình. Sự kiện này gắn test=true trong payload nên các automation phía dưới có thể bỏ qua nếu cần.
6. Xử lý sự cố
| Sự cố | Nguyên nhân & Cách khắc phục |
|---|---|
| Sự kiện xảy ra nhưng không có thông báo | Kiểm tra severity — mức thực tế có thể thấp hơn ngưỡng của bạn. Xem thêm ở Notification Logs. |
| Nhận cảnh báo hai lần | Có hai subscription khớp cùng một sự kiện với kênh trùng nhau. Gộp lại. |
| Cooldown có vẻ không tác dụng | Cooldown tính theo cặp (sự kiện, kênh). Hai kênh khác nhau vẫn được bắn mỗi bên một lần. |
| Không lưu được subscription | Chưa chọn kênh nào, hoặc kênh được chọn đang bị tắt. |
Chúc bạn quản trị Server an toàn và hiệu quả!