Skip to main content

AI-POWERED DOCS

What do you want to know?

Debug Node-RED

Hướng dẫn này cung cấp quy trình khắc phục sự cố toàn diện cho các vấn đề Node-RED trên hệ thống camera OV10i. Sử dụng tài liệu này cho việc sửa chữa tại hiện trường, debug các vấn đề sản xuất và bảo trì phòng ngừa cho các flow inspection.

warning

An Toàn Trên Hết: Luôn thông báo cho bộ phận sản xuất trước khi thực hiện thay đổi trên các hệ thống inspection đang hoạt động. Tạo backup trước khi chỉnh sửa flows.

Quy Trình Sửa Lỗi Nhanh Khẩn Cấp​

Hệ Thống Ngừng Hoạt Động - Hành Động Ngay Lập Tức​

BướcHành ĐộngThời GianKết Quả
1Kiểm tra trạng thái LED nguồn của camera30 giâyXác nhận phần cứng OK
2Truy cập OV10i Node-RED: http://camera-ip/recipes/<recipe-number>/ioblock1 phútXác nhận có thể truy cập editor
3Tìm các chỉ báo lỗi hình tam giác đỏ1 phútXác định các node bị lỗi
4Nhấn nút Deploy (Full Deploy)30 giâyReset tất cả flows
5Kiểm tra trigger inspection cơ bản2 phútXác nhận hệ thống vận hành

Khôi Phục Hệ Thống (Nếu Editor Không Tải Được)​

Camera OV10i không có chế độ safe mode - khởi động lại là phương pháp khôi phục chính:

  1. Ngắt nguồn camera (rút nguồn trong 10 giây)
  2. Chờ khởi động hoàn toàn (tất cả 4 LED ổn định - 2-3 phút)
  3. Truy cập Node-RED của recipe đang hoạt động thông qua URL dành riêng cho recipe
  4. Xác minh tính toàn vẹn của flow và thực hiện các sửa chữa cần thiết
  5. Deploy thay đổi để khôi phục hoạt động bình thường
note

Định Dạng URL: http://<camera-ip>/recipes/<recipe-number>/ioblock

Ví Dụ:

  • http://192.168.0.101/recipes/20/ioblock
  • http://192.168.0.105/recipes/1/ioblock

Quy Trình Debug Có Hệ Thống​

Bước 1: Xác Định Phạm Vi Vấn Đề​

Các Câu Hỏi Đánh Giá Nhanh​

Câu HỏiNếu CÓNếu KHÔNG
Bạn có thể truy cập giao diện OV10i Node-RED không?Tiếp tục sang Bước 2Kiểm tra trạng thái mạng/camera
Flows có hiển thị trong editor không?Tiếp tục sang Bước 2Khởi động lại camera và thử lại
Bạn có thấy các hình tam giác lỗi trên node không?Tập trung vào các node đó trướcKiểm tra việc thực thi flow
Inspection có được kích hoạt không?Kiểm tra output của từng node riêng lẻXác minh các trigger inputs
note

URL Truy Cập: Sử dụng định dạng URL dành riêng cho recipe: http://<camera-ip>/recipes/<recipe-number>/ioblock

Bước 2: Kích Hoạt Giám Sát Debug​

Thêm Debug Nodes Để Khắc Phục Sự Cố​

  1. Đặt Debug nodes tại các điểm quan trọng trong các flow có vấn đề:
    • Sau các trigger inputs
    • Trước và sau các logic nodes
    • Tại các output cuối cùng
  2. Cấu hình Debug nodes để có thông tin tối đa:
    • Output: Toàn bộ message object
    • To: Debug sidebar
    • Name: Tên mang tính mô tả (ví dụ: "After Classification Logic")
  3. Kích hoạt tất cả Debug nodes bằng cách nhấn các nút của chúng trong editor

Quản Lý Debug Sidebar​

Truy Cập Debug Sidebar:

  • Nhấn Debug tab (biểu tượng con bọ) ở panel bên phải
  • Xóa các message cũ bằng biểu tượng thùng rác
  • Lọc message nếu có quá nhiều node đang hoạt động

Diễn Giải Debug Message:

  • Timestamp hiển thị thời điểm message xảy ra
  • Tên node hiển thị node nào đã tạo ra message
  • Nội dung message hiển thị cấu trúc dữ liệu và giá trị

Bước 3: Theo Dõi Quá Trình Thực Thi Flow​

Theo Dõi Đường Đi Của Message​

  1. Bắt đầu từ nguồn trigger (inject, timer, đầu vào ngoài)
  2. Xác minh mỗi node nhận được đầu vào mong đợi
  3. Kiểm tra các biến đổi message ở mỗi bước
  4. Xác định vị trí flow dừng lại hoặc tạo ra đầu ra sai

Các Điểm Gián Đoạn Flow Thường Gặp​

Loại NodeVấn Đề Thường GặpKiểm Tra Nhanh
Classification LogicKhông đạt ngưỡng độ tin cậyKiểm tra căn chỉnh ROI, huấn luyện lại model
Switch NodeLogic điều kiện saiXác minh quy tắc switch và thuộc tính message
Join NodeĐang chờ tập message chưa hoàn chỉnhKiểm tra số lượng phần message
Function NodeLỗi JavaScriptKiểm tra console trình duyệt để xem lỗi
HTTP RequestKết nối mạngKiểm tra endpoint thủ công

Các Vấn Đề Node-RED Thường Gặp & Giải Pháp​

Vấn Đề Thực Thi Flow​

Vấn Đề: Flow Không Kích Hoạt​

Triệu Chứng:

  • Không có message nào trong sidebar Debug
  • Hệ thống có vẻ không hoạt động
  • Trigger ngoài không hoạt động

Các Bước Chẩn Đoán:

  1. Kiểm tra nguồn trigger: Inject thủ công, timer, đầu vào ngoài
  2. Xác minh dây nối: Đảm bảo các kết nối giữa các node
  3. Kiểm tra trigger thủ công: Sử dụng Inject node để buộc flow khởi động

Giải Pháp:

Nguyên NhânGiải PhápPhòng Ngừa
Flow bị vô hiệu hóaNhấp Deploy → Full DeployDeploy thường xuyên sau khi thay đổi
Kết nối bị đứtNối lại các node đúng cáchKiểm tra trực quan trong khi chỉnh sửa
Cấu hình timer saiKiểm tra cài đặt thời gian của inject nodeGhi lại yêu cầu về thời gian
Lỗi trigger ngoàiXác minh dây nối và tín hiệu I/OKiểm tra I/O thường xuyên

Vấn Đề: Flow Chạy Nhưng Kết Quả Sai​

Triệu Chứng:

  • Message vẫn chạy nhưng phân loại sai
  • Logic pass/fail không hoạt động đúng
  • Kết quả không nhất quán

Quy Trình Chẩn Đoán:

  1. Thêm Debug node trước và sau các node nghi ngờ
  2. So sánh nội dung message mong đợi với thực tế
  3. Kiểm tra cấu hình node để đảm bảo tham số đúng

Giải Pháp:

Khu Vực Vấn ĐềKiểm TraKhắc Phục
Classification LogicCăn chỉnh ROI, huấn luyện modelHuấn luyện lại hoặc điều chỉnh ROI
Switch ConditionsTên và giá trị thuộc tínhSửa logic switch
Message PropertiesKiểu dữ liệu và định dạngSử dụng Change node để sửa định dạng
Context VariablesGiá trị đã lưu và phạm viXóa/reset bộ nhớ context

Vấn Đề Hiệu Năng​

Vấn Đề: Flow Thực Thi Chậm​

Triệu Chứng:

  • Trễ giữa trigger và đầu ra
  • Hết thời gian chờ kiểm tra
  • Hệ thống bị lag

Chẩn Đoán Hiệu Năng:

  1. Kiểm tra timestamp của Debug để xác định các node chậm
  2. Theo dõi mức sử dụng CPU trên hệ thống camera
  3. Đếm số Debug node đang hoạt động (vô hiệu hóa các node không sử dụng)

Hành Động Tối Ưu:

Vấn Đề Hiệu NăngGiải PhápCải Thiện Kỳ Vọng
Quá nhiều Debug nodeVô hiệu hóa/xóa các Debug node không sử dụngTăng tốc 10-20%
Function node phức tạpTối ưu mã JavaScriptCải thiện tùy trường hợp
Trigger tần suất caoThêm delay/giới hạn tốc độNgăn ngừa quá tải hệ thống
Đối tượng message lớnGiảm kích thước payload messageXử lý nhanh hơn

Quy Trình Bảo Trì​

Kiểm Tra Tình Trạng Hàng Ngày​

Kiểm Tra Trực Quan Flow (5 phút)​

  1. Truy cập Node-RED editor
  2. Kiểm tra các chỉ báo lỗi (tam giác đỏ)
  3. Xác minh các kết nối flow còn nguyên vẹn
  4. Xem xét các thông báo Debug gần đây để phát hiện bất thường

Kiểm Tra Thực Thi Flow (10 phút)​

  1. Kiểm tra kích hoạt thủ công sử dụng Inject nodes
  2. Xác minh đầu ra mong đợi trong Debug sidebar
  3. Kiểm tra logic pass/fail với các bộ phận tốt/xấu đã biết
  4. Xác nhận giao tiếp bên ngoài (PLC, cơ sở dữ liệu)

Nhiệm Vụ Bảo Trì Hàng Tháng​

Đánh Giá Hiệu Suất (15 phút)​

Danh Sách Kiểm Tra Tối Ưu Hóa Flow:

Nhiệm VụHành ĐộngGhi Chú
Dọn Dẹp Debug NodeVô hiệu hóa các Debug node không sử dụngChỉ giữ lại những phần debug thiết yếu
Xem Xét Context StorageXóa các giá trị lưu trữ không cần thiếtNgăn ngừa tích tụ bộ nhớ
Xem Xét Nhật Ký LỗiKiểm tra browser console để phát hiện lỗiGhi lại các vấn đề lặp lại
Tạo Bản Sao LưuXuất các flow sang tệp sao lưuLưu kèm thông tin ngày/phiên bản

Xác Thực Cấu Hình (20 phút)​

  1. So sánh các flow hiện tại với tiêu chuẩn đã được ghi chép
  2. Xác minh tất cả các đường dẫn quan trọng đều có xử lý lỗi phù hợp
  3. Kiểm tra các kịch bản khôi phục lỗi
  4. Cập nhật tài liệu cho bất kỳ thay đổi nào

Bảo Trì Chuyên Sâu Hàng Tháng​

Phân Tích Flow Toàn Diện (45 phút)​

Thu Thập Số Liệu Hiệu Suất:

  • Thời gian thực thi flow
  • Phân tích tần suất lỗi
  • Các mẫu sử dụng tài nguyên
  • Độ tin cậy của giao tiếp

Xem Xét Cấu Trúc Flow:

  • Loại bỏ các node dư thừa
  • Hợp nhất logic trùng lặp
  • Cập nhật các cấu hình đã lỗi thời
  • Tối ưu hóa các Function node phức tạp

Kiểm Tra Sao Lưu Và Khôi Phục (30 phút)​

  1. Tạo bản xuất flow hoàn chỉnh
  2. Kiểm tra quy trình import trên hệ thống sao lưu
  3. Xác minh việc khôi phục sao lưu duy trì được chức năng
  4. Ghi chép các quy trình khôi phục

Công Cụ Và Kỹ Thuật Chẩn Đoán​

Công Cụ Tích Hợp Sẵn Trong Node-RED​

Các Tính Năng Debug Sidebar​

Tính NăngTrường Hợp Sử DụngPhương Thức Truy Cập
Lọc Thông BáoTập trung vào các node cụ thểNút Filter trong sidebar
Lịch Sử Thông BáoXem lại 100 thông báo trước đóCuộn trong Debug sidebar
Vị Trí NodeTìm nguồn của thông báo DebugNhấp vào tên node trong thông báo
Xuất Thông BáoLưu dữ liệu chẩn đoánSao chép nội dung thông báo

Context Data Explorer​

Truy Cập Context Storage:

  • Mở giao diện Node-RED của OV10i (http://<camera-ip>/recipes/<recipe-number>/ioblock)
  • Đi đến tab Context Data (sidebar bên phải)
  • Xem các giá trị Node/Flow/Global context

Debug Context:

  • Node Context: Kiểm tra trạng thái của từng node riêng lẻ
  • Flow Context: Xác minh các biến flow được chia sẻ
  • Global Context: Xem xét các cài đặt toàn hệ thống

Kiểm Tra Giao Tiếp Mạng​

Xác Thực HTTP Request:

  1. Sử dụng các công cụ bên ngoài (Postman, curl) để kiểm tra các endpoint
  2. Xác minh định dạng phản hồi khớp với dữ liệu mong đợi
  3. Kiểm tra các điều kiện lỗi (timeout, phản hồi không hợp lệ)

Xác Minh Giao Tiếp PLC:

  1. Sử dụng phần mềm lập trình PLC để xác minh kết nối
  2. Kiểm tra truy cập data register một cách độc lập
  3. Xác thực các chuyển đổi định dạng dữ liệu

Quy Trình Khôi Phục Khẩn Cấp​

Khôi Phục Flow Bị Hỏng​

Triệu Chứng Của Flow Bị Hỏng:​

  • Giao diện Node-RED của OV10i không tải được flows
  • Flows trống sau khi khởi động lại camera
  • Deploy thất bại nhiều lần

Các Bước Khôi Phục:​

  1. Khởi động lại nguồn camera OV10i:
    • Rút nguồn trong 10 giây
    • Đợi khởi động hoàn tất (tất cả 4 LED sáng ổn định)
  2. Truy cập giao diện Node-RED của recipe:
    • Điều hướng đến http://<camera-ip>/recipes/<recipe-number>/ioblock
    • Nếu flows bị hỏng, import từ bản backup
  3. Khôi phục từ bản backup:
    • Sử dụng chức năng import recipe của OV10i
    • Import tệp backup gần nhất
    • Xác minh tất cả kết nối còn nguyên vẹn
  4. Xác nhận việc khôi phục:
    • Kiểm tra tất cả flows quan trọng
    • Xác minh giao tiếp với hệ thống bên ngoài
    • Cập nhật các thay đổi cấu hình

Vấn Đề Tài Nguyên Hệ Thống​

Quá Tải Memory/CPU​

Hành Động Tức Thời:

  1. Vô hiệu hóa các Debug node không cần thiết trong Node-RED của OV10i
  2. Loại bỏ các trigger timer tần số cao
  3. Đơn giản hóa các Function node phức tạp
  4. Khởi động lại camera để khởi động lại tất cả dịch vụ

Giải Pháp Dài Hạn:

  • Tối ưu thiết kế flow cho phần cứng OV10i
  • Triển khai rate limiting
  • Giảm kích thước message payload
  • Lên lịch các cửa sổ bảo trì

Danh Sách Kiểm Tra Khắc Phục Sự Cố​

Danh Sách Kiểm Tra Trước Bảo Trì​

  • Thông báo cho bộ phận sản xuất về cửa sổ bảo trì
  • Tạo bản backup flow hiện tại
  • Ghi nhận trạng thái hệ thống hiện tại
  • Chuẩn bị quy trình rollback
  • Kiểm tra quy trình khôi phục backup

Xác Nhận Sau Bảo Trì​

  • Tất cả flows deploy thành công
  • Các bài kiểm tra trigger thủ công đạt yêu cầu
  • Giao tiếp với hệ thống bên ngoài đã được xác minh
  • Các chỉ báo lỗi đã được xóa
  • Hiệu suất nằm trong phạm vi chấp nhận được
  • Tài liệu đã được cập nhật

Danh Sách Kiểm Tra Ứng Phó Khẩn Cấp​

  • Đã đánh giá tác động đến hệ thống
  • Đã thông báo cho bộ phận sản xuất
  • Đã thử khắc phục nhanh
  • Khôi phục từ backup nếu cần
  • Đã xác định nguyên nhân gốc
  • Đã triển khai các biện pháp phòng ngừa

Tài Liệu và Ghi Log​

Hồ Sơ Bảo Trì​

Tài Liệu Bắt Buộc:

  • Ngày/giờ bảo trì
  • Các vấn đề được xác định và giải quyết
  • Các thay đổi cấu hình đã thực hiện
  • Cải thiện hiệu suất đạt được
  • Khuyến nghị cho tương lai

🔗 Xem Thêm​

tip

Ghi lại tất cả các thay đổi được thực hiện trong các phiên debug. Điều này giúp ích cho việc khắc phục sự cố trong tương lai và xây dựng kiến thức nội bộ cho đội ngũ của bạn.