You can find the Intel® Trace Analyzer and Collector examples directory at <install_dir>/examples. This topic explains how to create a trace file for the vtjacobic executable file. You can apply the same principles to other sample files and your own applications.
Compiling and Instrumenting Test Files on Linux* OS
Before analyzing sample trace files, set up your working directory as follows.
- Copy the examples directory into a shared directory, which is accessible by all nodes of the cluster.
Clean up the directory content and compile and execute the C and Fortran executable files, entering the following commands:
gmake distclean gmake all
The resulting output will look as follows:
vnallpair vnallpairc vnjacobic vnjacobif vtallpair vtallpairc vtcounterscopec vtjacobic vtjacobif
The executable files listed above have already been linked with the appropriate Intel® Trace Collector libraries.
To analyze trace the vtjacobic executable, do the following:
Create a vtjacobic_inst directory and set the following environment variable:
setenv VT_LOGFILE_PREFIX vtjacobic_inst
This environment variable ensures that the trace files for the analysis appear in the created directory.
To run your MPI application, enter the command:
mpirun -n 4 -trace ./vtjacobic
The vtjacobic_inst directory should now contain the following files:
. vtjacobic.stf.dcl vtjacobic.stf.msg.anc .. vtjacobic.stf.frm vtjacobic.stf.pr.0 vtjacobic.prot vtjacobic.stf.gop vtjacobic.stf.pr.0.anc vtjacobic.stf vtjacobic.stf.gop.anc vtjacobic.stf.sts vtjacobic.stf.cache vtjacobic.stf.msg
For details, refer to the Intel® MPI Library documentation.
Compiling and Instrumenting Test Files on Windows* OS
Create a shared directory which is accessible to all nodes of the cluster and copy the examples directory into it.
Clean up the directory content:
To compile and execute the C and Fortran executable files, enter the following command:
nmake all MPIDIR="<install-dir>\MPI\em64t"The following C and Fortran executable files appear under the examples directory:
mpiconstants.exe vnallpair.exe vnallpairc.exe vnjacobic.exe vnjacobif.exe vtallpair.exe vtallpairc.exe vtcounterscopec.exe vtjacobic.exe vtjacobif.exe vttimertest.exe
The MPIDIR makefile variable is explicitly set to the directory of the Intel MPI Library that supports 64-bit address extensions.
For the executable files above, the following STF files are created:
timertest.stf vtallpair.stf vtallpairc.stf vtcounterscopec.stf vtjacobic.stf vtjacobif.stf
Analyzing Trace Data
To analyze trace files, do the following:
To analyze the newly created vtjacobic.stf trace file, enter the following commands.
On Linux* OS:
$ traceanalyzer vtjacobic_inst/vtjacobic.stf
On Windows* OS:
> traceanalyzer vtjacobic.stf
Intel® Trace Analyzer displays the Flat Profile tab for vtjacobic.stf:
To view the Event Timeline chart, go to Charts > Event Timeline: