Reporting a Thunderbird Performance Problem with Gecko Profiler Extension

This article will guide you in reporting a Thunderbird performance problem using the Gecko Profiler extension.  (Developers may instead wish to profile via the remote debugger.)

Setting up the Gecko Profiler extension

  1. Use Thunderbird 38 or older.
  2. Start Thunderbird and verify Thunderbird it is running the desired version by checking Help | About Thunderbird.
  3. Download this version of the Gecko Profiler extension.  (newer versions of profiler will not work with Thunderbird)
  4. Once downloaded, open Tools | Add-ons, and drag and drop the .xpi file on your add-ons tab. No need to restart Thunderbird.
  5. The profiler extension will show up in the bottom right of the status bar with two small panels labeled 'Disabled', and 'Dump Profile'.
  6. Remember to disable or uninstall the extension when not using it. Performance is affected while the extension is enabled and gathering data.

Using the profiler

  1. Click on 'Disabled' to switch the profiler into enabled mode. When "Enabled", the profiler is recording data.
  2. Reproduce the performance problem 5-15 seconds. But do not run longer, because the profile may be too big to upload to the server.
  3. Click on 'Dump Profile'.
  4.  A content tab like the screen below will show you profiling data gathered up to that point.
    profiler in Thunderbird
  5. Click on 'Enabled' to stop data gathering.   The label will change to Disabled.
  6. Click the 'Share' button in the bottom left.  This will upload the profile data and once completed will write out a link.
  7. Copy this URL to your clipboard by right clicking. Paste the profile URL in your bug bug report or email to the appropriate person. Give some context, with details about what you were doing to cause the performance problem. For example, scrolling the message list.

Document Tags and Contributors

 Contributors to this page: wsmwk
 Last updated by: wsmwk,