Get Started with Intel® Trace Analyzer and Collector for Windows* OS
- Make sure you have the following software installed:
All of the Intel products above are available as part of the Intel oneAPI HPC Toolkit.
- Microsoft Visual Studio* IDE
- Intel oneAPI DPC++/C++ Compiler Pro or Intel® Fortran Compiler
- Intel MPI Library
- Intel Trace Analyzer and Collector
- Set up the environment by running thesetvars.batscript available in the installation directory (by default,Program Files (x86)\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.
Trace Your Application
- Compile your application with the-traceoption. For example:> mpiicc -trace myApp.c
- Run your MPI application, using thempiexeccommand to generate a trace file. For example:> mpiexec -n 4 myApp.exe
Analyze the Application Behavior
- Open the generated.stffile in Intel Trace Analyzer:> traceanalyzer myApp.stf
- Start analyzing your application, using various charts and timelines. As a starting point, use theSummary Pageto get the following information:
- General information about your application
- Recommendations on where to start the analysis
Graphical User Interface
- Trace Maprepresents a miniature view of the MPI functions activity over time. It also enables you to zoom into relevant subsets of a trace file on all open charts.
- Event Timelineis the most common chart, which provides a graphical display of individual process activities over time. It enables you to get detailed impression of the program structure, as well as retrieve detailed event information. Horizontal bars represent processes with functions called in them.
- Quantitative Timelineshows how many processes are executing the same functions at a given point in time. It enables you to get the impression on parallelism and load balance in your application. As in all other charts, MPI functions are represented in shades ofred, serial code — inblue.
- Time Scalefor the currently open timelines displays with the currently selected time interval.
- Function Profileprovides an overview of all functions used in the application. It consists of four tabs:
- Flat Profile is a simple overview of all functions.
- Load Balance shows how long each function executed forallprocesses.
- Call Tree shows the call stack.
- Call Graph shows calling dependencies.
- Message Profileshows statistics about point-to-point operations. It categorizes messages by groupings in a matrix, and shows values of the selected attribute in each cell. By default, the Message Profile shows how long messages took to send for each pair of sender/receiver processes. Cell colors represent the message send time, relative to other process pairs, red being the longest.
- Collective Operations Profiles similar to the Message Profile, but it shows statistics about collective operations. As in the Message Profile, you can configure the columns, rows and attributes to show, and compare the attribute values for each pair. By default, this profile shows how long each operation took to complete for each process. Cell colors represent the operation execution time, relative to other processes/operations, red being the longest.
- Toolbarprovides easy access to the most frequently used Intel Trace Analyzer functionality.
- Detailed description of the issue and recommendations on how to resolve it.
- Information about the affected processes.
- Regions in the source code that caused the issue.