Intel® Trace Analyzer and Collector User and Reference Guide

ID 767272
Date 3/31/2023
Document Table of 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.