Intel Trace Collector/Analyzer - Revision history

Daniel-schurhoff-de23@rwth-aachen.de at 06:22, 4 September 2019

2019-09-04T06:22:07Z

Thomas-gruber-5537@uni-erlangen.de at 12:49, 4 June 2019

2019-06-04T12:49:19Z

Thomas-gruber-5537@uni-erlangen.de at 12:42, 4 June 2019

2019-06-04T12:42:13Z

Thomas-gruber-5537@uni-erlangen.de at 12:39, 4 June 2019

2019-06-04T12:39:24Z

Thomas-gruber-5537@uni-erlangen.de at 12:38, 4 June 2019

2019-06-04T12:38:16Z

Thomas-gruber-5537@uni-erlangen.de: Created page with "== MPI Profiling with Intel Trace Collector/Analyzer == Intel Trace Collector/Analyzer are powerful tools that acquire/display information on the communication behavior of an..."

2019-06-04T12:37:29Z

Created page with "== MPI Profiling with Intel Trace Collector/Analyzer == Intel Trace Collector/Analyzer are powerful tools that acquire/display information on the communication behavior of an..."

New page

== MPI Profiling with Intel Trace Collector/Analyzer ==

Intel Trace Collector/Analyzer are powerful tools that acquire/display information on the communication behavior of an MPI program. Performance problems related to MPI can be identified by looking at timelines and statistical data. Appropriate filters can reduce the amount of information displayed to a manageable level.

In order to use Trace Collector/Analyzer you have to prepare your shell environment (e.g. with [[modules]]). This section describes only the most basic usage patterns. Complete documentation can be found on [https://software.intel.com/en-us/intel-trace-analyzer/documentation Intel’s ITAC website], or in the Trace Analyzer Help menu. Please note that tracing is currently only possible when using Intel MPI.

=== Trace Collector (ITC) ===

ITC is a tool for producing tracefiles from a running MPI application. These traces contain information about all MPI calls and messages and, optionally, on functions in the user code.

It is possible to trace your application without rebuilding it by dynamically loading the ITC profiling library during execution. The library intercepts all MPI calls and generates a trace file. To start the trace, simply add the <code>-trace</code> option to your <code>mpirun</code> command, e.g.:
<code>
$ mpirun -trace -n 4 ./myApp.
</code>

In some cases, your application has to be rebuild to trace it, for example if it is statically linked with the MPI library or if you want to add user function information to the trace. To include the required libraries, you can use the <code>-trace</code> option during compilation and linking. Your application can then be run as usual, for example:

<code>
$ mpiicc -trace myApp.c -o myApp
$ mpirun -n 4 ./myApp
</code>

You can also specify other profiling libraries, for a complete list please refer to the ITC User Guide.

After an MPI application that has been compiled or linked with ITC has terminated, a collection of trace files is written to the current directory. They follow the naming scheme <code><binary-name>.stf*</code> and serve as input for the Trace Analyzer tool. Keep in mind that depending on the amount of communication and the number of MPI processes used, these trace files can become quite large. To generate one single file instead of several smaller files, specify the option <code>-genv VT_LOGFILE_FORMAT=SINGLESTF</code> in your <code>mpirun</code> call.

=== Trace Analyzer (ITA) ===

The <code><binary-name>.stf*</code> file produced after running the instrumented MPI application should be used as an argument to the traceanalyzer command:

<code>
traceanalyzer <binary-name>.stf
</code>

The trace analyzer processes the trace files written by the application and lets you browse through the data. Click on „Charts-Event Timeline“ to see the messages transferred between all MPI processes and the time each process spends in MPI and application code, respectively. Click and drag lets you zoom into the timeline data (zoom out with the „o“ key). „Charts-Message profile“ shows statistics about the communication requirements of each pair of MPI processes. The statistics displays change their content according to the currently displayed data in the timeline window. Please consider the Help menu or the [https://software.intel.com/en-us/trace-analyzer/documentation ITAC User Guide] to get more information.

Author: Katrin Nusser (RRZE)

← Older revision		Revision as of 06:22, 4 September 2019
Line 1:		Line 1:
		+	[[Category:HPC-Developer]]
	=== MPI Profiling with Intel Trace Collector/Analyzer ===		=== MPI Profiling with Intel Trace Collector/Analyzer ===

← Older revision		Revision as of 12:49, 4 June 2019
Line 35:		Line 35:
	The trace analyzer processes the trace files written by the application and lets you browse through the data. Click on „Charts-Event Timeline“ to see the messages transferred between all MPI processes and the time each process spends in MPI and application code, respectively. Click and drag lets you zoom into the timeline data (zoom out with the „o“ key). „Charts-Message profile“ shows statistics about the communication requirements of each pair of MPI processes. The statistics displays change their content according to the currently displayed data in the timeline window. Please consider the Help menu or the [https://software.intel.com/en-us/trace-analyzer/documentation ITAC User Guide] to get more information.		The trace analyzer processes the trace files written by the application and lets you browse through the data. Click on „Charts-Event Timeline“ to see the messages transferred between all MPI processes and the time each process spends in MPI and application code, respectively. Click and drag lets you zoom into the timeline data (zoom out with the „o“ key). „Charts-Message profile“ shows statistics about the communication requirements of each pair of MPI processes. The statistics displays change their content according to the currently displayed data in the timeline window. Please consider the Help menu or the [https://software.intel.com/en-us/trace-analyzer/documentation ITAC User Guide] to get more information.

−	''Author: Katrin Nusser (RRZE)''	+	''Author: Katrin Nusser (RRZE) & Thomas Zeiser (RRZE)''

← Older revision		Revision as of 12:39, 4 June 2019
Line 1:		Line 1:
−	== MPI Profiling with Intel Trace Collector/Analyzer ==	+	=== MPI Profiling with Intel Trace Collector/Analyzer ===

	Intel Trace Collector/Analyzer are powerful tools that acquire/display information on the communication behavior of an MPI program. Performance problems related to MPI can be identified by looking at timelines and statistical data. Appropriate filters can reduce the amount of information displayed to a manageable level.		Intel Trace Collector/Analyzer are powerful tools that acquire/display information on the communication behavior of an MPI program. Performance problems related to MPI can be identified by looking at timelines and statistical data. Appropriate filters can reduce the amount of information displayed to a manageable level.

← Older revision		Revision as of 12:38, 4 June 2019
Line 35:		Line 35:
	The trace analyzer processes the trace files written by the application and lets you browse through the data. Click on „Charts-Event Timeline“ to see the messages transferred between all MPI processes and the time each process spends in MPI and application code, respectively. Click and drag lets you zoom into the timeline data (zoom out with the „o“ key). „Charts-Message profile“ shows statistics about the communication requirements of each pair of MPI processes. The statistics displays change their content according to the currently displayed data in the timeline window. Please consider the Help menu or the [https://software.intel.com/en-us/trace-analyzer/documentation ITAC User Guide] to get more information.		The trace analyzer processes the trace files written by the application and lets you browse through the data. Click on „Charts-Event Timeline“ to see the messages transferred between all MPI processes and the time each process spends in MPI and application code, respectively. Click and drag lets you zoom into the timeline data (zoom out with the „o“ key). „Charts-Message profile“ shows statistics about the communication requirements of each pair of MPI processes. The statistics displays change their content according to the currently displayed data in the timeline window. Please consider the Help menu or the [https://software.intel.com/en-us/trace-analyzer/documentation ITAC User Guide] to get more information.

−	Author: Katrin Nusser (RRZE)	+	''Author: Katrin Nusser (RRZE)''

@@ Line 17: / Line 17: @@
 <code>
-$ mpiicc -trace myApp.c -o myApp
+$ mpicc -trace myApp.c -o myApp
 $ mpirun -n 4 ./myApp
 </code>