Intel® Trace Analyzer and Collector User and Reference Guide

ID 767272
Date 3/31/2023
Document Table of 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 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 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.