mozilla

Revision 442875 of Crash Reporting Guide for Firefox OS Partners

  • Revision slug: Crash_Reporting_Guide_for_Firefox_OS_Partners
  • Revision title: Crash Reporting Guide for Firefox OS Partners
  • Revision id: 442875
  • Created:
  • Creator: BenjaminSmedberg
  • Is current revision? No
  • Comment The cache is out of date. Invalidating.

Revision Content

Mozilla has a world-class system for collecting, analyzing, and fixing crashes and other stability issues such as hangs. Firefox OS partners need to work with Mozilla to correctly enable crash reporting and upload symbols.

For general information about crash reporting, how it works, and how data is used, see the Crash reporting article.

Enable Firefox OS Crash Reporting

It is essential that any device with Firefox branding have crash reporting enabled. This must be enabled by including the following line in the `mozconfig` file used to build the release build:

export MOZILLA_OFFICIAL=1

Crash reports contain key/value metadata and a minidump file. This file contains only the stack memory and memory mapping information, and does not contain any proprietary information such as symbols. Non-private data from crash reports are processed and displayed on crash-stats.mozilla.org. Because the actual minidump files may contain personal data if it is stored on the binary stack, these files remain private and are available only to Mozilla employees and certain partners who have a non-disclosure and privacy agreement for user data.

Upload Symbols to Mozilla

Symbol files allow Mozilla to process crash report minidumps. The symbol files are text files which are extracted from the binary debug information. For more information about the format of symbols files, see the breakpad documentation.

The symbols files for open-source code including all of gecko files must be available for crash processing. Partners should request an SSH account to upload symbols. See the symbol upload instructions for specific details. Symbols from multiple builds will not overwrite eachother on the server, because each symbol file is keyed against a unique debug identifier.

Firefox OS partners may also have binaries such as drivers which are not open-source. For Firefox OS partners as well as other partners such as plugin and extension vendors, Mozilla has a tool for encrypting symbol files so that they can still be used to produce backtraces and correlate crashes, without revealing the function or file names. In a normal Firefox OS build, the affected binaries are built in the vendor/qcom/proprietary subtree of the build. Partners should take care that binaries produced from within this subtree, as well as other proprietary binaries, are encrypted before being uploaded.

Revision Source

<p>Mozilla has a world-class system for collecting, analyzing, and fixing crashes and other stability issues such as hangs. Firefox OS partners need to work with Mozilla to correctly enable crash reporting and upload symbols.</p>
<p>For general information about crash reporting, how it works, and how data is used, see the <a href="/en-US/docs/Crash_reporting" title="/en-US/docs/Crash_reporting">Crash reporting </a>article.</p>
<h2 id="Enable_Firefox_OS_Crash_Reporting">Enable Firefox OS Crash Reporting</h2>
<p>It is essential that any device with Firefox branding have crash reporting enabled. This must be enabled by including the following line in the `mozconfig` file used to build the release build:</p>
<pre>
export MOZILLA_OFFICIAL=1</pre>
<p>Crash reports contain key/value metadata and a minidump file. This file contains only the stack memory and memory mapping information, and does not contain any proprietary information such as symbols. Non-private data from crash reports are processed and displayed on crash-stats.mozilla.org. Because the actual minidump files may contain personal data if it is stored on the binary stack, these files remain private and are available only to Mozilla employees and certain partners who have a non-disclosure and privacy agreement for user data.</p>
<h2 id="Upload_Symbols_to_Mozilla">Upload Symbols to Mozilla</h2>
<p>Symbol files allow Mozilla to process crash report minidumps. The symbol files are text files which are extracted from the binary debug information. For more information about the format of symbols files, see the <a href="http://code.google.com/p/google-breakpad/wiki/SymbolFiles" title="http://code.google.com/p/google-breakpad/wiki/SymbolFiles">breakpad documentation</a>.</p>
<p>The symbols files for open-source code including all of gecko files must be available for crash processing. Partners should request an SSH account to upload symbols. See the <a href="/en-US/docs/Uploading_symbols_to_Mozillas_symbol_server" title="/en-US/docs/Uploading_symbols_to_Mozillas_symbol_server">symbol upload instructions</a> for specific details. Symbols from multiple builds will not overwrite eachother on the server, because each symbol file is keyed against a unique debug identifier.</p>
<p>Firefox OS partners may also have binaries such as drivers which are not open-source. For Firefox OS partners as well as other partners such as plugin and extension vendors, Mozilla has a <a href="https://github.com/bsmedberg/breakpad-symbol-encryption" title="https://github.com/bsmedberg/breakpad-symbol-encryption">tool for encrypting symbol files</a> so that they can still be used to produce backtraces and correlate crashes, without revealing the function or file names. In a normal Firefox OS build, the affected binaries are built in the vendor/qcom/proprietary subtree of the build. Partners should take care that binaries produced from within this subtree, as well as other proprietary binaries, are encrypted before being uploaded.</p>
Revert to this revision