Nếu Dannex Download Manager đóng đột ngột hoặc ngừng phản hồi, cửa sổ báo cáo sự cố sẽ mở ra. Cửa sổ cho biết chuyện gì đã xảy ra, cho phép bạn đọc toàn bộ báo cáo và gửi báo cáo cho nhà phát triển trên GitHub. Mỗi báo cáo đều giúp khắc phục sự cố cho mọi người.

Những gì bạn sẽ thấy
- Dannex Download Manager đã đóng đột ngột: DDM bị lỗi hoặc gặp lỗi nội bộ và đóng lại.
- Dannex Download Manager đã ngừng phản hồi: cửa sổ không phản hồi trong 8 giây. DDM vẫn đang chạy nhưng bị treo. Kết thúc và khởi động lại DDM sẽ đóng bản DDM bị treo và khởi động một bản mới. Nếu DDM tự phản hồi lại, cửa sổ sẽ thông báo điều đó.
Trong cửa sổ:
- Bạn đang làm gì khi sự cố xảy ra? là mục không bắt buộc. Một vài từ, chẳng hạn như “Tôi đã mở Thêm URL”, sẽ giúp ích rất nhiều.
- Báo cáo hiển thị mọi nội dung sẽ được gửi. Bạn có thể đọc báo cáo trước khi gửi.
- Gửi trên GitHub mở biểu mẫu Báo cáo sự cố của GitHub trong trình duyệt của bạn, đã được điền sẵn, cùng với thư mục chứa báo cáo. Kéo tệp báo cáo vào biểu mẫu, kiểm tra và gửi. Bạn cần có tài khoản GitHub. Không có gì được gửi tự động.
- Nếu ai đó đã báo cáo vấn đề tương tự, cửa sổ sẽ thông báo điều đó (Đã báo cáo là vấn đề #…). Mở vấn đề đã báo cáo sẽ mở vấn đề đó và sao chép báo cáo vào khay nhớ tạm để bạn có thể thêm báo cáo dưới dạng bình luận.
Các nút khác dùng để sao chép báo cáo, mở thư mục chứa báo cáo hoặc khởi động lại DDM.
Nội dung báo cáo
- Chuyện gì đã xảy ra: lỗi và vị trí trong mã của DDM nơi lỗi xảy ra.
- Ngăn xếp: vị trí trong mã của DDM nơi chương trình bị lỗi hoặc treo, và những gì các phần khác của chương trình đang làm.
- Nhật ký gần đây của DDM: ví dụ: “lệnh AddUrl” hoặc “cửa sổ đã mở: add-url”.
- Hệ thống: phiên bản DDM và cách cài đặt, hệ điều hành và phiên bản, bộ xử lý, ngôn ngữ và giao diện, cùng số lượt tải xuống và hàng đợi. Báo cáo chỉ chứa các con số này.
Báo cáo không chứa:
- địa chỉ tải xuống hoặc tên tệp của bạn;
- tên người dùng của bạn, được thay bằng
~trong đường dẫn thư mục.
Nếu thông báo lỗi trích dẫn nội dung bạn đã nhập, nội dung đó sẽ có trong báo cáo. Vì vậy, hãy đọc báo cáo trước khi gửi.
Tệp dữ liệu sự cố (.dmp) là ảnh chụp trạng thái DDM tại thời điểm đó. Tệp này giúp ích nhiều nhất cho nhà phát triển, nhưng có thể chứa một phần dữ liệu DDM lưu trong bộ nhớ, chẳng hạn như địa chỉ tải xuống, cookie và mật khẩu đã lưu. Tệp chỉ được đính kèm khi bạn chọn Đính kèm cả dữ liệu sự cố.
Nơi lưu báo cáo
Trong thư mục dữ liệu của DDM:
crashes\: mỗi báo cáo (.txt) và dữ liệu sự cố tương ứng (.dmp);logs\: nhật ký của DDM (mdm.log, các tệp nhật ký cũ hơn có tênmdm.1.logvà tương tự, mỗi tệp 2 MB).
Thư mục dữ liệu của DDM là %APPDATA%\dannexdownloadmanager trên Windows, ~/Library/Application Support/dannexdownloadmanager trên macOS và ~/.local/share/dannexdownloadmanager trên Linux. Trong chế độ di động, thư mục này là thư mục data nằm cạnh chương trình.
Nhật ký ghi lại những gì DDM thực hiện, vì vậy báo cáo có thể cho biết nguyên nhân dẫn đến sự cố. Để ghi nhật ký chi tiết hơn, hãy khởi động DDM với biến môi trường MDM_LOG=debug.
Dành cho nhà phát triển
Cách hoạt động: một bản sao thứ hai của DDM, gọi là trình giám sát, khởi động bên cạnh DDM với --crash-monitor. Mã xử lý sự cố nằm trong crates/crash và crates/app/src/crash.rs.
- Bắt lỗi. Khi DDM gặp sự cố (ngoại lệ Windows, tín hiệu trên Linux, ngoại lệ Mach trên macOS), hoảng loạn hoặc bị treo, nó sẽ yêu cầu trình giám sát tạo một bản ghi. Treo là khi một khung cửa sổ chạy quá 8 giây, được một luồng giám sát phát hiện (luồng này bỏ qua thời gian ngủ). Nó tính thời gian cho cả hai phần của một khung: những gì DDM xử lý (các lệnh đến, đồng hồ tải xuống, hàng đợi và Bộ lập lịch), cũng chạy khi thu nhỏ, và phần vẽ; không bao giờ tính thời gian chờ giữa các khung. Luồng giám sát cũng đo lượng thời gian xử lý mà luồng cửa sổ nhận được trong khi đó, và báo cáo cho biết điều đó có nghĩa là gì: nó chạy liên tục (một vòng lặp), nó chờ trong một khóa hoặc trên I/O (tắc nghẽn), hoặc nó hầu như không chạy trong mã thông thường, điều này có nghĩa là máy tính quá bận để chạy DDM hoặc chậm tải nó từ đĩa, rất có thể không phải lỗi của DDM (những lỗi này chia sẻ một chữ ký,
freeze while the computer was busy). Khi luồng cửa sổ đã quay lại vòng lặp sự kiện vào thời điểm bản ghi được ghi, thì sự cố treo đã kết thúc trước khi chụp nhanh, vì vậy ngăn xếp của nó không thể giải thích được; những báo cáo đó nói như vậy và chia sẻ chữ kýfreeze over before the snapshot. macOS chưa đo lường điều này. Trình giám sát sau đó ghi một minidump của mọi luồng từ bên ngoài, thông quaminidumpervàcrash-handler. Một tiến trình bị lỗi không bao giờ tự ghi bản ghi của chính nó, đây cũng là cách Firefox, Crashpad và Sentry thực hiện. - Đọc tệp kết xuất. Trình giám sát đọc tệp kết xuất bằng
rust-minidumpcủa Mozilla. Trình này sử dụng các ký hiệu Breakpad của bản phát hành nếu tìm thấy. Bản dựng từ mã nguồn cũng có thể đọc thông tin gỡ lỗi gốc nằm bên cạnh (.pdb, DWARF) nếu được dựng với--features mdm-crash/native-symbols; ứng dụng được phát hành không có trình đọc này để tiết kiệm vài MB. Chữ ký của báo cáo (ví dụfreeze in dannexdownloadmanager::winui::combo_edit) không đổi giữa các báo cáo về cùng một vấn đề, và cửa sổ sẽ tìm kiếm các vấn đề hiện có theo chữ ký đó. - Ký hiệu. Các bản dựng phát hành giữ lại bảng dòng (
debug = "line-tables-only"), nhưng không có bản tải xuống nào kèm thông tin gỡ lỗi. CI chuyển thông tin này thànhDannexDownloadManager-<version>-symbols-<platform>.zip(tools/installer/symbols.py, sử dụngdump_symscủa Mozilla) và đăng cùng các tệp khác của bản phát hành. Cửa sổ báo cáo sẽ tải tệp zip dành cho phiên bản đang dùng khi ngăn xếp chỉ hiển thị các địa chỉ. - Một
.dmptừ một vấn đề:
cargo run -p mdm-crash --bin mdm-symbolicate -- crash.dmp DannexDownloadManager-<version>-symbols-windows-x64.zip
- Kiểm tra.
cargo test -p mdm-crashchạy thử tình huống treo, lỗi nghiêm trọng và sự cố thực tế (examples/crashy.rs) rồi kiểm tra chữ ký của từng báo cáo. Để thử trong ứng dụng, hãy khởi động DDM vớiMDM_CRASH_TEST=1, sau đó chạydannexdownloadmanager /show crash-test:freeze(gây deadlock; hoặcspin, chạy luồng cửa sổ bận trong 12 giây,panic,crash,abort).cargo test -p mdm-app --test freeze_report -- --ignoredthực hiện việc này trong một bản sao của ứng dụng nằm ngoài màn hình; cửa sổ vẫn hiển thị nhưng được thu nhỏ.
Miễn phí, mã nguồn mở, không quảng cáo, không dùng thử.
Tải xuống Dannex Download Manager