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

Quy tắc vận hành

• Theo dõi Monitor Log & Thông báo: Tại giao diện báo cáo của Connector API, bạn có thể xem chi tiết Monitor Log của các request gọi đến API. Đồng thời, hệ thống cho phép thiết lập nhận thông báo đồng bộ khi có sự kiện dữ liệu được đẩy vào thành công hoặc thất bại.

Usecase

• 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.

7. Bước tiếp theo

Theo dõi & xử lý sự cố đồng bộ với Monitor Log