analyze-kvm-guest

Analyze a KVM guest OS running on your system.

GUI Equivalent

Analyze KVM guest OS option in the Analysis Target Setup

Syntax

-analyze-kvm-guest | -no-analyze-kvm-guest

Default

-no-analyze-kvm-guest

Actions Modified

collect-with

Description

Analyze a KVM guest OS running on your system. For successful analysis, make sure to do the following:

Copy these files from the guest OS to your local file system:
- /proc/kallsyms
- /proc/modules
- any guest OS’s modules of interest (vmlinux, any *.ko files, and so on)
Specify a Linux target system for analysis using the target-system option.
Configure your VTune Amplifier analysis target by using thekvm-guest-kallsyms, kvm-guest-modules, and search-dir options to specify paths to the files copied in step 1 for accurate module resolution.
Configure your collect-with by using theknob ftrace-config=<events> option to specify Linux FTrace* events tracking IRQ injection process.

Example

Enable a custom hardware event-based sampling collection for the KVM guest OS and collect irq, softirq, workq, and kvm FTrace events:

$ amplxe-cl 
    --target-system=ssh: user1@172.16.254.1 -collect-with runsa -knob
    event-config=CPU_CLK_UNHALTED.REF_TSC:sa=3500000,CPU_CLK_UNHALTED.THREAD:sa=3500000,INST_RETIRED.ANY:sa=3500000
    –knob enable-stack-collection=true -knob ftrace-config=irq,softirq,workq,kvm
    -analyze-kvm-guest -kvm-guest-kallsyms=/home/vtune/[guest]/kvm.kallsyms
    -kvm-guest-modules=/home/vtune/[guest]/kvm.modules --search-dir
    sym:p=/home/vtune/ --target-pid 9791