⚠ INFORMATION
This page was translated by an AI (LLM) with a cursory human check and is awaiting full review.

Intel Trace Analyzer and Collector (ITAC)

We invite you to consult the best practices for code profiling for general advice on performance analysis on Jean Zay.

Description

ITAC (Intel Trace Analyzer Collector) is a graphical tool that is part of the Intel Parallel Studio XE suite and allows you to understand the MPI behaviour of a code.

Installed Versions

• Several versions of ITAC are available depending on the versions of Intel Parallel Studio XE installed on the machine.

Usage

The module command allows access to the various versions of ITAC.

To display the available versions, you have two options:

• via the corresponding modulefiles:

$ module av intel-itac
intel-itac/2018.1(18.0.1)  intel-itac/2019.2(19.0.2)  intel-itac/2019.5(19.0.5)  intel-itac/2020.1
intel-itac/2018.4(18.0.5)  intel-itac/2019.4(19.0.4)  intel-itac/2020.0          intel-itac/2020.2

• or via the Intel environments:

$ module av intel-all
intel-all/2018.1(18.0.1)  intel-all/2019.2(19.0.2)  intel-all/2019.5 (19.0.5)  intel-all/2020.1
intel-all/2018.5(18.0.5)  intel-all/2019.4(19.0.4)  intel-all/2020.0           intel-all/2020.2

To use, for example, version 2020.2 of ITAC, you can use:

• either the corresponding modulefile:

$ module load intel-itac/2020.2

• or the corresponding Intel environment:

$ module load intel-all/2020.2

INFO

Note that the modules intel-all/XX.Y.Z contain the complete Intel environments with the compilers, the MKL math library, the MPI library, and the code analysis tools.

Once the appropriate module is loaded, using ITAC involves three steps:

• Recompilation of your program;
• Execution of your program;
• Visualisation/Analysis of the results with the graphical interface.

Compilation

You need to add the option -tcollect when compiling with the Intel compiler.

$ module load intel-itac/2020.2
$ mpiifort ... source.f90 -tcollect -o my_exe

$ mpiicc ... source.c -tcollect -o my_exe

$ mpiicpc ... source.C -tcollect -o my_exe

Execution

The execution is done either interactively or in batch mode, via the command srun and with the same Intel environment used for compilation:

$ module load intel-itac/2020.2
$ srun ... my_exe

Note: The execution generates an analysis file whose name is composed of the executable name and the suffix .stf (for this example my_exe.stf).

Attention

The Intel environment used at this stage must be the same as the one used for compilation.

Visualisation/Analysis of Results

The analysis of the results is done using the graphical interface (GUI) traceanalyzer by indicating the analysis file generated during the code execution.

To use the same version 2020.2 as the one used for compilation and execution, you must use the following commands:

$ module load intel-itac/2020.2
$ traceanalyzer my_exe.stf

Attention

The Intel environment used at this stage must be the same as the one used for sampling and compilation.

Documentation

• The Getting Started Guide for ITAC at Intel
• All the documentation on Intel's website