1PMDAKVM(1) General Commands Manual PMDAKVM(1)
2
3
4
6 pmdakvm - Linux virtualization performance metrics domain agent (PMDA)
7
9 pmdakvm is a Performance Metrics Domain Agent (PMDA) which exports met‐
10 ric values from the Linux KVM (Kernel Virtual Machine) virtualization
11 subsystem.
12
13 Per-processor KVM trace metrics from the kernel events enumerated below
14 /sys/kernel/debug/tracing/events/kvm can be configured statically using
15 the pmdakvm configuration file, /etc/pcp/kvm/kvm.conf.
16
18 Optionally configure trace points in the configuration file, then in‐
19 stall the KVM PMDA by using the Install script as root:
20
21 # cd $PCP_PMDAS_DIR/kvm
22 # ./Install
23
24 To uninstall, do the following as root:
25
26 # cd $PCP_PMDAS_DIR/kvm
27 # ./Remove
28
29 pmdakvm is launched by pmcd(1) and should never be executed directly.
30 The Install and Remove scripts notify pmcd(1) when the agent is in‐
31 stalled or removed.
32
34 When pmdakvm is running, it holds references to kernel resources within
35 the KVM device driver. It is thus not possible to unload or reload the
36 device driver module while the PMDA is running. The ideal procedure to
37 follow in order to reload the kernel module is the reverse of that de‐
38 scribed in the ``INSTALLATION'' section above - i.e. first run ./Re‐
39 move, then reload the kernel module, then run ./Install.
40
42 $PCP_SYSCONF_DIR/kvm/kvm.conf
43 configuration file for the pmdakvm agent
44
45 $PCP_PMDAS_DIR/kvm/Install
46 installation script for the pmdakvm agent
47
48 $PCP_PMDAS_DIR/kvm/Remove
49 undo installation script for the pmdakvm agent
50
51 $PCP_LOG_DIR/pmcd/kvm.log
52 default log file for error messages from pmdakvm
53
55 Environment variables with the prefix PCP_ are used to parameterize the
56 file and directory names used by PCP. On each installation, the file
57 /etc/pcp.conf contains the local values for these variables. The
58 $PCP_CONF variable may be used to specify an alternative configuration
59 file, as described in pcp.conf(5).
60
62 PCPIntro(1), pmcd(1) and kvm(1).
63
64
65
66Performance Co-Pilot PCP PMDAKVM(1)