User Guide

  • 2022.2
  • 08/08/2022
  • Public Content
Contents

Starting Intel® Trace Analyzer

To view and analyze the trace data collected by the Intel Trace Collector, launch the Intel® Trace Analyzer.

Starting from Command Line

Invoke Intel Trace Analyzer through the command line:
$ traceanalyzer &
Optionally, specify one or more trace files as arguments. For example:
$ traceanalyzer ./poisson_icomm.single.stf &
The example above opens the trace file
poisson_icomm.single.stf
in Intel Trace Analyzer. To open trace files in the Intel Trace Analyzer without restarting it, select
File > Open
.

Starting from the GUI

On Windows* OS, use the
Search
menu or locate
Intel Trace Analyzer and Collector
from the
Start
menu to run the standalone GUI client.
For proper functioning of Intel Trace Analyzer, ensure that trace files do not get modified while they are opened.

traceanalyzer
Command Line Interface

You can use the Intel Trace Analyzer command-line interface to:
  • Pre-calculate trace caches for new trace files from batch files without invoking the graphical user interface. Use it for very big trace files.
  • Automate profiling data production for several trace files without further interaction.
For every opened trace file, Intel Trace Analyzer creates a trace cache. It is stored in the same directory as the trace file and has the same file name adding the
.cache
suffix. If Intel Trace Analyzer cannot create a cache file in the default directory, it can create it in the system temporary directory.
To enable the CLI, use
--cli
as the first argument to switch off the graphical user interface followed by a trace file name and any other CLI options.
For example, to perform message profile analysis on 
trace.stf
, apply filter by zero sender rank and print the output in
messages.log
, enter:
$ traceanalyzer --cli --messageprofile --filter=p2pfilter(sender(0)) -o messages.txt trace.stf
If you do not specify the output file, results will be printed in standard output.
To create the cache for
trace.stf
with default resolution, enter:
$ traceanalyzer --cli trace.stf -c0 -w
A batch file to pre-compute caches might look like this:
$ traceanalyzer --cli poisson_icomm.single.stf -c0 -w $ traceanalyzer --cli poisson_sendrecv.single.stf -c0 -w $ traceanalyzer --cli vtcounterscopec.single.stf -c0 -w
The CLI is for expert use and can be changed with any version without notice. 

Product and Performance Information

1

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