Mozilla Crash Reporter: Difference between revisions

From MozillaZine Knowledge Base
Jump to navigationJump to search
Line 28: Line 28:
==Viewing crash reports==
==Viewing crash reports==
=== Using the application to view crash reports ===
=== Using the application to view crash reports ===
The '''about:crashes'''  Submitted Crash Reports page is used to view submitted crash reports. It is available in the following ways:
If you can start the application, use the '''about:crashes'''  Submitted Crash Reports page is used to view submitted crash reports. If you can't start the application or don't find the crash report using this method, see [[#Using the file system to view crash reports|Using the file system to view crash reports]]
* In Firefox or SeaMonkey, type '''about:crashes''' in the Location Bar (address bar). 
* In all products, via extension:
* In all products, via extension:
** Crash Report Helper extension: [https://addons.mozilla.org/firefox/addon/11217 for Firefox], [https://addons.mozilla.org/thunderbird/addon/11217 for Thunderbird], for [https://addons.mozilla.org/seamonkey/addon/11217 for SeaMonkey]
** Crash Report Helper extension: [https://addons.mozilla.org/firefox/addon/11217 for Firefox], [https://addons.mozilla.org/thunderbird/addon/11217 for Thunderbird], for [https://addons.mozilla.org/seamonkey/addon/11217 for SeaMonkey]

Revision as of 16:49, 20 February 2010

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.

Mozilla Crash Reporter

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

Using the application to view crash reports

If you can start the application, use the about:crashes Submitted Crash Reports page is used to view submitted crash reports. If you can't start the application or don't find the crash report using this method, see Using the file system to view crash reports

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.

Using the file system to view crash reports

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