• 9.1
  • 07/08/2015
  • Public Content

Working with the Intel® Trace Analyzer and Collector Examples


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.
  1. Copy the
    examples
    directory into a shared directory, which is accessible by all nodes of the cluster.
  2. 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
Note
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:
  1. 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.
  2. 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
  3. For details, refer to the Intel® MPI Library documentation.

Compiling and Instrumenting Test Files on Windows* OS

  1. Create a shared directory which is accessible to all nodes of the cluster and copy the
    examples
    directory into it.
  2. Clean up the directory content:
    nmake distclean
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
Note
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:
  1. 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
    :
  2. To view the
    Event Timeline
    chart, go to
    Charts
    >
    Event Timeline
    :

Product and Performance Information

1

Performance varies by use, configuration and other factors. Learn more at www.Intel.com/PerformanceIndex.