Intel® VTune™ Amplifier XE and Intel® VTune™ Amplifier for Systems Help
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.
This functionality is supported by the Intel® VTune™ Amplifier for Systems only.
To choose events from the library:
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.
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.
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.
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:
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. |