Báo cáo Connector API
1. Tổng quan
- Định nghĩa: Báo cáo Connector API theo dõi tiến trình nhận và xử lý dữ liệu từ nguồn API vào Mobio theo từng phiên đồng bộ.
- Lợi ích/Giá trị: Giúp kiểm tra nhanh phiên đang chạy, tỷ lệ xử lý thành công/thất bại và phát hiện sớm phiên có lỗi.
- Đối tượng sử dụng: System Admin, đội vận hành tích hợp dữ liệu.
2. Giải thích Thuật ngữ & Thông số
- Phiên đồng bộ: Một vòng đời xử lý dữ liệu được tạo khi bật kết nối hoặc chạy theo lịch.
- Bản tin xử lý thành công/thất bại/chưa xử lý: Nhóm chỉ số phản ánh kết quả xử lý dữ liệu trong kỳ lọc.
- Trạng thái đồng bộ trên UI: Chờ xử lý, Đang đồng bộ, Đồng bộ lỗi, Dừng đồng bộ, Hoàn tất.
- Chế độ hiển thị phiên: Table View và Pipeline View.
3. Điều kiện tiên quyết (Prerequisite)
- Bài viết trước: Hoàn tất khởi tạo connector và cấu hình đồng bộ dữ liệu cho ít nhất 1 đối tượng.
- Phân quyền: Tài khoản Mobio phải được cấp quyền RBAC: INTEGRATION. Xem hướng dẫn phân quyền truy cập RBAC tại đây.
- Cài đặt > Cài đặt DN > Đồng bộ dữ liệu > Data Flow
- Cài đặt > Cài đặt DN > Đồng bộ dữ liệu > Data Flow > Nguồn dữ liệu
- Đường dẫn truy cập: Cài đặt doanh nghiệp → Tích hợp dữ liệu → Data Flow/Nguồn dữ liệu → Chọn connector API → Báo cáo.
- Dữ liệu đầu vào: Có ít nhất một phiên đồng bộ đã phát sinh dữ liệu trong connector API.
4. Các bước thực hiện
4.1. Thiết lập bộ lọc báo cáo
- Chọn thời gian đồng bộ: hôm nay, hôm qua, 7 ngày trước, 30 ngày trước, tháng này, tháng trước, 90 ngày trước hoặc tùy chỉnh.
- Chọn trạng thái đồng bộ tập trung vào nhóm phiên cần theo dõi.
4.2. Theo dõi chỉ số tổng hợp
- Xem tổng số bản tin từ nguồn.
- Xem tổng số bản tin xử lý thành công, thất bại, chưa xử lý.
- Xem khối tổng số phiên và phân bố phiên theo trạng thái.
4.3. Theo dõi hiệu suất theo phiên
- Mở Table View để rà danh sách phiên và các cột số liệu chi tiết.
- Mở Pipeline View để theo dõi trực quan luồng tiếp nhận và xử lý của phiên.
- Chọn phiên có chênh lệch lớn giữa ghi nhận và xử lý để kiểm tra trước.
4.4. Kiểm tra chi tiết phiên đồng bộ
- Mở phiên cần kiểm tra từ danh sách.
- Đối chiếu số liệu theo ngày và theo nhóm dữ liệu trong phiên.
- Với phiên snapshot, theo dõi checkpoint để biết tiến độ xử lý hiện tại.
5. Quy tắc vận hành & Use case
- Khi số thất bại tăng, ưu tiên lọc theo đồng bộ lỗi để khoanh vùng phiên lỗi gần nhất.
- Khi phiên kéo dài nhiều ngày, xem chi tiết theo ngày trước khi kết luận nghẽn dữ liệu.
- Luôn so sánh trong cùng bộ lọc thời gian và cùng connector để tránh sai lệch khi đối chiếu.
6. Các câu hỏi thường gặp (FAQ)
- Hỏi: Nên dùng Table View hay Pipeline View?
- Trả lời: Dùng Table View khi cần rà nhanh toàn bộ phiên; dùng Pipeline View khi cần quan sát trạng thái xử lý theo luồng.
- Hỏi: Vì sao có bản tin chưa xử lý dù phiên đang chạy?
- Trả lời: Phiên có thể đang tiếp nhận thêm dữ liệu. Theo dõi thêm tiến trình phiên; nếu số chưa xử lý tăng kéo dài thì chuyển sang điều tra log.