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
    

    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:

For more complete information about compiler optimizations, see our Optimization Notice.