• 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

Intel's compilers may or may not optimize to the same degree for non-Intel microprocessors for optimizations that are not unique to Intel microprocessors. These optimizations include SSE2, SSE3, and SSSE3 instruction sets and other optimizations. Intel does not guarantee the availability, functionality, or effectiveness of any optimization on microprocessors not manufactured by Intel. Microprocessor-dependent optimizations in this product are intended for use with Intel microprocessors. Certain optimizations not specific to Intel microarchitecture are reserved for Intel microprocessors. Please refer to the applicable product User and Reference Guides for more information regarding the specific instruction sets covered by this notice.

Notice revision #20110804