Error workflow n8n: bắt lỗi và gửi cảnh báo ngay lập tức

Một workflow đồng bộ đơn hàng chạy lỗi lúc 2 giờ sáng. Không ai biết cho tới khi khách gọi hỏi vì sao đơn không lên hệ thống. Đó là lý do error workflow n8n tồn tại. Một workflow riêng, chuyên bắt lỗi từ mọi workflow khác rồi báo ngay, thay vì để bạn tự phát hiện qua khiếu nại.

Error workflow n8n là gì

Error workflow n8n là một workflow độc lập, được gán làm nơi xử lý lỗi cho các workflow khác trong cùng một instance. Workflow chính gặp lỗi và dừng lại. n8n tự động gọi workflow này kèm dữ liệu về lỗi đó: tên workflow, node nào chết, thông điệp lỗi. Khác Error Trigger node rải rác từng workflow. Một nơi xử lý lỗi có thể gán cho hàng chục workflow cùng lúc.

Không có nó thì sao. Một node gặp lỗi thì n8n chỉ dừng thực thi và ghi lại trong execution log. Không ai xem log đó nếu không chủ động vào kiểm tra. Có người trực như quản trị máy chủ thì phát hiện tiến trình bất thường sớm hơn, trước cả khi ai mở log lên xem. Workflow chạy nền theo lịch hoặc theo webhook thì không kiểm tra nghĩa là không biết.

Cách gán error workflow cho một workflow trong n8n

Vào phần cài đặt của workflow cần giám sát, chọn Settings, rồi chọn Error Workflow trong danh sách thả xuống. n8n liệt kê mọi workflow đang active để bạn chọn làm nơi nhận lỗi. Không cần dựng riêng cho từng cái. Một error workflow có thể phục vụ nhiều workflow khác.

Error workflow nhận dữ liệu qua node Error Trigger đặt ở đầu, thay cho Manual Trigger hay Webhook thông thường. Dữ liệu trả về gồm workflow.id, workflow.name, execution.id và error.message. Đủ để dựng một tin nhắn cảnh báo có ngữ cảnh, không phải chỉ báo chung chung "có lỗi xảy ra".

Ba trường dữ liệu hay dùng nhất

Ba trường lấy ra thường xuyên nhất khi soạn tin nhắn cảnh báo là tên workflow gặp lỗi, thông điệp lỗi gốc và thời điểm xảy ra. Ghép chung một dòng. Đủ để người nhận biết ngay cần mở workflow nào.

Giới hạn cần biết trước khi dựng

Error Trigger chỉ nhận được lỗi khi workflow chính dừng hẳn thực thi. Có ngoại lệ. Một node bị lỗi nhưng nằm trong nhánh có Continue On Error bật sẵn thì workflow vẫn chạy tiếp, không dừng, và error workflow không hề được gọi.

Bẫy Retry On Fail bị vô hiệu khi bật Continue On Error

Bật Continue On Error cho một node coi như tắt luôn cơ chế Retry On Fail của chính node đó, dù ô nhập số lần thử lại vẫn hiện trên giao diện. Lý do nằm ở thứ tự ưu tiên. n8n ưu tiên cho workflow chạy tiếp ngay khi gặp lỗi thay vì dừng lại thử lại, nên số lần retry đặt bao nhiêu cũng không chạy.

Nhiều người bật cả hai cùng lúc vì nghĩ chúng cộng dồn: vừa thử lại vài lần, vừa không làm sập cả workflow nếu vẫn lỗi. Thực tế node chỉ chọn một trong hai. Bật Continue On Error, node lỗi một lần là bỏ qua ngay. Giá trị rỗng hoặc null in thẳng vào output rồi đẩy xuống node kế tiếp.

Cách tách đúng thế nào. Node nào cần thử lại vì lỗi có thể tự hết, ví dụ timeout mạng hay API tạm quá tải, thì chỉ bật Retry On Fail, để mặc định 2-3 lần với khoảng chờ giữa các lần. Node nào lỗi không ảnh hưởng luồng chính, ví dụ ghi log phụ, mới bật Continue On Error để không làm gãy cả workflow vì một bước không quan trọng.

Gửi cảnh báo qua Telegram khi workflow lỗi

Telegram là kênh phổ biến nhất để nhận cảnh báo lỗi vì tin nhắn đến ngay trên điện thoại, không phải mở email kiểm tra. Trong error workflow, thêm node Telegram sau Error Trigger. Điền chat ID của nhóm hoặc cá nhân cần nhận tin, rồi soạn nội dung tin nhắn từ ba trường dữ liệu đã nói ở trên.

Một tin nhắn hữu ích cần nêu rõ tên workflow lỗi, dòng thông điệp lỗi và thời gian xảy ra. Tránh chung chung kiểu "workflow lỗi rồi". Người nhận đọc xong phải biết ngay cần mở n8n lên xử lý workflow nào, không phải đoán.

Với đội có nhiều workflow chạy song song, có thể thêm node điều kiện lọc theo mức độ nghiêm trọng. Workflow xử lý thanh toán lỗi thì gửi vào nhóm ưu tiên cao. Workflow đồng bộ dữ liệu phụ thì gửi vào nhóm theo dõi chung.

Đặt error workflow ở cấp nào trong hệ thống

n8n cho gán error workflow ở hai cấp: từng workflow riêng lẻ, hoặc mặc định cho toàn instance qua phần cài đặt hệ thống. Cấp instance tiện. Không phải gán tay từng workflow mới tạo. Nhưng mất khả năng phân loại mức độ khẩn cấp theo từng luồng nghiệp vụ.

Cách làm cân bằng ra sao. Đặt một error workflow mặc định ở cấp instance để không workflow nào lọt lưới, rồi gán riêng cho những workflow quan trọng nhất một error workflow khác có mức cảnh báo cao hơn, ví dụ gọi thêm cuộc gọi hoặc gửi tin nhắn khẩn thay vì chỉ nhắn Telegram thường.

Việc theo dõi workflow chạy ổn định lâu dài còn liên quan tới hạ tầng máy chủ, không chỉ cấu hình bên trong n8n. Với đội chưa có người trực vận hành máy chủ, dịch vụ quản trị máy chủ theo dõi tài nguyên và xử lý sự cố hạ tầng. Error workflow khi đó chỉ còn lo phần logic của n8n.

Những lỗi hay gặp khi mới dựng error workflow

Phần lớn lỗi khi mới dựng đến từ hiểu sai cơ chế trigger hoặc quên gán workflow. Không phải do node cấu hình sai. Ba lỗi dưới đây lặp lại nhiều nhất khi đội kỹ thuật mới bắt đầu dùng error workflow.

Quên gán error workflow cho workflow mới tạo

Mỗi workflow tạo mới không tự động thừa hưởng error workflow đã gán cho workflow khác, trừ khi đặt mặc định ở cấp instance. Đội có thói quen sao chép workflow cũ càng dễ quên bước này, vì tưởng cấu hình đã đi theo bản sao.

Dựng error workflow nhưng để nó ở trạng thái inactive

n8n chỉ gọi được error workflow khi workflow đó đang bật active. Nhiều người quên mất điều này. Dựng xong, test một lần bằng nút chạy thủ công rồi tắt đi, quên bật lại trước khi đưa vào sản xuất.

Nhầm Stop and Error với lỗi hệ thống thật

Node Stop And Error cho phép chủ động dừng workflow và coi đó là một lỗi, dùng khi dữ liệu đầu vào không hợp lệ theo logic nghiệp vụ, ví dụ đơn hàng thiếu số điện thoại. Đây là lỗi có chủ đích. Khác với lỗi hệ thống như API sập hay hết thời gian chờ. Gộp chung hai loại vào cùng một kênh cảnh báo làm người nhận tin không phân biệt được cái nào cần xử lý gấp.

Dựng đủ cơ chế bắt lỗi này cần một máy chủ đang chạy sẵn n8n, PostgreSQL và Redis. Không phải cài từ tay trắng. Tham khảo gói VPS cài sẵn n8n nếu chưa có môi trường để thử ngay hôm nay.

Câu hỏi thường gặp về error workflow n8n

Ghi nhanh

• Error workflow n8n là workflow riêng, gán cho workflow khác để nhận dữ liệu lỗi và báo ngay qua Error Trigger.
• Bật Continue On Error trên một node sẽ vô hiệu Retry On Fail của chính node đó, dù giao diện vẫn cho nhập số lần thử lại.
• Tách rõ: node cần thử lại vì lỗi tạm thời thì bật Retry On Fail, node không ảnh hưởng luồng chính mới bật Continue On Error.
• Gán error workflow ở cấp instance để không workflow nào lọt lưới, thêm gán riêng cho workflow quan trọng nếu cần mức cảnh báo cao hơn.
• Workflow mới tạo không tự thừa hưởng error workflow đã gán cho workflow khác, phải kiểm tra lại Settings mỗi lần dựng mới.