Datasource sập hoặc lỗi

Triệu chứng

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

Bật thất bại. Bật Enable trên một hàng datasource đầu vào bị bật ngược về Disabled và hiện một mã lỗi như model_not_paired hoặc adapter_connect_failed.
Một nguồn đang chạy bị lỗi giữa chừng. Một datasource trước đó đang truyền ngừng sản sinh dự đoán; hàng hiện chỉ báo lỗi 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 mã lỗi trên hàng. Mã đặt tên trực tiếp cho bước đã thất bại:
- model_not_paired → datasource chưa được gán mô hình.
- adapter_connect_failed → kết nối giao thức (bắt tay OPC-UA / kết nối broker MQTT / dò Modbus) thất bại — hầu như luôn là vấn đề mạng hoặc endpoint.

Kiểm tra log backend để xem lần thử kết nối và lý do lỗi:

docker compose -f docker-compose.release.yml logs backend | grep -iE "datasource|adapter|fault|enable"

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. Phục hồi không tự động — nguồn phải được bật lại từ đầu.

model_not_paired — gán một mô hình cho datasource trước, rồi Enable lại. Một datasource phải được ghép cặp với một mô hình trước khi nó có thể chạy.
adapter_connect_failed — runtime không thể tới được nguồn. Việc Enable đã quay hàng về Disabled 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 Enable lại.
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).
- Enable lại datasource (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.

Ghép cặp mô hình và ánh xạ tất cả kênh trước khi đưa vào hoạt động. Hầu hết các lỗi Enable là xác thực tiền-khởi-động: thiếu ghép cặp mô hình hoặc ánh xạ tag-tới-kênh chưa hoàn chỉnh (chỗ trống hoặc điền quá). Hoàn thành những việc này một lần và Enable 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 luồng và buộc phải re-enable đầ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 luồng hai bước. Enable 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ó đã enabled nhưng không có gì xảy ra”.