Get Started with Intel® Trace Analyzer and Collector for Linux* OS

Prerequisites

Set up the environment by sourcing the setvars.sh script available in the installation directory (by default, /opt/intel/oneapi/itac). This sets the required environment variables for compilers, the Intel MPI Library, and Intel Trace Analyzer and Collector, and you are ready to trace your applications.

For more detail, see the HPC Kit Get Started Guide. For system requirements, refer to the Release Notes.

Trace Your Application

Run your MPI application using the mpirun command with the -trace option to generate a trace file:

$ mpirun -trace -n 4 ./myApp

A trace file .stf is generated, for example myApp.stf. For tracing details, see Intel Trace Collector Reference and User Guide.

Analyze the Application Behavior

  1. Open the generated .stf file in Intel Trace Analyzer:
    $ traceanalyzer ./myApp.stf
    
  2. Start analyzing your application using various charts and timelines. As a starting point, use the Summary Page to get the following information:
    • General information about your application.
    • Recommendations on where to start the analysis.

For detailed description of the available charts and diagrams, see Intel Trace Analyzer Reference and User Guide.

Graphical User Interface

Intel Trace Analyzer and Collector has a full-color customizable GUI with charts and drill-down view options.

The analyzer is able to rapidly unwind the call stack and use debug information to map instruction addresses to source code.

With both command-line and GUI interfaces, you can additionally set up batch runs or do interactive debugging.

Hover over a GUI element for short description, or click for more details.

Learn more...

Key Features

MPI Correctness Checking

The MPI Correctness Checker detects deadlocks, data corruption, and errors with MPI parameters, data types, buffers, communicators, point-to-point messages, and collective operations.

The Correctness Checker enables you to scale to large systems and detect errors even among a large number of processes.

Learn more...

Ideal Environment Simulation

Understand application imbalance and estimate a potential application speedup after MPI implementation tuning and/or network upgrades by using the Idealization capability.

Learn more...

Performance Assistant

Identify performance issues in your application using the Performance Assistant, which provides the following information:

Learn more...

User-Level Instrumentation

Control the profiling library and record user-defined activities, define groups of processes, define performance counters and record their values using the Intel® Trace Collector API.

Automatically instrument all your application functions with the Intel® compilers to analyze them with Intel Trace Analyzer.

Learn more...

Training and Documentation Resources

Visit the Intel Trace Analyzer and Collector page on for training and documentation resources including user guides, videos, webinars, featured articles, and more.

Refer to the Release Notes for product updates and system requirements.