Runtime performance is how your page performs when it is running, as opposed to loading. Thistutorial teaches you how to use the Chrome DevTools Performance panel to analyze runtimeperformance. In terms of the RAIL model, the skills you learn in this tutorial are useful foranalyzing the Response, Animation, and Idle phases of your page.
Get started
In this tutorial, you open DevTools on a live page and use the Performance panel to find aperformance bottleneck on the page.
- Open Google Chrome in Incognito Mode. Incognito Mode ensures that Chrome runs in a cleanstate. For example, if you have a lot of extensions installed, those extensions might createnoise in your performance measurements.
Load the following page in your Incognito window. This is the demo that you're going to profile.The page shows a bunch of little blue squares moving up and down.
https://googlechrome.github.io/devtools-samples/jank/
Press Command+Option+I (Mac) or Control+Shift+I (Windows, Linux) to open DevTools.
Figure 1. The demo on the left, and DevTools on the right
Simulate a mobile CPU
Mobile devices have much less CPU power than desktops and laptops. Whenever you profile a page, useCPU Throttling to simulate how your page performs on mobile devices.
- In DevTools, click the Performance tab.
- Make sure that the Screenshots checkbox is enabled.
- Click Capture Settings.DevTools reveals settings related to how it captures performance metrics.
For CPU, select 2x slowdown. DevTools throttles your CPU so that it's 2 times slowerthan usual.
Figure 2. CPU throttling, outlined in blue
Set up the demo
It's hard to create a runtime performance demo that works consistently for all readers of thiswebsite. This section lets you customize the demo to ensure that your experience is relativelyconsistent with the screenshots and descriptions you see in this tutorial, regardless of yourparticular setup.
- Keep clicking Add 10 until the blue squares move noticeably slower than before. On ahigh-end machine, it may take about 20 clicks.
Click Optimize. The blue squares should move faster and more smoothly.
Click Un-Optimize. The blue squares move slower and with more jank again.
Record runtime performance
When you ran the optimized version of the page, the blue squares move faster. Why is that? Bothversions are supposed to move each square the same amount of space in the same amount of time. Takea recording in the Performance panel to learn how to detect the performance bottleneck in theun-optimized version.
In DevTools, click Record. DevTools capturesperformance metrics as the page runs.
Figure 3: Profiling the page
Wait a few seconds.
Click Stop. DevTools stops recording, processes the data, then displays the results on thePerformance panel.
Figure 4: The results of the profile
Wow, that's an overwhelming amount of data. Don't worry, it'll all make more sense shortly.
Analyze the results
Once you've got a recording of the page's performance, you can measure how poor the page'sperformance is, and find the cause(s).
Analyze frames per second
The main metric for measuring the performance of any animation is frames per second (FPS). Users arehappy when animations run at 60 FPS.
Look at the FPS chart. Whenever you see a red bar above FPS, it means that the frameratedropped so low that it's probably harming the user experience. In general, the higher the greenbar, the higher the FPS.
Figure 5: The FPS chart, outlined in blue
Below the FPS chart you see the CPU chart. The colors in the CPU chart correspond tothe colors in the Summary tab, at the bottom of the Performance panel. The fact that theCPU chart is full of color means that the CPU was maxed out during the recording. Wheneveryou see the CPU maxed out for long periods, it's a cue to find ways to do less work.
Figure 6: The CPU chart and Summary tab, outlined in blue
Hover your mouse over the FPS, CPU, or NET charts. DevTools shows a screenshot ofthe page at that point in time. Move your mouse left and right to replay the recording. This iscalled scrubbing, and it's useful for manually analyzing the progression of animations.
Figure 7: Viewing a screenshot of the page around the 2000ms mark of the recording
In the Frames section, hover your mouse over one of the green squares. DevTools shows youthe FPS for that particular frame. Each frame is probably well below the target of 60 FPS.
Figure 8: Hovering over a frame
Of course, with this demo, it's pretty obvious that the page is not performing well. But in realscenarios, it may not be so clear, so having all of these tools to make measurements comes in handy.
Bonus: Open the FPS meter
Another handy tool is the FPS meter, which provides real-time estimates for FPS as the page runs.
- Press Command+Shift+P (Mac) or Control+Shift+P (Windows, Linux) to open the Command Menu.
- Start typing
Rendering
in the Command Menu and select Show Rendering. In the Rendering tab, enable FPS Meter. A new overlay appears in the top-right of yourviewport.
Figure 9: The FPS meter
Disable the FPS Meter and press Escape to close the Rendering tab. You won't be using itin this tutorial.
Find the bottleneck
Now that you've measured and verified that the animation is not performing well, the next questionto answer is: why?
Note the summary tab. When no events are selected, this tab shows you a breakdown of activity.The page spent most of its time rendering. Since performance is the art of doing less work, yourgoal is to reduce the amount of time spent doing rendering work.
Figure 10: The Summary tab, outlined in blue
Expand the Main section. DevTools shows you a flame chart of activity on the main thread,over time. The x-axis represents the recording, over time. Each bar represents an event. A widerbar means that event took longer. The y-axis represents the call stack. When you see eventsstacked on top of each other, it means the upper events caused the lower events.
Figure 11: The Main section, outlined in blue
There's a lot of data in the recording. Zoom in on a single Animation Frame Fired event byclicking, holding, and dragging your mouse over the Overview, which is the section thatincludes the FPS, CPU, and NET charts. The Main section and Summary tab onlydisplay information for the selected portion of the recording.
Figure 12: Zoomed in on a single Animation Frame Fired event
Note the red triangle in the top-right of the Animation Frame Fired event. Whenever you seea red triangle, it's a warning that there may be an issue related to this event.
Click the Animation Frame Fired event. The Summary tab now shows you information aboutthat event. Note the reveal link. Clicking that causes DevTools to highlight the event thatinitiated the Animation Frame Fired event. Also note the app.js:94 link. Clicking thatjumps you to the relevant line in the source code.
Figure 13: More information about the Animation Frame Fired event
Under the app.update event, there's a bunch of purple events. If they were wider, it looksas though each one might have a red triangle on it. Click one of the purple Layout eventsnow. DevTools provides more information about the event in the Summary tab. Indeed, there'sa warning about forced reflows (another word for layout).
In the Summary tab, click the app.js:70 link under Layout Forced. DevTools takes youto the line of code that forced the layout.
Figure 13: The line of code that caused the forced layout
Phew! That was a lot to take in, but you now have a solid foundation in the basic workflow foranalyzing runtime performance. Good job.
Bonus: Analyze the optimized version
Using the workflows and tools that you just learned, click Optimize on the demo to enable theoptimized code, take another performance recording, and then analyze the results. From the improvedframerate to the reduction in events in the Main section's flame chart, you can see that theoptimized version of the app does much less work, resulting in better performance.
Next steps
The foundation for understanding performance is the RAIL model. This model teaches you theperformance metrics that are most important to your users. See Measure Performance With The RAILModel to learn more.
To get more comfortable with the Performance panel, practice makes perfect. Try profiling your ownpages and analyzing the results. If you have any questions about your results, open a StackOverflow question tagged with google-chrome-devtools
. Include screenshots or links toreproducible pages, if possible.
To become an expert in runtime performance, you've got to learn how the browser translates HTML,CSS, and JS into pixels on a screen. The best place to start is the Rendering PerformanceOverview. The Anatomy Of A Frame dives into even more detail.
Last, there are many ways to improve runtime performance. This tutorial focused on one particularanimation bottleneck to give you a focused tour through the Performance panel, but it's only one ofmany bottlenecks you may encounter. The rest of the Rendering Performance series has a lot of goodtips for improving various aspects of runtime performance, such as: