Intel® Graphics Performance Analyzers for Ubuntu* Host

User Guide

  • 2020.3
  • 07/10/2020
  • Public Content
Contents

Capturing Trace Data for Application Startup

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.
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.

Product and Performance Information

1

Intel's compilers may or may not optimize to the same degree for non-Intel microprocessors for optimizations that are not unique to Intel microprocessors. These optimizations include SSE2, SSE3, and SSSE3 instruction sets and other optimizations. Intel does not guarantee the availability, functionality, or effectiveness of any optimization on microprocessors not manufactured by Intel. Microprocessor-dependent optimizations in this product are intended for use with Intel microprocessors. Certain optimizations not specific to Intel microarchitecture are reserved for Intel microprocessors. Please refer to the applicable product User and Reference Guides for more information regarding the specific instruction sets covered by this notice.

Notice revision #20110804