This page documents how to do graphics profiling on Chromium with Intel® Graphics Performance Analyzers (GPA).
Intel® GPA is a toolset for graphics performance analysis and optimizations for graphics-intensive applications.
Currently Intel® GPA works best on Windows when analyzing Chromium. In this document, we will mainly talk about the best practice on how to profile Chromium with latest Intel® GPA on Windows with Intel D3D drivers. We will also keep this document up-to-date when there are any big updates about Intel® GPA in the future.
The official link to download Intel® GPA is here.
Currently Intel® GPA doest't support capturing frame of Chromium with Graphics Monitor. Instead we can do performance profiling by recording multi-frame streams with the command line tool gpa-injector.exe (under the folder ‘Streams/’ of the install directory of Intel® GPA ).
The steps to record multi-frame streams for D3D11 (for example, WebGL) and D3D12 (for example WebGPU) based graphics applications are different due to some known issues in Intel® GPA. Let's introduce them for you one by one.
For simplicity in this document we always suppose Intel® GPA is installed in its default directory (C:\Program Files\IntelSWTools\GPA).
Here are the steps to profile the WebGL application Aquarium with Intel® GPA.
cd C:\Program Files\IntelSWTools\GPA\Streams gpa-injector.exe --injection-mode 1 -t "%LOCALAPPDATA%\Google\Chrome SxS\Application\chrome.exe" -L capture -L hud-layer -- --no-sandbox https://webglsamples.org/aquarium/aquarium.html
-t specifies the binary file of the graphics application.-L hud-layer (optional) enables the HUD of Intel® GPA, where we can see some statistics (for example, the number of frames we have collected) of Intel® GPA.-- specifies the command line parameters that will be used when the graphics application is launched. Note that --no-sandbox is required when we profile Chrome with Intel® GPA.Close Chrome to stop recording the stream after we have collected enough frames.
Open Graphics Frame Analyzer (another tool in Intel® GPA), and we can see all the streamfiles we have collected before.
Open the stream file we'd like to analyze, and we can see all the frames included in the stream file.
Open the frame we are interested in and wait for the completion of stream play back, then we can choose the draw call we'd like to analyze and see all the statistics collected by Intel® GPA.
Here are the steps to profile the WebGPU application ComputeBoids with Intel® GPA.
cd C:\Program Files\IntelSWTools\GPA\Streams gpa-injector.exe --injection-mode 1 --hook-d3d11on12 -t "C:\Program Files\Google\Chrome\Application\chrome.exe" -L capture -L hud-layer -- --enable-unsafe-webgpu --no-sandbox --enable-dawn-features=emit_hlsl_debug_symbols,use_dxc,disable_symbol_renaming https://austin-eng.com/webgpu-samples/samples/computeBoids
--hook-d3d11on12 is required to profile WebGPU applications.Close Chrome to stop recording the stream after we have collected enough frames.
Open the stream file we'd like to analyze with Graphics Frame Analyzer.
Enable “Multi-Frame Profiling View (DirectX 11 Tech Preview)” in “General Settings” (a button on top right of the UI).
Click the “Direct Queue 1” tab (on the left of the UI), and open a call of “ExecuteCommandlists” we are interested in.
Wait for the completion of stream play back, then we can choose the draw call or the dispatch call we'd like to analyze and see all the statistics collected by Intel® GPA.
Currently Intel® GPA Shader Profiler doesn't work with Chromium.
Please visit the official website of Intel® GPA for more information.