Datasource sập hoặc lỗi

Triệu chứng

Một trong hai tình huống:

Bật luồng thất bại. Trên Quản lý tác vụ, công tắc Bật của luồng quay về tắt và một thông báo nêu vấn đề, ví dụ “Could not connect to the datasource”.
Một nguồn đang chạy bị lỗi giữa chừng. Một luồng đang truyền ngừng sản sinh dự đoán và một banner đỏ xuất hiện. Bên dưới, runtime đã rớt về trạng thái lỗi rồi nhàn rỗi (idle).

Xác định giai đoạn nào đã thất bại.

Đọc thông báo. Thông báo nêu bước đã thất bại:
- “Could not connect to the datasource” (adapter_connect_failed) → kết nối giao thức (bắt tay OPC-UA / kết nối broker MQTT) thất bại — hầu như luôn là vấn đề mạng hoặc endpoint.
- exactly_N_tags_required → tag mapping của đầu vào chưa đầy đủ.
- Shape không khớp → mô hình không còn khớp window size và tag count của đầu vào, hoặc tag count của một đầu ra.
Kiểm tra log backend để xem lần thử kết nối và lý do lỗi. Mỗi lần bật và tắt luồng đều được ghi kèm tên luồng:
Terminal window
```
docker logs aiboard-backend-real 2>&1 | grep -iE "flow|datasource|adapter|fault"
```
Một lỗi giữa chừng đến từ một lỗi đọc trên nguồn trực tiếp (một tag ngừng phản hồi). Khi điều đó xảy ra runtime tháo dỡ về một trạng thái idle sạch: mô hình được gỡ nạp và adapter được tháo gắn. Luồng vẫn hiển thị là đang bật. Phục hồi không tự động — luồng phải được bật lại.

Lỗi kết nối — runtime không thể tới được nguồn. Việc bật đã quay luồng về tắt một cách gọn gàng, nên hãy sửa kết nối và thử lại:
- Xác minh địa chỉ endpoint, cổng, và thông tin xác thực trong cấu hình datasource.
- Xác nhận hộp có khả năng tới được mạng tới máy chủ OPC-UA / broker MQTT / thiết bị.
- Với một nguồn CSV, xác nhận đường dẫn tệp và rằng tệp tồn tại và đọc được.
- Dùng Test Connection của biểu mẫu với các giá trị hiện tại, rồi bật lại luồng.
Mapping chưa đầy đủ — mở Map tag trên nguồn dữ liệu đầu vào, map mọi channel, lưu, rồi bật lại luồng.
Một nguồn đã lỗi giữa chừng đã được tháo dỡ về idle — mô hình đã được gỡ nạp và adapter tháo gắn. Hãy thiết lập lại nó đầy đủ:
- Sửa vấn đề nguồn nền (kết nối lại cảm biến / khôi phục tag / sửa mạng).
- Tắt luồng rồi bật lại. Việc này nạp lại mô hình và kết nối lại adapter.
- Bấm Start để tiếp tục truyền.

Map tất cả channel trước khi đưa vào hoạt động. Hầu hết các lỗi bật là xác thực tiền-khởi-động: tag mapping chưa đầy đủ, hoặc mô hình không còn khớp với đầu vào. Hoàn thành mapping một lần và luồng bật thành công ngay lần đầu.
Ổn định nguồn trước Start. Một endpoint OPC-UA chập chờn hoặc broker gián đoạn sẽ làm lỗi truyền dữ liệu và buộc phải bật lại đầy đủ. Xác nhận một kết nối ổn định bằng Test Connection trước khi bấm Start.
Kỳ vọng quy trình hai bước. Bật để chuẩn bị; Start để truyền. Đưa điều này vào quy trình vận hành tránh các phiếu “nó đã bật nhưng không có gì xảy ra”.