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 Usage Example See Also 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

Domain API

A domain enables tagging trace data for different modules or libraries in a program. Domains are specified by unique character strings, for example TBB.Internal.Control.

Each domain is represented by an opaque __itt_domain structure, which you can use to tag each of the ITT API calls in your code.

You can selectively enable or disable specific domains in your application, in order to filter the subsets of instrumentation that are collected into the output trace capture file. Upon the first start, the application registers its domains in a configuration file of the Intel® GPA Graphics Monitor. By default, upon the first start of the application all the domains are enabled. To enable or disable domains for subsequent starts of the application, do the following before the start:

  1. Open the Graphics Monitor Launcher Screen.
  2. Click the Options button.
  3. Click the Tracing tab.
  4. Turn on or off the User Domains toggle buttons.

The overhead of a disabled domain is a single if check.

To create a domain, use the following primitives:

__itt_domain *ITTAPI__itt_domain_createA ( const char *name)

__itt_domain *ITTAPI __itt_domain_createW ( const wchar_t *name)

Or use the macro in the following way:

__itt_domain *ITTAPI __itt_domain_create (__TEXT("TBB.Internal.Control"))

For a domain name, the URI naming style is recommended, for example, com.my_company.my_application. The set of domains is expected to be static over the application's execution time, therefore, there is no mechanism to destroy a domain.

Any domain can be accessed by any thread in the process, regardless of which thread created the domain. This call is thread-safe.

Parameters of the primitives:

[in]

name

Name of domain

Usage Example

#include "ittnotify.h"
__itt_domain* pD = __itt_domain_create(__TEXT("My Domain") );
Parent topic: Instrumentation and Tracing Technology API Support
Level Two Title