The AMD GPU Performance API (GPA)

The AMD GPU Performance API (aka: GPUPerfAPI, or GPA) is a powerful library to help analyze the performance and execution characteristics of applications using AMD Radeon™ GPUs and APUs.

This API is designed to:

• Support Vulkan™, DirectX™ 12, DirectX™ 11, and OpenGL™ on RDNA, RDNA2, RDNA3, and RDNA4-based Radeon™ graphics cards and APUs.

• Support Microsoft Windows® and Linux®.

• Provide derived counters based on raw hardware performance counters.

• Provide a fine-grained way to collect performance data for an application.

• Usage
  • Transitioning from GPA 3.x to 4.0
  • Loading the GPUPerfAPI Library
  • Registering a Logging Callback
  • Initializing and Destroying a GPUPerfAPI Instance
  • Opening and Closing a Context
  • Querying a Context and Sample Types
  • Creating and Using a Session
  • Enabling Counters on a Session
  • Querying Enabled Counters and Counter Scheduling
  • Creating and Managing Samples
  • Querying Results
  • Displaying Status/Error
  • Multi-pass Counter Collection
  • Specific Usage Note for Vulkan
  • Specific Usage Note for Bundles (DirectX 12) and Secondary Command Buffers (Vulkan)
  • Specific Usage Note for Samples that Start and End on Different Command Lists
  • Deploying GPUPerfAPI
• Performance Counters
  • Pipeline-Based Counter Groups
  • A Note About Third-Party Applications
  • Counters Exposed for Graphics Performance Analysis
• API Reference
  • Functions
  • Types
• Environment Variables
  • GPA_EXPOSE_HW_COUNTERS
  • GPA_OVERRIDE_LOG_LEVEL