Dannex Download Manager
  1. Главная
  2. Справка
  3. Отчеты о сбоях

Отчеты о сбоях

Если Dannex Download Manager неожиданно закрывается или перестает отвечать, открывается окно отчета о сбое. Оно показывает, что произошло, позволяет прочитать весь отчет и отправить его разработчикам на GitHub. Каждый отчет помогает исправить проблему для всех.

Окно отчета о сбое после того, как DDM перестал отвечать

Что вы видите

  • Dannex Download Manager неожиданно закрылся: DDM аварийно завершил работу или столкнулся с внутренней ошибкой и закрылся.
  • Dannex Download Manager перестал отвечать: его окно не отвечало в течение 8 секунд. DDM все еще работает, но завис. Завершить и перезапустить DDM закрывает зависшую копию и запускает новую. Если DDM снова отвечает сам по себе, окно сообщает об этом.

В окне:

  1. Что вы делали, когда это произошло? — необязательное поле. Несколько слов, например «Я открыл Добавить URL», очень помогают.
  2. Отчет показывает все, что будет отправлено. Прочитайте его сначала, если хотите.
  3. Отправить на GitHub открывает в вашем браузере форму Отчет о сбое на GitHub, уже заполненную, а также папку, содержащую отчет. Перетащите файл отчета в форму, проверьте его и отправьте. Вам потребуется учетная запись GitHub. Ничего не отправляется автоматически.
  4. Если кто-то уже сообщил о той же проблеме, окно сообщает об этом (Уже сообщено как проблема #…). Открыть сообщенную проблему открывает ее и помещает ваш отчет в буфер обмена, чтобы вы могли добавить его в качестве комментария.

Другие кнопки копируют отчет, открывают его папку или снова запускают DDM.

Что содержит отчет

  • Что произошло: ошибка и место в коде DDM, где она произошла.
  • Стек: место в коде DDM, где произошел сбой или зависание, и что делали все остальные его части.
  • Последний журнал DDM: например, «команда AddUrl» или «окно открыто: add-url».
  • Система: версия DDM и способ его установки, ваша операционная система и ее версия, процессор, язык и тема, а также количество загрузок и очередей. Это только счетчики.

Он не содержит:

  • ваши адреса загрузки или имена файлов;
  • ваше имя пользователя, которое отображается как ~ в путях к папкам.

Если в сообщении об ошибке цитируется что-то, что вы ввели, этот текст содержится в отчете, поэтому прочитайте его перед отправкой.

Файл данных о сбое (.dmp) — это снимок состояния DDM в момент сбоя. Он очень помогает разработчикам, но может содержать фрагменты данных, которые DDM хранил в памяти, например, адреса загрузок, файлы cookie и сохраненные пароли. Он прикрепляется только если вы отметите Также прикрепить данные о сбое.

Где хранятся отчеты

В папке данных DDM:

  • crashes\: каждый отчет (.txt) и его данные о сбое (.dmp);
  • logs\: журнал DDM (mdm.log, с более старыми как mdm.1.log и так далее, по 2 МБ каждый).

Папка данных DDM находится в %APPDATA%\dannexdownloadmanager на Windows, ~/Library/Application Support/dannexdownloadmanager на macOS и ~/.local/share/dannexdownloadmanager на Linux. В портативном режиме это папка data рядом с программой.

Журнал записывает действия DDM, поэтому отчет может показать, что привело к проблеме. Чтобы записывать больше деталей, запустите DDM с переменной среды MDM_LOG=debug.

Для разработчиков

Как это работает: вторая копия DDM, монитор, запускается рядом с ней с --crash-monitor. Код сбоя находится в crates/crash и crates/app/src/crash.rs.

  • Выявление проблем. Когда DDM аварийно завершает работу (исключение Windows, сигнал в Linux, исключение Mach в macOS), паникует или зависает, он запрашивает у монитора дамп. Зависание — это кадр окна, выполняющийся более 8 секунд, что отслеживается потоком-сторожем, который игнорирует время простоя. Он измеряет обе части кадра: то, что обрабатывает DDM (входящие команды, часы загрузок, очереди и Планировщик), что также работает в свернутом режиме, и отрисовку; никогда не измеряется ожидание между кадрами. Сторожевой поток также измеряет, сколько процессорного времени получил поток окна за это время, и отчет указывает, что это означает: он работал все время (цикл), он ждал в блокировке или ввода-вывода (взаимная блокировка), или он почти не работал в обычном коде, что означает, что компьютер слишком занят для запуска DDM или медленно загружает его с диска, что, скорее всего, не является ошибкой DDM (они имеют одну сигнатуру, freeze while the computer was busy). Если поток окна уже вернулся в цикл событий к моменту записи дампа, зависание закончилось до снимка, поэтому его стек не может объяснить это; такие отчеты указывают на это и имеют сигнатуру freeze over before the snapshot. macOS пока не измеряет это. Затем монитор записывает минидамп каждого потока извне, через minidumper и crash-handler. Аварийно завершившийся процесс никогда не записывает свой собственный дамп, так же поступают Firefox, Crashpad и Sentry.
  • Чтение дампа. Монитор читает дамп с помощью rust-minidump от Mozilla. Он использует символы Breakpad из релиза, если они найдены. Сборка из исходного кода также может читать нативную отладочную информацию (ее .pdb, DWARF), если она собрана с --features mdm-crash/native-symbols; поставляемое приложение не содержит этого читателя, что экономит несколько МБ. Подпись отчета (например, freeze in dannexdownloadmanager::winui::combo_edit) остается одинаковой для всех отчетов об одной и той же проблеме, и окно ищет по ней существующие проблемы.
  • Символы. Релизные сборки сохраняют таблицы строк (debug = "line-tables-only"), но ни одна загрузка не включает отладочную информацию. CI преобразует ее в DannexDownloadManager-<version>-symbols-<platform>.zip (tools/installer/symbols.py, используя dump_syms от Mozilla), публикуемые вместе с другими файлами релиза. Окно отчета получает zip-архив для своей версии, когда стек показывает «голые» адреса.
  • .dmp из проблемы:

cargo run -p mdm-crash --bin mdm-symbolicate -- crash.dmp DannexDownloadManager-<version>-symbols-windows-x64.zip

  • Тестирование. cargo test -p mdm-crash запускает реальное зависание, панику и сбой (examples/crashy.rs) и проверяет сигнатуру каждого отчета. Чтобы попробовать это в приложении, запустите DDM с MDM_CRASH_TEST=1, затем запустите dannexdownloadmanager /show crash-test:freeze (взаимная блокировка; или spin, 12 секунд занятого потока окна, panic, crash, abort). cargo test -p mdm-app --test freeze_report -- --ignored делает это в копии приложения вне экранов, его окно видно и свернуто.

Бесплатно, с открытым исходным кодом, без рекламы, без пробного периода.

Загрузить Dannex Download Manager