Learn how to generate a performance profile file and capture calculation analyzer data to debug potential performance issues.
Running into doc performance issues, but haven't been able to resolve them yourself using our performance improvement resources? The Coda team may ask you to record and send a performance profile so that we can better understand and help you troubleshoot the issues. Check out the article below for more details
Within this article, you'll find...
What is a performance profile?
If you've already tried diagnosing and resolving your performance issue yourself (using our resources), you may now be in touch with the Coda team for further assistance. The team may then ask you to record a performance profile of Coda running in your browser. You can share this performance profile with the Coda team, in order to give them a better understanding of the doc performance issues you're encountering. This profile can help the team identify the root of the issue, so we can then work on a resolution.
Record a performance profile for general troubleshooting
If you're asked to create a performance profile for more general or unknown performance issues, you can follow the steps in this section:
In the Chrome browser, open the Coda doc that is experiencing performance issues.
Click on the vertical three-dot menu in the upper right corner of your Chrome browser.
-
Hover over More tools, then select Developer tools.
Click into the Performance tab of the developer tools.
-
Click the round Record button (this can be found in the center of the page or in the upper left corner) to begin the recording.
While the recording continues to run, hop back into your Coda doc, and reproduce the performance issue that you've been noticing.
Once the issue has been reproduced, stop the recording within the developer tools.
Save the profile using the down arrow button in the top left area of dev tools.
Send the performance profile recording to Coda.
Record a performance profile for calculation issues
If we've determined that your performance issues are likely based on calculation slowness, we may ask you to create a calculation-focused profile. This involves using both the Chrome dev tools and Coda's calculation analyzer. To create this type of profile, just follow these steps:
In the Chrome browser, open the Coda doc that is experiencing performance issues.
Click on the vertical three-dot menu in the upper right corner of your Chrome browser.
-
Hover over More tools, then select Developer tools.
Click into the Performance tab of the developer tools.
-
Click the round Record button (this can be found in the center of the page or in the upper left corner) to begin the recording.
For additional instruction on recording performance profiles in Chrome, check out their documentation.
While the recording continues to run, hop back into your Coda doc, and select the gear icon in the upper right corner.
Select Doc map from the options.
Click on the vertical three-dot menu in the upper right corner of the doc map page, then select Debug calculations.
-
This will open the calculation analyzer. Click the Start button to begin measuring.
Reproduce the performance issue that you've been noticing while the calculation analyzer runs.
Once the issue has been reproduced, click Stop in the calculation analyzer.
Take screenshots of the data shown in Coda's calculation analyzer, and save somewhere you can easily find them later.
Finally, stop the recording within the developer tools. Save the profile using the down arrow button in the top left area of dev tools.
Send the profile recording and the screenshots of the calculation analyzer to Coda.
That's it. Thank you for helping us troubleshoot and resolve your issue!
ℹ️ Note that other browsers offer similar tools for performance profile generation. If you prefer not to use Chrome, you can check out any of the resources below to guide you through the process.