Trình tạo báo cáo lỗi

Biến bản ghi màn hình thành báo cáo có thể xử lý được

Tải bản ghi màn hình về lỗi lên. Phát video, và mỗi khi có điều gì quan trọng xảy ra, hãy đánh dấu lại. Mốc thời gian sẽ được ghi lại, một khung hình sẽ được trích xuất từ video tại thời điểm đó, và bước thực hiện sẽ được đưa vào danh sách đánh số.

Viết phần tóm tắt, những gì bạn mong đợi và những gì thực sự đã xảy ra, sau đó sao chép toàn bộ nội dung dưới dạng Markdown cho GitHub, Jira markup, hoặc văn bản thuần. Thông tin chi tiết về trình duyệt và màn hình đã được điền sẵn.

Bản ghi không bao giờ rời khỏi máy của bạn. Bản ghi được phát từ một tệp cục bộ và các khung hình được trích xuất ngay trên thiết bị của bạn, điều này rất quan trọng khi lỗi nằm trong một bản dựng chưa phát hành hoặc tài khoản của khách hàng.

Tại sao điều này không sử dụng AI để viết báo cáo

Một mô hình xem bản ghi màn hình có thể mô tả những gì nó thấy. Nó không thể biết những gì bạn mong đợi thấy, và đó là một nửa của báo cáo lỗi quyết định liệu ai đó có thể hành động dựa trên nó hay không.

“Nhấn Xác nhận, bảng hóa đơn trống” là một quan sát. Liệu đó có phải là một lỗi hay không hoàn toàn phụ thuộc vào những gì đáng lẽ phải xuất hiện ở đó, và người duy nhất biết điều đó là bạn. Một công cụ tạo ra hành vi mong đợi từ một video đang đoán và trình bày sự đoán đó như một phát hiện, điều này tồi tệ hơn việc để trống trường, bởi vì một kỳ vọng sai có vẻ hợp lý sẽ đưa nhà phát triển đi sai hướng.

Vì vậy, sự phân chia ở đây là có chủ ý. Công cụ thực hiện công việc cơ học mà nó có thể làm một cách chính xác: dấu thời gian, khung hình, môi trường, định dạng, đánh số. Bạn cung cấp sự đánh giá. Điều đó mất khoảng một phút và kết quả là một báo cáo mà không ai phải quay lại hỏi bạn.

Ba Điều Báo Cáo Thường Bỏ Sót

Sau khi đọc rất nhiều báo cáo lỗi sơ sài, những thiếu sót tương tự lại tái diễn, và cả ba đều mang tính cơ học chứ không khó.

Dấu thời gian. Một báo cáo nói “xem video đính kèm” khiến người đọc phải xem bốn phút để tìm ra khoảnh khắc. Một bước nói rằng nó xảy ra lúc 1:12 thì không.

Môi trường. Trình duyệt, hệ điều hành, kích thước màn hình. Ai cũng biết phải bao gồm nó nhưng hầu như không ai làm, bởi vì điều đó có nghĩa là mở một bảng cài đặt trong khi bạn đang suy nghĩ. Nó được đọc từ trình duyệt của bạn ở đây và nằm trong báo cáo đã được điền sẵn, và bạn có thể sửa lại.

Ảnh tĩnh. Một khung hình tại thời điểm xảy ra lỗi là thứ được quét trong danh sách hai mươi vấn đề. Việc trích xuất khung hình từ video thủ công đủ tẻ nhạt đến mức mọi người bỏ qua, vì vậy nó xảy ra tự động ở mỗi bước bạn đánh dấu.

Những Gì Được Ghi Lại, Chính Xác

Mỗi bước được đánh dấu ghi lại thời gian phát lại chính xác và một khung hình JPEG từ video tại thời điểm đó, được thu nhỏ để giữ cho báo cáo nhẹ. Bạn có thể tải xuống các khung hình để đính kèm vào vấn đề.

Môi trường đến từ trình duyệt: tên và phiên bản của nó, hệ điều hành, kích thước màn hình với tỷ lệ pixel của nó, và kích thước khung nhìn. Các trình duyệt hiện báo cáo ít thông tin về bản thân hơn trước đây, vì vậy một số thông tin đó có thể trở lại không xác định, và mỗi trường đều có thể chỉnh sửa chứ không bị khóa.

Không có gì được suy ra từ các pixel. Công cụ không cố gắng đọc văn bản lỗi trên màn hình hoặc đoán phần tử nào bạn đã nhấp, bởi vì làm điều đó không đáng tin cậy còn tệ hơn là không làm.

Cấu Trúc Nó Điền Vào

Đầu ra tuân theo hình dạng mà một báo cáo lỗi đã được định hình, bởi vì các công cụ theo dõi và những người đọc chúng đều mong đợi điều đó. Nếu bạn đang tìm kiếm một mẫu báo cáo lỗi, đây là một mẫu đã được điền sẵn chứ không phải mẫu bạn dán vào rồi nhìn chằm chằm.

Tóm tắt trước tiên, trong một dòng duy nhất, bởi vì dòng đó là thứ mà ai đó quét qua trong danh sách ba mươi vấn đề và nó quyết định xem báo cáo của bạn có được mở hôm nay hay không.

Sau đó là các bước được đánh số với mã thời gian trên mỗi bước, hành vi mong đợi, hành vi thực tế và môi trường. Thứ tự đó không phải là trang trí. Người đọc kiểm tra các bước để xem liệu nó có thể tái tạo được không, cặp mong đợi và thực tế để xem liệu đó có thực sự là một lỗi không, và môi trường để xem liệu nó có phải là của họ không. Ẩn bất kỳ thông tin nào trong số đó sẽ tốn một chu trình kiểm tra.

Điều mà một mẫu trống không thể làm là tự điền vào, đây là phần khiến mọi người bỏ qua nó. Ở đây, các bước, mã thời gian, khung hình và môi trường đã được điền sẵn, và bạn viết ba trường mà một công cụ thực sự không thể biết.

Trước khi ghi màn hình

Chất lượng của báo cáo phụ thuộc hoàn toàn vào bản ghi, và hai thói quen sau sẽ tạo nên sự khác biệt.

Bắt đầu từ một trạng thái xác định. Bản ghi bắt đầu ở giữa phiên làm việc sẽ khiến người đọc phải đoán những gì đã diễn ra trước đó, khiến các bước không còn khả năng tái hiện. Hãy bắt đầu từ màn hình đăng nhập, một trang mới tải lại, hoặc một điểm xuất phát đã được mô tả rõ ràng.

Dọn dẹp màn hình khỏi bất kỳ thông tin nào không nên để lộ. Token trên thanh URL, tên khách hàng, email không liên quan ở thẻ khác, khóa API trong bảng devtools. Một báo cáo lỗi có thể được chuyển tiếp, dán vào tin nhắn trò chuyện và được đọc bởi những người bên ngoài nhóm, và bản ghi màn hình sẽ ghi lại mọi thứ xuất hiện trên màn hình lúc đó. Công cụ này không bao giờ tải video lên máy chủ, nhưng báo cáo và các khung hình sẽ đi đến bất cứ nơi nào bạn gửi chúng.

Những điều công cụ không làm

Công cụ không tự động gửi lỗi (file issue). Không có kết nối tới GitHub, Jira hay bất kỳ nền tảng nào khác; bạn tự sao chép báo cáo và dán vào nơi cần thiết, điều này cũng đồng nghĩa bạn có thể xem lại trước khi bất kỳ ai khác nhìn thấy.

Công cụ không thu thập log, yêu cầu mạng hay dữ liệu xuất ra console. Những thông tin đó nằm trong công cụ dành cho nhà phát triển của bạn và cực kỳ quan trọng đối với một số lỗi. Hãy đính kèm chúng qua bất kỳ phương thức bảo mật nào mà nhóm bạn đang sử dụng thay vì quay phim lại màn hình console.

Và công cụ không thực hiện chẩn đoán. Nó sẽ không cho bạn biết nguyên nhân, thành phần nào bị lỗi, hay liệu lỗi này có trùng lặp với một sự cố đã có từ trước hay không. Nhiệm vụ duy nhất của nó là chuẩn hóa các bằng chứng thành một cấu trúc mà người khác có thể bắt tay vào xử lý.

Ghi lại lỗi ngay từ đầu

Nếu bạn vẫn cần ghi lại sự cố, trình ghi màn hình sẽ ghi lại một thẻ, một cửa sổ hoặc toàn bộ màn hình ngay trên trình duyệt. Đối với lỗi cần thuyết minh trong khi tái hiện, hãy ghi âm kèm theo để lời giải thích luôn đi liền với bằng chứng.

Hai công cụ hữu ích khác bạn nên biết. Nếu bạn muốn các hình ảnh riêng lẻ thay vì một báo cáo, trình trích xuất khung hình video sẽ trích xuất các khung hình theo khoảng thời gian định sẵn. Và nếu bản ghi dài và bạn muốn chuyển phần thuyết minh bằng giọng nói thành văn bản, trình tạo bản chép lời sẽ biến nội dung thuyết minh thành văn bản có thể tìm kiếm được.

Đặt câu hỏi về lỗi từ bản ghi

Tính năng kiểm tra trên trang này chạy trực tiếp trên thiết bị của bạn và không cần tài khoản. Để nhận câu trả lời về những gì đã được nói hoặc hiển thị trong bản ghi, hãy tải video lên ScreenApp. Nhấp vào một câu hỏi để mở ScreenApp với câu hỏi đã sẵn sàng.

Trong ScreenApp, nhấp vào một khoảnh khắc trong bản ghi sẽ đưa trình phát đến điểm đó trong bản ghi, nhờ đó bạn có thể đối chiếu bất kỳ câu trả lời nào với bản ghi.

Vai trò của từng gói ở đây

Công cụ trên trang này hoàn toàn miễn phí và sẽ luôn miễn phí. Tài khoản chỉ dành cho bước trước đó hoặc bước sau đó.