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がその瞬間に実行していたもののスナップショットです。これは開発者にとって最も役立ちますが、ダウンロードアドレス、Cookie、保存されたパスワードなど、DDMがメモリに保持していた情報の一部が含まれる可能性があります。クラッシュデータも添付するにチェックを入れた場合にのみ添付されます。

レポートの保存場所

DDM のデータフォルダ内:

  • crashes\: 各レポート (.txt) とそのクラッシュデータ (.dmp);
  • logs\: DDM のログ (mdm.log、古いものは mdm.1.log など、それぞれ 2 MB)。

DDM のデータフォルダは、Windows では %APPDATA%\dannexdownloadmanager、macOS では ~/Library/Application Support/dannexdownloadmanager、Linux では ~/.local/share/dannexdownloadmanager です。ポータブルモード では、プログラムの隣にある data フォルダです。

ログには DDM が行ったことが記録されるため、レポートは問題の原因となったものを示すことができます。より詳細なログを記録するには、環境変数 MDM_LOG=debug を設定して DDM を起動してください。

開発者向け

仕組み: DDM の 2 番目のコピーである モニター が、--crash-monitor とともに DDM の隣で起動します。クラッシュコードは crates/crash と crates/app/src/crash.rs にあります。

  • 問題の捕捉。 DDM がクラッシュ (Windows の例外、Linux のシグナル、macOS の Mach 例外) したり、パニックに陥ったり、フリーズしたりすると、モニターにダンプを要求します。フリーズとは、ウィンドウのフレームが 8 秒以上実行された状態を指し、スリープ時間を無視するウォッチドッグ スレッドによって監視されます。フレームの 2 つの部分を計測します。DDM が処理する部分 (受信コマンド、ダウンロードのクロック、キュー、スケジューラ。最小化時も実行されます) と描画部分です。フレーム間の待機時間は計測しません。ウォッチドッグは、その間にウィンドウ スレッドが取得したプロセッサ時間も計測し、その意味をレポートで示します。つまり、ずっと実行されていた (ループ)、ロックまたは I/O で待機していた (デッドロック)、あるいは通常のコードではほとんど実行されていなかった (コンピューターが DDM を実行するには忙しすぎるか、ディスクからの読み込みが遅い。DDM のバグである可能性は低い。これらは freeze while the computer was busy という 1 つのシグネチャを共有します) のいずれかです。ダンプが書き込まれる時点でウィンドウ スレッドがすでにイベント ループに戻っている場合、フリーズはスナップショットの前に終了していたため、そのスタックでは説明できません。これらのレポートはその旨を伝え、freeze over before the snapshot というシグネチャを共有します。macOS ではまだ計測していません。その後、モニターは minidumper と crash-handler を介して、外部からすべてのスレッドのミニダンプを書き込みます。クラッシュしたプロセスは自身のダンプを書き込むことはありません。これは Firefox、Crashpad、Sentry も同様です。
  • ダンプの読み取り。 モニターは Mozilla のrust-minidumpでダンプを読み取ります。リリース版の Breakpad シンボルが見つかった場合は、それを使用します。ソースからビルドした場合は、--features mdm-crash/native-symbolsを使ってビルドされていれば、隣にあるネイティブのデバッグ情報(.pdb、DWARF)も読み取れます。配布版アプリには、この数 MB のリーダーは含まれていません。レポートのシグネチャ(例: freeze in dannexdownloadmanager::winui::combo_edit)は、同じ問題のレポート間で変わらず、ウィンドウはそのシグネチャを使って既存の問題を検索します。
  • シンボル。 リリースビルドには行テーブル(debug = "line-tables-only")が含まれますが、デバッグ情報はダウンロードに含まれません。CIはデバッグ情報をDannexDownloadManager-<version>-symbols-<platform>.zip(tools/installer/symbols.py、Mozillaのdump_symsを使用)に変換し、リリース版の他のファイルとともに公開します。スタックにアドレスだけが表示されている場合、レポートウィンドウはそのバージョン用の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)を発生させ、各レポートのシグネチャを確認します。アプリで試すには、MDM_CRASH_TEST=1を指定してDDMを起動し、次にdannexdownloadmanager /show crash-test:freeze(デッドロック。ほかにspin、ウィンドウスレッドが12秒間ビジー状態になるもの、panic、crash、abort)を実行します。cargo test -p mdm-app --test freeze_report -- --ignoredは画面外にあるアプリのコピーでこの処理を行います。ウィンドウは表示されたまま最小化されます。

無料、オープンソース、広告なし、試用期間なし。

Dannex Download Managerをダウンロード