Intel® Graphics Performance Analyzers User Guide

User Guide

  • 2021.3
  • 09/23/2021
  • Public Content
Contents

Set Up Tracing Options

With the Intel® GPA, you can capture traces - records of activity on the CPU and GPU - and analyze them with Trace Analyzer. To modify the tracing options:
  1. In the Graphics Monitor Launcher screen, click the
    Options
     button.
  2. Go to the
    Trace
     tab and configure the available tracing options:
    • To capture a trace from the very first scenes, enable the application startup data capturing by enabling the
      Capture Application Startup
       toggle button. Capture starts automatically at application startup and ends when the trace buffer is full.
    • To collect the necessary data for analysis and use disk space efficiently at the same time, set the duration of the application run to be captured in a single trace file. The default trace duration is 5 seconds.
    • Enable capturing of events to show parallel execution data in the Graphics Trace Analyzer for DirectX* 11 based applications.
    • Select predefined Intel® GPA domains and user ITT domains.
    • Add system ETW providers.
The default settings represent the common use case.

Parallel Event Execution (DirectX 11)

To track parallel execution, enable
Parallel Event Execution (DirectX 11)
 toggle button. Parallel Execution track appears in the Trace Analyzer Platform View window. It visualizes how the driver parallelizes execution of submitted render events.
Parallel Event Execution track in the Trace Analyzer Platform View window.

Select Intel® GPA Domains and User ITT Domains

You can select predefined Intel® GPA domains - sets of data to collect about CPU threads. Available domains are the following:
  • Graphics API
     domain allows you to collect calls from graphics APIs, such as DirectX, for all CPU threads.
  • ID3DUserDefinedAnnotation
    ,
    ID3D11DeviceContext2 Events
    , and
    WinPixEventsRuntime
     domains allow you to collect data from the debug annotation APIs. It is not recommended to use these domains in the code together and enable these domains simultaneously in the
    Trace
     tab.
  • OpenCL™ API
     domain allows you to collect OpenCL data: function calls, execution time for a particular task, and relation between the tasks of submitting and executing a particular kernel. The data is useful to spot synchronization issues or understand whether there is a problem in OpenCL if you use different APIs.
  • Metrics
     domain allows you to collect CPU and GPU metrics.
You can also select user domains in order to filter the subsets of instrumentation that are collected into the output trace capture file.
The list of user domains is gathered from the analyzed applications and is updated upon exit from the application. You can define user domain with Instrumentation and Tracing Technology API (ITT API). Intel® GPA supports ITT API in the same way as the debug annotation API.

Add System ETW* Providers

You can use the Event Tracing for Windows technology to collect events from custom event providers. By default, Graphics Monitor displays a list of providers already registered in the system. You can select a default provider or create a custom one. You can also use the bitmask to filter specific events.
To configure ETW providers:
  1. In the Graphics Monitor Launcher screen, click the
    Options
     button.
  2. Navigate to the
    Trace
     tab and switch to the
    ETW Providers
     tab.
  3. Click the
    Enter provider name or GUID
     field to get a drop-down list of available event providers.
  4. Select the desired event provider and click the
    Add
     button. The provider is added to the list of active providers.
  5. In the
    Attributes
     field, specify the bitmask for the desired events.
  • You can enable or disable individual providers at any time by clicking the ON/OFF toggle.
  • When you capture a trace with custom ETW providers enabled, the events from these providers will be grouped by provider name in the Trace Analyzer Trace Content pane.

Product and Performance Information

1

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