User Guide

  • 2022.2
  • 08/08/2022
  • Public Content

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
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
    sample with the necessary counters
  2. Rebuild the
    1. Copy the contents of
      directory into your working directory.
    2. Edit the provided
      to match the local setup.
    3. Build the file using the
  3. Set the
    environment variable as follows:
    $ export LD_LIBRARY_PATH=<path_to_libVTsample>:<path_to_PAPI>
  4. Add
    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


Performance varies by use, configuration and other factors. Learn more at