Intel® Graphics Performance Analyzers for Ubuntu* Host

User Guide

  • 2020.4
  • 12/10/2020
  • Public Content
Contents

Creating Frame and Trace Capture Files

To perform offline analysis of your graphics application, you need to capture stream, frame and trace files.
To capture streams, frames and traces on your local system, use System Analyzer HUD:
  1. Run the Graphics Monitor on your target system.
  2. Launch the graphics application as described in Launching an Application. The application starts running with the System Analyzer HUD enabled.
  3. Use 
    Ctrl+Shift+C
     to create frame capture files or
    Ctrl+Shift+T
     to create trace capture files. Streams are created automatically upon startup. During the capture, all applied overrides are turned off. When the capture is complete, the System Analyzer HUD displays the message providing information on the file name or on possible errors, if any.
NOTE
To capture a frame, trace or stream, you should launch different instances of your application.
To capture frames and traces on a remote system, use System Analyzer:
  1. Run the Graphics Monitor on your target system.
  2. Start the System Analyzer on the analysis system and connect them to the Graphics Monitor running on the target system.
  3. Launch the graphics application on your target system as described in Launching an Application.
  4. In the System Analyzer, click the
    Capture Frame/Capture Trace
     button, or use the
    Ctrl+Shift+C/Ctrl+Shift+T
     keyboard shortcut. The frame/trace files are captured immediately.
NOTE
Some games and applications trap all keystrokes, so keyboard shortcuts within the Intel® GPA do not work. In this case, to create frame/trace capture files you can:
  • Use
    Capture Frame
    /
    Capture Trace
     buttons of the System Analyzer.
All the captured stream, frame and trace files are saved on your analysis system. By default, you can find them in the user's home directory. On Ubuntu* , the default home directory is
~/GPA
 .
T
he filenames consist of two fields: the name of the game executable and the capture date and time, in the format
<executable name>_<date_time>
 . For example:
StateManager_2011_02_17__11_25_14
 . This two-field format allows you to capture many frames/traces in a short amount of time without typing a name and overwriting the previous capture file.
NOTE
The capture functionality differs for frames and traces:
  • When you capture traces, Intel® GPA saves the contents of the ring buffer just prior to the triggered capture.
  • When you capture frames, Intel® GPA saves the next frame after the triggered capture.
Capturing Trace Data for Application Startup
To analyze data for your application startup:
  1. On the
    Graphics Monitor Launcher
    screen
    , click the
    button.
  2. In the
    Trace
     tab, click the
    Capture application startup
     toggle button.
  3. Start your application as described in the Launching an Application Manually topic. Intel® GPA captures the trace data once the trace buffer is full.
See Also
 
 

Product and Performance Information

1

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