Intel® Graphics Performance Analyzers (Intel® GPA) Release Notes - 2022.3

Published: 04/25/2020  

Last Updated: 09/25/2022

Introduction

Intel® Graphics Performance Analyzers (Intel® GPA) provides tools for graphics analysis and optimizations for making games and other graphics-intensive applications run even faster. The tools support the platforms based on the latest generations of Intel® Core™ and Intel Atom® processor families, for applications developed for Windows* or Ubuntu*.

Intel® GPA provides a common and integrated user interface for collecting performance data. Using it, you can quickly see performance opportunities in your application, saving time and getting products to market faster.

For detailed information and assistance in using the product, refer to the following online resources:

  • Home Page: view detailed information about the tool, including links to training and support resources, as well as videos on the product to help you get started quickly.
  • Get Started Guide: get the main features overview and learn how to start using the tools on different host systems.
  • Training: learn at your level with Getting Started guides, videos and tutorials.
  • User Guide: get details on how to analyze Windows and Android* applications from a Windows system.
  • Support Forum: report issues and get help with using Intel® GPA.

 

What's New in This Release

New Features for Analyzing Graphics APIs

 

Graphics Frame Analyzer, Graphics Trace Analyzer, System Analyzer, Graphics Monitor

For Intel® GPA GUI tools: we will have updates in future releases.

Meanwhile, we have added system-wide, time-based GPU metrics collection capability for Ubuntu. We also added Ubuntu support for query-based metrics for OpenGL* in Graphics Frame Analyzer. Enable these metrics with these instructions.

Intel® GPA 2022.2 does not include the latest security updates. Additional functional and security updates will be included in a future release. Customers should update to the latest version when it becomes available.

graphviz source code is available in https://archive.softwareheritage.org/ hash commit is 12782df8963d39f7ebaee6979567c7c1b8bb8c11

 

Intel® GPA Framework 

  • Enhanced gpa-metrics-collector command:
    • Collect metrics at a faster rate, by as much as 22x for complex workloads.
    • In addition to collecting metrics per-frame, metrics can be collected per event, per pass or per multi-frame set.
  • Implemented sub-stream capture compression: achieve up to a 30% file size reduction with the new compression option to gpa-subcapture-recorder: --enable-compression.
  • Enabled multithreaded playback to improve CPU performance of the GPA player.
  • Enhanced support for games with complex render passes: now supporting Execute Indirect with DirectX Raytracing (DXR).

Note: Trace-cmd source code is available in https://archive.softwareheritage.org/ hash commit is f8ea7186250942cbb2741b82f167eca5fbba9ac0

 

System Requirements and Supported Platforms

Minimum System Requirements

  • Host processor: Intel® Core™ i processor family (i7/i5/i3)
  • System memory: 8 GB of RAM
  • Video memory: 512 MB of RAM
  • Minimum display resolution for the client: 1280 x 1024
  • Disk space: 5 GB for stream capture and 300 MB for frame capture
Direct installation on 32-bit Windows* systems is not supported. 

Platforms and applications supported by Intel® GPA 2022.3

  • Target platform: Where your game runs
  • Host platform: Where you run the analysis
  • Target application: Supported applications that run on the target system
Target System
(the system where your game runs)
Host System
(your development system where you run the analysis)
Target Application
(types of supported applications running on the target system)
Windows* 10, 11 Windows 10, 11

Direct3D* 9, 11, 12; Vulkan* 1.1, 1.2

OpenGL, OpenCL, Media SDK and oneVPL (Trace mode only)

Ubuntu 20.04 Ubuntu 20.04 OpenGL 3.2, 3.3, 4.0, 4.1 Core Profile

 

OpenGL: Although the tools may appear to work with the latest OpenGL API on the Windows platform in Frame mode (Graphics Frame Analyzer), this API is not officially supported for Graphics Frame Analyzer. Some features and metrics may not be available.

VR Support: VR support is no longer in active development.

Windows Server: Intel® GPA does not support Windows Server editions.

Supported Targets for Windows and Ubuntu Devices

Intel® GPA supports Intel® Graphics devices found in these Intel® processor generations as targets for analyzing Windows workloads. All these targets have enhanced metric support:

Target Processor
Intel® Xe HPG  
Intel® Iris® Xe MAX graphics  
Intel® Iris® Xe graphics 12th generation Intel® Core™ processors
Intel® Iris® Xe graphics 11th generation Intel® Core™ processors
Intel® Iris®  Plus graphics 10th generation Intel® Core™ processors
Intel® UHD Graphics 630 9th generation Intel® Core™ processors
Intel® UHD Graphics 630 8th generation Intel® Core™ processors
Intel® UHD Graphics630 7th generation Intel® Core™ processors
Intel® UHD Graphics 620 7th generation Intel® Core™ processors
Intel® HD Graphics 615 7th generation Intel® Core™ processors
Intel® HD Graphics 530 6th generation Intel® Core™ processors
Intel® HD Graphics 515 6th generation Intel® Core™ m processors

 

Although the tools may appear to work with other graphics devices, these devices are unsupported. Some features and metrics may not be available on unsupported platforms. If you run into in an issue when using the tools with any supported configuration, please report this issue through the Support Forum.

Driver Requirements for Intel® HD Graphics

When running Intel® GPA on platforms with supported Intel® HD Graphics, the tools require the latest graphics drivers for proper operation. You may download and install the latest graphics drivers from the Intel Download Center.

Intel® GPA inspects your current driver version and notifies you if your driver is out-of-date.

 

Installation Notes

Installing Intel® GPA

Download the Intel® GPA installer from the Intel® GPA Free Downloads.

If you use the product in a host/target configuration, install Intel® GPA on both systems. For more information on the host/target configuration, refer to Best Practices.

Installing Intel® GPA on Windows

To install the tools on Windows, download the *.msi package from the Intel® GPA Free Downloads and run the installer file.

To profile Vulkan applications, make sure to download and install the latest Vulkan SDK and runtimes.

For DirectX applications, download and install the DirectX End-User Runtime.

Installing Intel® GPA on Ubuntu*

To install Intel® GPA:

From the product download page, click the Ubuntu* Download button to download the .sh file and run the installer script with superuser privileges. The default installation path for Intel® GPA is /opt/intel/gpa.

To enable GPU metrics collection by Intel® GPA:

Refer to Enable Time-based and Query-based Metrics Collection.

To launch Intel® GPA:

  • From the GUI - Graphics Frame Analyzer - click the Show Applications button and choose Graphics Monitor.
  • From the CLI - enter gpa-monitor.

 

Technical Support and Troubleshooting

For technical support, including answers to questions not addressed in the installed product, visit the Support Forum.

 

Known Issues and Limitations

For All Intel® GPA Components

  • Windows
    • To collect stable metrics on third party graphics solutions, enable Developer Mode in Microsoft Windows OS settings.

For Graphics Monitor

  • In Graphics Monitor when capturing in Stream mode, if the application is closed with Alt+F4 or via the "stop" button, the stream file produced may have corrupted metadata. Information reflected in Graphics Frame Analyzer may be incorrect for the following: API name, Resolution reported, Device name and/or GPU name. However, the stream can be opened for profiling in most cases.

For Graphics Frame Analyzer

  • In rare cases the Resource Dependency Viewer may fail to load on some machines if it was used before. If the Resource Dependency Viewer shows “Loading...” on loading and it never loads, clear your browser’s cache and local storage for “localhost”. Restart Graphics Frame Analyzer, then open the Resource Dependency Viewer.

For DirectX* Applications 

  • Graphics Frame Analyzer shows increased metrics values for Direct3D 12 ExecuteIndirect events whose CommandSignature contains resource binding commands which may change vertex buffer, index buffer, constant buffer, shader resource and unordered access views. 
  • Graphics Frame Analyzer's Shader Editor doesn't display HLSL source code if shaders are compiled offline without debug information. 
  • DirectX 11 Parallel Execution View in Graphics Trace Analyzer is not supported on Skull Canyon platforms. 
  • A few DirectX 11 applications that create a temporary Direct3D* 11 device may crash if started from Graphics Monitor. To resolve this issue, please enable the System-wide Time-based GPU Metrics option in the Metrics tab of the Graphics Monitor options. 
  • Graphics Frame Analyzer does not display the Direct3D 12 Pipeline Statistics metrics for frames that contain ClearState or SetProtectedResourceSession calls. 
  • Graphics Frame Analyzer may work slowly during DirectX 9 frame profiling with the latest drivers.
  • Stream capture for 32-bit applications is not supported.
  • Shader profiler is not available on Gen12 hardware.
  • Metrics collection for DirectX 11 frames on Intel® Xe Max Graphics doesn’t work with drivers newer than 30.0.101.1340. To profiler DirectX 11 frames on Intel® Xe Max Graphics please downgrade driver to 30.0.101.1191.
  • Metrics in DXR Shader execution table don’t take into account continuation DXR shaders when Intel Graphics Compiler splits shader into multiple parts 

For Vulkan* Applications 

  • To profile Vulkan titles, make sure to download the latest Vulkan runtimes and SDK. 
  • In the case where Vulkan applications run on multi-GPU machines choose to render on a non-default adapter, one outside of the list of explicitly enumerated adapters, stream files may be produced that cannot be analyzed in the Profiling View of Graphics Frame Analyzer. 
  • Metrics will not show in Graphics Frame Analyzer for applications created in Unity that use the Vulkan renderer. 
  • Bottleneck analysis is not working on Gen12.

For Graphics Trace Analyzer 

  • Process name in Unicode is not properly shown in CPU context switch tracks when the name doesn’t match the “Language for non-Unicode programs” setting in Windows.
  • Tasks in OpenCL Execution tracks may be incorrectly aligned with other tracks. Task durations and relative positions inside the track are correct.
  • DirectX 11 Parallel Execution View in Graphics Trace Analyzer is not working properly on Intel® Xe-HPG platfroms.

For Intel® GPA Framework

  • Currently, subcapture ranges cannot include frame 0 and the last frame of a stream.

  • When using the screenshot layer, if a large number of screenshots are requested in close frame-intervals (every or every other frame) it is suggested to use the async=false layer flag to prevent unusually high memory connsumption and out of memory errors. This may result in a slight decrease in performance since screenshot cut and writing will be not run in async proccesses.

  • Frame 0 or the setup frame cannot currently be specified as a repeat frame in gpa-player’s range repeat functionality.

  • Subcapture functionality only supports Direct3D 12 at this time.

  • GPA CPP Generator does not support source-level generation of calls beyond the last frame delimiter in a stream.

  • User input for keyframes and deferred stream capture may not be registered in certain applications. Please use time-interval keyframes and capture layer parameters for deferred stream capture.

  • When using the AMD* RX Vega card to capture a stream on a Hades Canyon machine the argument “–page-tracker-mode 2” must be added to any ./gpa-injector command in order to properly capture the stream. Note that this does not apply to the iGFX card.

  • Intel® GPA Framework has been released for Vulkan and Direct3D 12, but Direct3D 11 support is released as Beta (for example, there is no metrics collection support on non-Intel GPUs yet), and is subject to change.

  • At present, the Intel® GPA Framework contains only Release builds (no debug builds of libraries).

  • The capture layer supports only 64-bit applications. However, the injection mechanism will work with 32-bit processes for the purpose of allowing the capture of applications that require 32-bit launchers.

  • A modification of shaders in HLSL representation can cause the gpa-player to crash if the original shader representation was different from HLSL (Vulkan).

  • Support is not provided yet for collecting query-based metrics from Vulkan transfer queues. When used, they are ignored by the MetricsExtractor when the graphics API pipeline statistics based query managers are used, but are accepted by the Intel Hardware Metrics Discovery library query manager which may return metrics results. No validation of such results have occurred.

 

Archived Release Notes

Back to Release Notes' Overview

Intel GPA Main Page

Intel GPA Framework

 

Product and Performance Information

1

Performance varies by use, configuration and other factors. Learn more at www.Intel.com/PerformanceIndex.