Intel® Trace Analyzer and Collector User and Reference Guide

User Guide

  • 2022.2
  • 08/08/2022
  • Public Content
Contents

Recording Hardware Performance Information (Linux* OS)

On Linux* OS Intel® Trace Collector can sample hardware counters with the Performance Application Programming Interface (PAPI). Because PAPI might not be available on a system, support for it is provided as an additional layer on top of the normal Intel® Trace Collector.
This layer is implemented in the
VT_sample.c
 source file. It is a sample file that traces counters available through PAPI High level API.
To record hardware counters, do the following:
  1. Adjust the
    VT_sample.c
     sample with the necessary counters
  2. Rebuild the
    libVTsample.so
     file:
    1. Copy the contents of
      <isntall-dir>/slib
       directory into your working directory.
    2. Edit the provided
      Makefile
       to match the local setup.
    3. Build the file using the
      make
       command.
  3. Set the
    LD_LIBRARY_PATH
     environment variable as follows: 
    $ export LD_LIBRARY_PATH=<path_to_libVTsample>:<path_to_PAPI>
  4. Add
    libVTsample.so
     to the link line in front of the Intel Trace Collector library. The link line will look as follows: 
    $ mpiicc ctest.c -L$VT_SLIB_DIR -L. -L$PAPI_ROOT -lVTsample -lVT -lpapi $VT_ADD_LIBS -o ctest
To view the counters in Intel Trace Analyzer GUI, use
Counter Timeline
.

Product and Performance Information

1

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