Nhật ký gửi thông báo
HƯỚNG DẪN NHẬT KÝ GỬI THÔNG BÁO TRÊN VPANEL
Trang Notification Logs ghi lại mọi lần vPanel gửi thông báo. Mỗi dòng liên kết một sự kiện với một kênh, ghi rõ đã gửi thành công hay không, payload chính xác và phản hồi từ đích. Đây là audit trail bạn tra cứu khi có người nói "tôi không thấy cảnh báo" hoặc khi điều tra một sự cố mất kết nối gửi.
1. Truy cập Nhật ký gửi thông báo
Đăng nhập Admin Panel ở cổng :2087. Ở thanh bên trái, mở Notifications và chọn Delivery Logs.
Thành phần giao diện
| Thành phần | Mô tả |
|---|---|
| Search | Tìm nhanh theo tên sự kiện và kênh. |
| Bộ lọc Event | Giới hạn theo một sự kiện hoặc nhóm sự kiện cụ thể. |
| Bộ lọc Channel | Giới hạn theo một kênh cụ thể. |
| Bộ lọc Status | Sent, Failed, Retrying. |
| Khoảng thời gian | Mặc định 7 ngày gần nhất. |
| Bảng nhật ký | Thời điểm, Sự kiện, Kênh, Trạng thái, phản hồi HTTP / SMTP, số lần retry. |
| Retry | Thao tác theo dòng, thử gửi lại lần thất bại ngay lập tức. |
2. Đọc một dòng
Nhấp vào dòng bất kỳ để mở khung chi tiết. Khung chi tiết hiển thị:
- Event Payload — JSON của sự kiện tạo ra thông báo, bao gồm ngữ cảnh tenant / tài khoản.
- Rendered Message — nội dung chính xác sẽ được gửi tới kênh.
- Attempt History — mọi lần gửi kèm thời điểm, mã phản hồi và body phản hồi.
- Correlation ID — UUID liên kết lần gửi này với sự kiện gốc xuyên nhiều dịch vụ.
3. Thử gửi lại lần thất bại
- Dòng có trạng thái Failed hiển thị nút Retry. Nhấn để chạy lại với cấu hình kênh hiện tại — hữu ích sau khi vừa sửa URL webhook hoặc token hết hạn.
- Muốn retry hàng loạt, lọc Status = Failed trong khoảng thời gian rồi nhấn Retry All. Retry vẫn tôn trọng giới hạn tốc độ của từng kênh.
- Một số sự kiện (cảnh báo thời gian thực) cố tình không tự retry để tránh gửi thông báo "ôi thiu". Vẫn có thể retry thủ công khi cần.
4. Lưu trữ nhật ký
Mặc định log giữ 30 ngày. Dòng cũ hơn sẽ bị dọn bằng job chạy đêm. Chỉnh thời gian lưu ở Notifications → Settings nếu bạn cần audit dài hơn (lưu càng lâu, database càng lớn).
5. Các tình huống điều tra thường gặp
"On-call không nhận được cảnh báo"
- Lọc theo thời điểm sự cố.
- Tìm dòng sự kiện — nó có được sinh ra không? Nếu không, tình huống gốc không được kích hoạt (xem log của subsystem tạo ra sự kiện).
- Nếu có sự kiện nhưng không có dòng gửi kèm, kiểm tra Event Subscriptions — nhiều khả năng không quy tắc nào khớp.
- Nếu có dòng gửi ở trạng thái Failed, đọc body phản hồi để biết lý do.
"Webhook đang bị spam"
Lọc theo kênh đang ồn ào, sắp xếp theo thời gian. Xem phân bố sự kiện: nếu cùng một sự kiện bắn hàng trăm lần, nghĩa là subsystem gốc đang "nhấp nháy" — xử lý nguyên nhân gốc chứ không phải phần gửi.
6. Xử lý sự cố
| Sự cố | Nguyên nhân & Cách khắc phục |
|---|---|
| Log trống hoàn toàn | Bộ dispatcher sự kiện nội bộ không chạy. Khởi động lại dịch vụ vPanel. |
| Tất cả dòng đều fail với mã 401 | Token của kênh đã bị xoay bên ngoài. Cập nhật lại cấu hình kênh. |
| Retry thành công nhưng phập phù | Endpoint đích đang bị rate-limit. Thêm Cooldown cho subscription. |
| Log tăng quá nhanh | Giảm bớt các subscription dùng wildcard quá rộng, hoặc rút ngắn thời hạn lưu. |
Chúc bạn quản trị Server an toàn và hiệu quả!