Intel® VTune™ Amplifier XE and Intel® VTune™ Amplifier for Systems Help

Software Event Library

Use the Event Library provided in the Custom Analysis configuration to select Linux* Ftrace* and Android* framework events to monitor with the event-based sampling collector.

Note

This functionality is supported by the Intel® VTune™ Amplifier for Systems only.

To choose events from the library:

  1. Create a new hardware event-based sampling analysis type.

    The new analysis type shows up under the Custom Analysis node in the Choose Analysis Type window.

  2. Select the newly created analysis type and click the Edit button on the right pane of the Choose Analysis Type window.

    The Custom Analysis dialog box opens.

  3. In the Custom Analysis dialog box, use the Event Library area to select Linux Ftrace and/or Android framework events to monitor system behavior:

    For example, for KVM guest OS profiling consider selecting the following Linux Ftrace events to track IRQ injection process: kvm, irq, sofirq and workq.

  4. Click OK to close the Custom Analysis dialog box.

    The new hardware event-based sampling analysis configuration is updated with the new events.

The collected data shows up as tasks in the default viewpoint. Start with the Summary window to identify the most time-consuming tasks in the Top Tasks section. Analyze task duration statistics presented by task type in the Task Duration histogram:

Use the sliders to set up thresholds for high and slow task instances.

Clicking a task in the Top Tasks section opens the Bottom-up window grouped by tasks. To analyze tasks over time, switch to the Platform window:

VTune Amplifier Platform Window

Limitations

On some systems, the Linux Ftrace subsystem, located in the debugfs partition in /sys/kernel/debug/tracing, may be accessible for the root user only. In this case, the VTune Amplifier provides an error message: Ftrace collection is not possible due to a lack of credentials. Root privileges are required. To enable Ftrace events collection on such a system, you may either run the VTune Amplifier with root privileges or change permissions manually by using the chown command under the root account, for example:

$ chown -R <user>:<group> /sys/kernel/debug/tracing

You can automate this process by using the prepare_debugfs.sh script located in the bin directory. The script mounts debugfs, changes permissions to a desired group, and updates the install boot script to apply this change automatically on the system startup. To execute this script, make sure to use root privileges.

To change permissions automatically with the prepare_debugfs.sh script, enter:

$ ./install/bin64/prepare-debugfs.sh [option]

where [option] is one of the following:

Option

Description

-h | --help

Display usage information.

-i | --install

Configure the without options, script will configure debugfs boot script and install it in the appropriate system directory.

-c | --check

Mount without options, script will configure debugfs and check permissions.

-u | --uninstall

Uninstall a previously installed debugfs boot script and revert configuration.

-g | --group <group>

Specify group other than vtune.

-r | --revert

Revert debugfs configuration.

-b | --batch

Run in a non-interactive mode (exiting in case of already changed permissions) without options. The script will configure debugfs.

See Also