Intel® Graphics Performance Analyzers User Guide

Download PDF
ID 767266
Date 9/28/2023
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of Contents
Document Table of Contents x
Intel® Graphics Performance Analyzers User Guide
Intel® Graphics Performance Analyzers User Guide x
Introduction to Intel® Graphics Performance Analyzers Game Optimization Methodology Install and Launch Intel® GPA Enable GPU Metrics Collection Launch Application for Analysis Configure Analysis Settings Analyze Desktop Graphics Applications Quick Start with Profiling Unreal Engine* Games Instrumentation and Tracing Technology API Support Intel® GPA Reference Notices and Disclaimers
Introduction to Intel® Graphics Performance Analyzers x
Get Help
Launch Application for Analysis x
Start a Desktop Application with Graphics Monitor Start a Windows* Mixed Reality Application Connect to a Running Application (Windows* only) Analyze Applications in the Network Mode
Configure Analysis Settings x
Configure a Metric Set Customize Keyboard Shortcuts Set Up a Trigger Set Up Tracing Options Set Up Stream Options Set Frame Delimiters
Analyze Desktop Graphics Applications x
Manage Analysis with Graphics Monitor Monitor Real-Time Performance with System Analyzer Identify Issues in Graphics Application Execution with Trace Analyzer Analyze GPU-bound Applications with Graphics Frame Analyzer Optimize Specific Domains
Monitor Real-Time Performance with System Analyzer x
Pause and Resume a Running Application Export Metrics Data with System Analyzer
Analyze GPU-bound Applications with Graphics Frame Analyzer x
Run Render State Experiments with Frame Analyzer Use Advanced Profiling Mode Graphics Frame Analyzer Plugins
Graphics Frame Analyzer Plugins x
Create a Custom Plugin for Graphics Frame Analyzer
Optimize Specific Domains x
Optimize Shaders Analyze Textures Minimize Overdraw Optimize Graphic API States Identify Graphics Elements with Complex Geometry Visualize Color Distribution
Instrumentation and Tracing Technology API Support x
Compile and Link with ITT API Instrument Your Application Minimize ITT API Overhead Clock Domain API Counter API Domain API Marker API Metadata API Relation API String Handle API Thread Naming API Task API
Intel® GPA Reference x
Performance Metrics Reference User Interface Reference
Performance Metrics Reference x
CPU Metrics Device I/O Metrics GPU Metrics Graphics API Metrics Memory Metrics
User Interface Reference x
Graphics Monitor UI Reference Heads-Up Display (HUD) UI Reference System Analyzer UI Reference Graphics Frame Analyzer UI Reference Graphics Trace Analyzer UI Reference
Graphics Monitor UI Reference x
Graphics Monitor Context Menu Graphics Monitor Configuration Window Graphics Monitor Control Panel Graphics Monitor Window: Desktop Applications Tab Graphics Monitor Window: Universal Windows Applications Tab (Windows* only) Graphics Monitor Window: Options Dialog Box
Graphics Frame Analyzer UI Reference x
Graphics Frame Analyzer Window: Open Frame Capture Graphics Frame Analyzer Window: Multiframe View Graphics Frame Analyzer Window: Profiling View Graphics Frame Analyzer Window: Dependency Viewer
Graphics Frame Analyzer Window: Profiling View x
Main Toolbar Visualization Pane API Log Pane Resources Pane Metrics Pane Experiments Pane
Graphics Trace Analyzer UI Reference x
Graphics Trace Analyzer Window: Open Trace Capture Graphics Trace Analyzer Window: Platform View
Intel® Graphics Performance Analyzers User Guide

Quick Start with Profiling Unreal Engine* Games

Intel® GPA allows you to see FPS, shader, texture, and draw call details of the application. With the Graphics Performance Analyzers Plugin (GPAPlugin) for Unreal Engine*, you can capture a multi-frame stream directly while you are in Unreal Editor, and later analyze it with Intel GPA Graphics Frame Analyzer.

Multi-frame stream capturing allows you to analyze problems that are virtually impossible to debug in single frame capture mode. Such problems as intermittent glitches, random hitches, and issues with multi-frame algorithms can be tracked down more easily in Stream (multi-frame) mode because you can toggle between frames in a single capture.

This topic shows you how to start analyzing Unreal Engine* games with Intel GPA tools and the Intel GPA plugin in Unreal Editor.

Understand the Workflow

The common use case is when you know that your application is GPU-bound and you need to look into the details of API calls, shader execution, resources, bottlenecks in the graphics pipeline, or understand how multi-frame algorithms are being executed. In this case, your workflow is the following, and the details for each of these steps are explained below:

  1. Enable the Intel GPA plugin in Unreal Editor.
  2. With the Intel GPA plugin, capture a multi-frame stream directly from Unreal Editor.
  3. Open a stream and analyze it with Graphics Frame Analyzer. In this step, you can track such problems as random hitches and issues with multi-frame algorithms or identify frames that are taking more time than expected.
  4. Select a frame, or a set of frames, of interest and continue in-depth analysis with Graphics Frame Analyzer. In this step, you can analyze API calls, graphics resources, and find bottlenecks in the graphics pipeline.

Prerequisites

To be able to capture and analyze multi-frame streams from Unreal Editor:

Enable the Intel GPA Plugin

  1. Download the GPAPlugin from the GitHub page and copy the GPAPlugin directory to UnrealEngine\Engine\Plugins\Developer in your Unreal Engine installation folder.
  2. Run Unreal Editor and open the Plugins menu in Settings.

  3. Look up GPAPlugin using the search bar. Enable the plugin using the check box.

  4. Follow the prompt and restart Unreal Editor.

Capture Streams with the Intel GPA Plugin

Choose one of the following ways to capture a multi-frame stream:

  • In the editor:

    Once you enable the plugin and restart the editor, an additional Start/stop GPA stream capture button displays in the toolbar.

    1. To start the capture of a sequence of frames, click the Start/stop GPA stream capture button.

      A pop-up window in the lower right corner indicates that the capture has started.

    2. To stop the capture, click the same button again.

      A message shows that the capture is complete.

  • In the console:

    You can also capture streams when running the game.

    1. To start the capture of a sequence of frames, use the command: 
      gpa.StreamCapture start
    2. To stop the capture, use the command: 
      gpa.StreamCapture stop


You can create multiple captures, each is stored separately for later analysis.

NOTE:
Currently only DirectX* 12 captures are supported by the Intel GPA Plugin. Make sure to change the RHI to DX12 in Settings->Project Settings->Platforms->Windows and restart Unreal Editor.

Open Frame Streams in Graphics Frame Analyzer

If you want to start Intel GPA immediately after the capture completes, this can be configured in the plugin settings.

  1. Go to Settings->Project Settings.
  2. Scroll down to the Plugins and select GPA.
  3. Enable the option to run Intel GPA after the capture completes.

In other cases, you can open multi-frame streams through Intel GPA Graphics Frame Analyzer. The picture below shows the case when only one stream has been captured during a session with Unreal Editor. If multiple captures have been completed, each capture is shown as a separate thumbnail. They all are ready for analysis.



Double-click the stream or choose the stream you want to analyze and click Opento open it in Graphics Frame Analyzer. There you will see a list of captured frames.

When analyzing streams with ray tracing enabled, make sure that 'Multi-Frame Profiling View' is turned on in General Settings.

Analyze Frames in Graphics Frame Analyzer

To go one level deeper and analyze an individual frame, double-click a frame or choose the frame you want to analyze and click Open. This will open a new view that enables you to analyze each rendering command, along with the associated resources such as shaders, stage input and output textures, and buffers.

To learn more about stream analysis, frame analysis, potential insights, and next steps, refer to Analyze GPU-bound Applications with Graphics Frame Analyzer.

NOTE:
In some cases, you may need to track application execution on the CPU and GPU to identify whether the bottleneck is on the CPU or GPU side. In this case, before starting in-depth frame analysis, capture a trace from your application (a number of seconds of execution) and analyze it with Intel GPA Graphics Trace Analyzer. Note that the Intel GPA plugin for Unreal Engine does not support capturing traces directly from Unreal Editor, so you need to capture a trace with Intel GPA Graphics Monitor using a general procedure.

If you figure out that the app is GPU-bound from your trace analysis, follow the workflow above. Otherwise, you can continue in-depth analysis with Graphics Trace Analyzer: analyze graphics API calls, review user-defined debug markers, thread activity, queued GPU commands and/or perform a high-level analysis of synchronization and parallelism efficiency.

Parent topic: Intel® Graphics Performance Analyzers User Guide
Level Two Title