MozillaZine

Mozilla Crash Reporter

From MozillaZine Knowledge Base

(Difference between revisions)
Revision as of 20:53, 20 December 2009
Wsm (Talk | contribs)
(Viewing crash reports)
<-- Previous diff
Revision as of 16:11, 26 December 2009
Gc (Talk | contribs)
(fix url format in pre)
Next diff -->
Line 42: Line 42:
Each submitted crash report is identified as a text file, located in the "Crash Reports" folder within the "submitted" subfolder (see [[#Location of crash reports|Location of crash reports]], above). Files are named '''bp-GUID''' where GUID is a unique identifier and functions as the report's ID. You can open the text file for a given crash report to view its contents. Each submitted crash report is identified as a text file, located in the "Crash Reports" folder within the "submitted" subfolder (see [[#Location of crash reports|Location of crash reports]], above). Files are named '''bp-GUID''' where GUID is a unique identifier and functions as the report's ID. You can open the text file for a given crash report to view its contents.
-For example, a file "bp-3c2a9b80-a143-11dd-8241-001cc4e2bf68.txt" created 10-28-2008 may contain the following text:+For example, in older version crash reports, a file "bp-3c2a9b80-a143-11dd-8241-001cc4e2bf68.txt" created 10-28-2008 may contain the following text:
<pre> <pre>
Crash ID: bp-3c2a9b80-a143-11dd-8241-001cc4e2bf68 Crash ID: bp-3c2a9b80-a143-11dd-8241-001cc4e2bf68
You can view details of this crash at You can view details of this crash at
-[http://crash-stats.mozilla.com/report/index/031b02bb-26b6-4168-ac0e-2de492090531 http://crash-stats.mozilla.com/report/index/3c2a9b80-a143-11dd-8241-001cc4e2bf68?date=2008-10-23-20]</pre>+http://crash-stats.mozilla.com/report/index/3c2a9b80-a143-11dd-8241-001cc4e2bf68</pre>
Text files for submitted crash reports (at time of writing) may now include only the Crash ID, without a URL. For example, a file "bp-031b02bb-26b6-4168-ac0e-2de492090531.txt" created 5-31-2009 may contain only the following text: Text files for submitted crash reports (at time of writing) may now include only the Crash ID, without a URL. For example, a file "bp-031b02bb-26b6-4168-ac0e-2de492090531.txt" created 5-31-2009 may contain only the following text:

Revision as of 16:11, 26 December 2009

This article describes the Mozilla crash reporting system used in Firefox 3, SeaMonkey 2 and Thunderbird 3.

Firefox 3, Thunderbird 3 and SeaMonkey 2 have a new, open source crash reporting system. The new reporting system incorporates the Breakpad crash reporting tool developed by Google engineers and the Socorro web server for processing crash report data, using a new user interface called the Mozilla Crash Reporter, also known as "Breakpad". This replaces Quality Feedback Agent (aka "Talkback") of previous Mozilla applications.

Contents

Mozilla Crash Reporter

Image:MozCrashReporter.png

Crash Reporter is a core part of Firefox 3, Thunderbird 3, and SeaMonkey 2 program installation. Unlike the "Talkback" global extension, it cannot be deselected during custom Windows install [1]. The crash reporter tool, "crashreporter.exe" on Windows, "crashreporter.app" on Mac OS and "crashreporter" on Linux, is located in the program's installation directory.

When your Mozilla application crashes, it saves a binary "dump" file and you will see a notification, similar to the one shown here. This Crash Reporter allows you to submit a crash data report to a web server. The Socorro-based web server at crash-stats.mozilla.com is used to search and view crash report data.

Mozilla Crash Reporter is enabled by default and there is no user interface to disable it. Advanced users who prefer the standard application error notifications (e.g., the Windows error dialog "<application> has encountered a problem and needs to close" and Event Viewer record) can disable the Mozilla Crash Reporter by setting the environment variable MOZ_CRASHREPORTER_DISABLE to 1. [2]. You can also disable the Mozilla Crash Reporter by opening the "application.ini" file in the installation directory, finding the entry [Crash Reporter] Enabled=1 and changing the 1 to 0 (you will need to repeat the edit if an application update replaces the file).

Why didn't Breakpad capture my crash?

In some installations with a problematic plug-in or an old operating system library, a Mozilla application may crash but no "dump" file is captured, so the crash reporter is unable to report the crash. Also, crash reporter does not work for applications built for and run in 64 bit mode. See Alternative ways to get a stacktrace, and fixes or workarounds listed at Related bug reports that may enable it to capture the dump file in the future.

Location of crash reports

Crash reports are stored in the the following locations, using Firefox as an example:

  • Windows 2000/XP: C:\Documents and Settings\<username>\Application Data\Mozilla\Firefox\Crash Reports\
  • Windows Vista: C:\Users\<username>\AppData\Roaming\Mozilla\Firefox\Crash Reports\
  • Mac OS: /Users/<username>/Library/Application Support/Firefox/Crash Reports/
  • Linux: /home/<username>/.mozilla/firefox/Crash Reports/

Note: On Windows and Linux, these locations are hidden by default so you will need to show hidden files and folders.

The "Crash Reports" directory has two folders: "pending" and "submitted", respectively for crash reports that haven't been submitted to the server yet and for reports that have already been sent.

Viewing crash reports

The about:crashes Submitted Crash Reports page is used to view submitted crash reports. It is available in the following ways:

  • In Firefox or SeaMonkey, type about:crashes in the Location Bar (address bar).
  • In all products, via extension:
  • In Thunderbird, use an extension, or one of the following:
    • In the Code: line of the Error Console, type openDialog("about:crashes"); and, to the immediate right, click Evaluate.
    • In "Tools -> Options -> General -> Location", type about:crashes and click OK. Then do Go, Mail Start Page

Click on a Report ID to view the crash data stored and analyzed at mozilla crash reports, aka crash-stats. crash-stats will show reported bug numbers if any matches the crash signature. If crash-stats does not show a bug number, please file a bug report. In the bug, include the crash report id, and in the bug summary title provide the crash signature formatted as "crash [@ <signature>]", where <signature> is copied from crash-stats. Helpful, but not imperative, please include clear steps to reproduce, and whether you can reproduce in Safe_mode.

You can also use the files stored on your computer when a crash report is submitted, to locate and view the report. This can be useful if your Mozilla application will not open or crashes at startup and you cannot access the Submitted Crash Reports list.

Each submitted crash report is identified as a text file, located in the "Crash Reports" folder within the "submitted" subfolder (see Location of crash reports, above). Files are named bp-GUID where GUID is a unique identifier and functions as the report's ID. You can open the text file for a given crash report to view its contents.

For example, in older version crash reports, a file "bp-3c2a9b80-a143-11dd-8241-001cc4e2bf68.txt" created 10-28-2008 may contain the following text:

Crash ID: bp-3c2a9b80-a143-11dd-8241-001cc4e2bf68
You can view details of this crash at 
http://crash-stats.mozilla.com/report/index/3c2a9b80-a143-11dd-8241-001cc4e2bf68

Text files for submitted crash reports (at time of writing) may now include only the Crash ID, without a URL. For example, a file "bp-031b02bb-26b6-4168-ac0e-2de492090531.txt" created 5-31-2009 may contain only the following text:

Crash ID: bp-031b02bb-26b6-4168-ac0e-2de492090531

Append the GUID portion of the Crash ID to the Breakpad report URL (currently http://crash-stats.mozilla.com/report/index/) and go to that URL to view the crash report (e.g., http://crash-stats.mozilla.com/report/index/031b02bb-26b6-4168-ac0e-2de492090531).

Referencing crash reports in Bugzilla

Comments in Bugzilla should reference crash reports using the Crash ID, bp-GUID, including the "bp-" prefix before the GUID; for example, bp-031b02bb-26b6-4168-ac0e-2de492090531 (see above). Crash reports referenced in this way are linked by Bugzilla to the correct report at http://crash-stats.mozilla.com/

See also

External links

Related bug reports