Đọc log và lịch sử chạy Broma để tìm lỗi chạy hàng loạt
Vì sao log là nơi sửa lỗi nhanh nhất
Khi một quy trình Broma chỉ chạy một trang, bạn có thể nhìn thấy ngay lỗi. Nhưng khi chạy hàng loạt 20, 50 hoặc 100 URL, lỗi thường bị ẩn giữa các lần chạy. Nếu không đọc log, bạn sẽ phải chạy lại toàn bộ, tốn thời gian và có thể bỏ sót nguyên nhân thật.
Broma là ứng dụng desktop trên Windows và quy trình chạy trên máy của bạn. Vì vậy log và lịch sử phản ánh đúng trạng thái tại thời điểm chạy: trang tải chậm, selector không còn khớp, dữ liệu đầu vào sai, hồ sơ trình duyệt chưa đăng nhập, hoặc một bước chờ bị hết thời gian. Đọc log giúp bạn trả lời ba câu hỏi: lỗi xảy ra ở bước nào, chỉ xảy ra với URL nào, và lỗi lặp lại hay chỉ là sự cố tạm thời.
Ba lớp thông tin cần đọc trong mỗi lần chạy
Lớp phiên chạy
Hãy bắt đầu từ thông tin tổng của lần chạy: thời gian bắt đầu, thời gian kết thúc, tổng số mục, số mục thành công, số mục thất bại, hồ sơ trình duyệt được dùng và danh sách đầu vào.
Nếu một batch kéo dài bất thường, đừng vội sửa selector. Hãy xem có phải nhiều mục cùng chờ một phần tử không tồn tại hay không. Nếu tất cả thất bại ngay từ đầu, hãy kiểm tra đăng nhập, tệp đầu vào hoặc đường dẫn trang.
Lớp bước
Mỗi bước nên có tên rõ ràng: mở trang, chờ bảng, đọc giá, chụp màn hình, lưu kết quả. Khi lỗi, hãy tìm bước thất bại đầu tiên, không phải bước cuối cùng. Ví dụ một quy trình có thể gồm:
Mở URL từ danh sách
Chờ phần tử: [data-testid=orders-table]
Đọc văn bản bảng
Chụp màn hình nếu bảng rỗng
Nếu bước chờ thất bại, vấn đề thường là selector cũ, trang tải chậm, hoặc quyền truy cập chưa đúng. Nếu bước đọc thất bại, hãy kiểm tra selector đọc và biểu thức JavaScript.
Lớp dữ liệu và ảnh chụp
Log không chỉ là dòng chữ. Ảnh chụp màn hình, văn bản đọc được và kết quả OCR giúp bạn thấy trang thực sự trông như thế nào. Nếu log báo không đọc được giá, ảnh chụp có thể cho thấy trang đang hiển thị thông báo đăng nhập, trang trắng, hoặc phần tử nằm trong khung iframe.
Quy trình đọc log cho một batch bị lỗi
- Lọc các lần chạy có trạng thái thất bại.
- Nhóm theo bước lỗi đầu tiên. Nếu 10 mục cùng lỗi ở bước chờ, hãy sửa bước đó trước.
- Mở một bản ghi đại diện. Không cần mở tất cả.
- So sánh URL đầu vào với URL xuất hiện trong log. Một URL sai chính tả hoặc thiếu tham số có thể làm cả batch lỗi.
- Xem ảnh chụp hoặc văn bản OCR nếu bước lỗi liên quan đến đọc dữ liệu.
- Ghi lại nguyên nhân theo mẫu: bước lỗi, selector, thông báo, ảnh hưởng, cách sửa.
Ví dụ:
Bước lỗi: Chờ bảng đơn hàng
URL: https://dashboard.noi-bo/don-hang/10231
Thông báo: Không tìm thấy phần tử sau 15 giây
Ảnh chụp: Trang hiển thị biểu mẫu đăng nhập
Nguyên nhân: Hồ sơ trình duyệt chưa đăng nhập
Cách sửa: Mở lại hồ sơ, đăng nhập, chạy lại một URL trước khi chạy cả batch
Ví dụ thực tế: batch kiểm tra tồn kho
Giả sử bạn cần kiểm tra tình trạng còn hàng của 30 sản phẩm trên một trang nội bộ. Quy trình gồm: mở URL sản phẩm, chờ phần tử trạng thái, đọc chữ, chụp màn hình nếu không đọc được.
Một selector bền hơn class thay đổi liên tục là thuộc tính dữ liệu:
[data-testid=stock-status]
Nếu cần đọc nội dung, bạn có thể dùng biểu thức JavaScript ngắn:
document.querySelector('[data-testid=stock-status]')?.innerText.trim() || 'KHONG_DOC_DUOC'
Biểu thức này trả về văn bản trạng thái. Nếu không tìm thấy phần tử, nó trả về chuỗi KHONG_DOC_DUOC để bạn dễ phát hiện trong log.
Khi batch báo lỗi ở 5 URL, hãy đọc log theo thứ tự:
- Nếu cả 5 URL đều lỗi ở bước chờ, selector có thể đã thay đổi.
- Nếu chỉ 1 URL lỗi, trang sản phẩm đó có thể thiếu dữ liệu.
- Nếu lỗi xảy ra sau khi đăng nhập, hãy kiểm tra thời điểm chạy và trạng thái phiên.
Khi log báo đọc được nhưng dữ liệu sai
Đây là lỗi khó hơn lỗi không tìm thấy phần tử. Log có thể báo thành công vì bước đọc không nổ ra lỗi, nhưng giá trị trả về là tiêu đề, nhãn, hoặc chuỗi rỗng.
Hãy kiểm tra ba điểm:
- Selector có đang trỏ vào phần tử cha thay vì phần tử chứa giá trị không?
- Trang có cần chờ thêm sau khi phần tử xuất hiện không?
- Giá trị có nằm trong iframe hoặc được tải bằng JavaScript sau một thao tác khác không?
Một cách an toàn là thêm bước kiểm tra dữ liệu trước khi lưu:
Nếu văn bản đọc được rỗng hoặc bằng KHONG_DOC_DUOC, chụp màn hình và đánh dấu cần kiểm tra
Với quy trình có rẽ nhánh, hãy đặt điều kiện rõ ràng:
text.includes('Con hang') ? 'CON_HANG' : 'KHAC'
Nếu kết quả trả về KHAC quá thường xuyên, đừng vội kết luận hết hàng. Hãy mở ảnh chụp để xác minh.
Dùng lịch sử để phát hiện lỗi theo thời gian
Lịch sử chạy giúp bạn thấy quy trình có ổn định không. Nếu cùng một workflow thường lỗi vào buổi sáng nhưng ổn vào buổi chiều, có thể hệ thống đích đang bảo trì hoặc tải chậm. Nếu thời gian chạy tăng dần, trang có thể nặng hơn hoặc máy đang thiếu tài nguyên.
Với workflow có lịch, hãy xem các lần chạy gần nhất theo ba cột: thời gian, số mục thất bại, bước lỗi đầu tiên. Nếu một lỗi chỉ xuất hiện một lần rồi biến mất, hãy chạy lại một mục trước khi kết luận. Nếu lỗi xuất hiện ở cùng một bước trong ba lần liên tiếp, hãy sửa workflow.
Mẹo giúp log dễ đọc hơn
- Đặt tên bước theo hành động và mục tiêu, ví dụ: Chờ bảng tồn kho, Đọc giá bán, Chụp màn hình khi lỗi.
- Dùng selector có thuộc tính ổn định thay vì class tự sinh.
- Thêm bước chụp màn hình tại các điểm quan trọng: sau khi đăng nhập, sau khi chờ dữ liệu, trước khi lưu.
- Ghi chú URL mẫu trong quy trình để khi lỗi còn biết trang nào đã được kiểm tra.
- Không chạy lại toàn bộ batch khi chỉ một nhóm nhỏ lỗi; hãy chạy lại nhóm đó trước.
Khi nào sửa, khi nào chỉ cần chạy lại
Hãy chạy lại nếu lỗi xảy ra do mạng chập chờn, trang bảo trì ngắn, hoặc một URL tạm thời không phản hồi. Hãy sửa workflow nếu lỗi lặp lại ở cùng một bước, selector không còn khớp, hoặc dữ liệu đọc được không đúng cấu trúc.
Một nguyên tắc đơn giản: nếu ba lần chạy liên tiếp cùng lỗi ở một bước, đừng chạy lại lần thứ tư. Hãy mở log, xem ảnh chụp, kiểm tra selector và chỉnh một điểm nhỏ. Sau đó chạy lại với một URL để xác nhận trước khi đưa vào batch lớn.
Kết luận
Log và lịch sử không phải phần phụ. Chúng là nơi giúp bạn chuyển từ việc đoán mò sang sửa đúng nguyên nhân. Khi chạy hàng loạt trên Broma, hãy luôn đọc theo lớp: phiên chạy, bước lỗi, dữ liệu và ảnh chụp. Làm được điều này, bạn sẽ giảm thời gian bảo trì, tránh chạy lại vô ích và giữ quy trình ổn định hơn khi trang web thay đổi.
