GIÁM SÁT & CẢNH BÁO
Tích hợp đã được xác nhậnGrafana Alerting
Thông báo SMS.
Tích hợp FoxBox đã được xác nhận. Làm theo hướng dẫn cho ứng dụng và cấu hình quyền truy cập, người nhận cùng định tuyến SMS.
CÁCH KẾT NỐI
01 / TRƯỜNG HỢP SỬ DỤNG
Một thông báo hữu ích,
từ một sự kiện hiện có.
Một cảnh báo Grafana được kích hoạt. Một điểm liên hệ webhook gửi nhóm cảnh báo đến một cầu nối bên ngoài, nơi các tin nhắn được giới hạn và chuẩn hóa.
Việc tích hợp thêm một đường dẫn thông báo SMS riêng biệt. Nó không thiết lập tính khả dụng của dịch vụ hoặc thay thế quy trình phản hồi và leo thang sự cố hiện có của bạn.
02 / YÊU CẦU
Trước khi bạn bắt đầu.
- Webhook Grafana Alerting; Phiên bản mục tiêu để xác thực
- Một máy chủ riêng biệt cho cầu nối tích hợp. Không có gì được cài đặt trên phần mềm FoxBox.
- Python 3 cho cầu nối và môi trường biệt lập cho lần thử nghiệm đầu tiên.
- Giao diện HTTP của FoxBox tương thích với tài liệu
app=ws,op=pvyêu cầu. Cần xác nhận phiên bản thiết bị và phần mềm. - Đối với bất kỳ thử nghiệm trực tiếp nào sau này: người nhận được chấp thuận, thông tin đăng nhập chính xác và tuyến SMS đã được xác thực. Tuyến SIM yêu cầu vùng phủ sóng; các dịch vụ bên ngoài yêu cầu truy cập internet và cấu hình của nhà cung cấp.
Tích hợp FoxBox đã được xác nhận. Làm theo hướng dẫn cho ứng dụng và cấu hình quyền truy cập, người nhận cùng định tuyến SMS.
FoxBox nào phù hợp với tích hợp này?
Chọn định dạng, số lượng modem và mạng bạn cần. Giữ Grafana Alerting làm ngữ cảnh dự án.
Tìm FoxBox phù hợp cho tích hợp này →03 / CÀI ĐẶT
Bắt đầu trong chế độ cách ly.
Chuẩn bị cầu nối.
Tải xuống gói mã nguồn. Làm theo README gốc của nó để cấu hình cầu nối bên ngoài ở chế độ chạy thử, sử dụng các trình giữ chỗ và đích kiểm tra cục bộ.
Bước 2
Tạo điểm liên hệ Webhook trong Grafana Alerting.
Bước 3
Thiết lập điểm cuối cầu nối và cấu hình xác thực được bảo vệ.
Bước 4
Sử dụng thử nghiệm điểm liên hệ với cầu nối chạy thử trước khi gán chính sách thông báo.
04 / XEM LẠI MÃ
Không có gì được giấu kín
phía sau ví dụ.
Các tệp bên dưới đến từ gói mã nguồn tích hợp có thể tải xuống. Hãy xem lại hướng dẫn tích hợp và cầu nối đầy đủ trước khi sử dụng ví dụ.
Loading source…05 / XÁC THỰC ĐƯỜNG DẪN
Kiểm tra ví dụ.
Sau đó kiểm tra việc triển khai.
Cấu hình tích hợp của bạn.
python3 -m unittest discover -s tests -vKiểm tra tải trọng dự kiến, hành vi xác thực, xử lý trùng lặp và phản hồi lỗi. Phần mềm Lab bên dưới minh họa luồng cục bộ trong trình duyệt của bạn.
Tích hợp FoxBox đã được xác nhận. Làm theo hướng dẫn cho ứng dụng và cấu hình quyền truy cập, người nhận cùng định tuyến SMS.
06 / KHẮC PHỤC SỰ CỐ
Hiển thị các lỗi.
Cầu nối từ chối tải trọng.
Kiểm tra ánh xạ trường tích hợp so với cấu hình được cung cấp. Sử dụng các ví dụ tổng hợp trước. Không sao chép nội dung sự kiện sản xuất hoặc thông tin đăng nhập vào nhật ký hỗ trợ.
Yêu cầu hết thời gian chờ.
Xác nhận khả năng kết nối, TLS và định dạng yêu cầu dự kiến. Không tự động gửi lại yêu cầu SMS không rõ ràng: yêu cầu đầu tiên có thể đã được chấp nhận.
API đã chấp nhận yêu cầu, nhưng không có tin nhắn SMS nào được gửi đến.
Việc chấp nhận yêu cầu không phải là xác nhận đã gửi. Kiểm tra trạng thái tin nhắn FoxBox đã được ghi lại và điều kiện mạng di động trên thiết bị thực. Tích hợp đã được xác nhận.
Một sự kiện trùng lặp đã được gửi.
Xem xét cài đặt khóa sự kiện cầu nối và khử trùng lặp. Xác thực các sự kiện được nhóm và khôi phục trong phần mềm mục tiêu trước khi bật thông báo trực tiếp.
TỪ TÍCH HỢP ĐẾN PHẦN CỨNG
Chọn định dạng.
Xác thực sự phù hợp.
Bắt đầu với S1 cho một modem, S2 cho hai modem, hoặc SR cho triển khai trên giá đỡ. Việc tích hợp đơn thuần không quyết định dung lượng modem hoặc yêu cầu về khả năng phục hồi.
FoxBox S2 · thiết bị nhỏ gọn, hai modemCấu hình và xác thực
Thiết lập kỹ thuật: Grafana
Kết nối thông qua cầu nối bên ngoài
Tạo điểm liên hệ Webhook với HTTP POST, URL cầu nối và ủy quyền Bearer. Giữ nguyên tải trọng webhook gốc của Grafana. Đặt Số lượng cảnh báo tối đa là 20 cho trình phân tích cú pháp được cung cấp và giữ cho thông báo đã được giải quyết được bật. Định tuyến chính sách thông báo có phạm vi hẹp đến điểm liên hệ này trước khi xem xét các nhóm cảnh báo rộng hơn.
Cầu nối đọc dấu vân tay cảnh báo và thời gian bắt đầu/kết thúc để phân biệt các nhóm đang kích hoạt và đã được giải quyết. Nó giới hạn kích thước tin nhắn và từ chối các tải trọng không phù hợp; nó không âm thầm gửi một danh sách bị cắt ngắn của mọi cảnh báo. Giữ thông tin xác thực cầu nối trong trường ủy quyền được bảo vệ của Grafana và thông tin xác thực FoxBox chỉ trên máy chủ cầu nối.
Ví dụ cấu hình · thay thế các phần giữ chỗ trước khi sử dụng
URL: https://bridge.example.invalid/webhooks/grafana
HTTP method: POST
Authorization scheme: Bearer
Authorization credentials: <PRIVATE_BRIDGE_TOKEN>
Max Alerts: 20
Disable resolved message: false
Payload: default Grafana webhook JSONXác thực trước khi kích hoạt transport
- Sử dụng nhóm kích hoạt tổng hợp, phân phối trùng lặp, nhóm đã giải quyết và nhóm quá khổ; kiểm tra định danh sổ cái và hành vi từ chối với chế độ chạy thử được bật.
Tài liệu tham khảo: Grafana webhook notifier
API FoxBox: tham số, lỗi và trạng thái · Xác thực bộ chuyển đổi và xử lý trùng lặp
