1PMDAKVM(1)                  General Commands Manual                 PMDAKVM(1)
2
3
4

NAME

6       pmdakvm - Linux virtualization performance metrics domain agent (PMDA)
7

DESCRIPTION

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

INSTALLATION

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

CAVEATS

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

FILES

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

PCP ENVIRONMENT

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

SEE ALSO

62       PCPIntro(1), pmcd(1) and kvm(1).
63
64
65
66Performance Co-Pilot                  PCP                           PMDAKVM(1)
Impressum