User Guide

Contents

Rebuild and Install the Kernel for GPU Analysis

To collect i915 ftrace events that are required for a detailed analysis of GPU utilization, your Linux kernel should be properly configured.
If
VTune
Profiler
cannot start an analysis and you see an error message (
Collection of GPU usage events cannot be enabled. i915 ftrace events are not available
), you must rebuild and install the re-configured module i915.
Rebuilding the Linux kernel is only required if you need to see detailed information about GPU utilization. You can run GPU analyses and see high level information about GPU utilization without rebuilding your Linux kernel.
For kernel versions 4.14 and newer, enable these settings:
  • CONFIG_EXPERT=y
  • CONFIG_DRM_I915_LOW_LEVEL_TRACEPOINTS=y
If you update the kernel rarely, it is sufficient to configure and rebuild only module i915.
If you update the kernel often, build the special kernel for GPU analysis. Follow this procedure.
Installing the kernel requires root permissions.
  1. Add source package repositories for your Ubuntu version.
    For example, on Ubuntu Bionic Beaver* add:
    sudo add-apt-repository -s "deb http://ru.archive.ubuntu.com/ubuntu/ bionic main restricted"
  2. Install build dependencies:
    sudo apt -y build-dep linux linux-image-$(uname -r) sudo apt -y install libncurses-dev flex bison openssl libssl-dev dkms libelf-dev libudev-dev libpci-dev libiberty-dev autoconf
  3. Install kernel headers:
    sudo apt -y install linux-headers-$(uname -r)
  4. Create a folder for kernel source:
    mkdir -p /tmp/kernel cd !$
  5. Download kernel sources:
    apt -y source linux cd linux-*
    If you have a custom kernel, you need to find the corresponding source code the kernel belongs to.
  6. Create a
    .config
    file with the same configuration you have for your running kernel:
    cp /boot/config-$(uname -r) .config make olddefconfig
  7. In the new
    .config
    file, make sure the following settings are enabled:
    CONFIG_EXPERT=y
    CONFIG_FTRACE=y
    CONFIG_DEBUG_FS=y
    CONFIG_DRM_I915_LOW_LEVEL_TRACEPOINTS=y
    Update the file, if required, and save.
  8. Create a full
    .config
    file for the kernel:
    make olddefconfig
  9. Build
    objtool
    . This tool is required for building the sampling driver.
    make -C tools/ objtool
  10. Build the kernel with the new
    .config
    file:
    make -j `getconf _NPROCESSORS_ONLN` deb-pkg
  11. Install the kernel and kernel modules:
    sudo dpkg -i linux-*.deb
  12. Reboot the machine with the new kernel.

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