xref: /titanic_41/usr/src/man/man1/kvmstat.1 (revision fd13d7617c1038a3ce77d4c286a84df738b145f9)
1*fd13d761SRobert Mustacchi.\"
2*fd13d761SRobert Mustacchi.\" This file and its contents are supplied under the terms of the
3*fd13d761SRobert Mustacchi.\" Common Development and Distribution License ("CDDL"), version 1.0.
4*fd13d761SRobert Mustacchi.\" You may only use this file in accordance with the terms of version
5*fd13d761SRobert Mustacchi.\" 1.0 of the CDDL.
6*fd13d761SRobert Mustacchi.\"
7*fd13d761SRobert Mustacchi.\" A full copy of the text of the CDDL should have accompanied this
8*fd13d761SRobert Mustacchi.\" source.  A copy of the CDDL is also available via the Internet at
9*fd13d761SRobert Mustacchi.\" http://www.illumos.org/license/CDDL.
10*fd13d761SRobert Mustacchi.\"
11*fd13d761SRobert Mustacchi.\"
12*fd13d761SRobert Mustacchi.\" Copyright (c) 2014, Joyent, Inc.
13*fd13d761SRobert Mustacchi.\"
14*fd13d761SRobert Mustacchi.Dd Dec 20, 2014
15*fd13d761SRobert Mustacchi.Dt KVMSTAT 1
16*fd13d761SRobert Mustacchi.Os
17*fd13d761SRobert Mustacchi.Sh NAME
18*fd13d761SRobert Mustacchi.Nm kvmstat
19*fd13d761SRobert Mustacchi.Nd report KVM statistics
20*fd13d761SRobert Mustacchi.Sh SYNOPSIS
21*fd13d761SRobert Mustacchi.Nm kvmstat
22*fd13d761SRobert Mustacchi.Oo
23*fd13d761SRobert Mustacchi.Ar interval
24*fd13d761SRobert Mustacchi.Op Ar count
25*fd13d761SRobert Mustacchi.Oc
26*fd13d761SRobert Mustacchi.Sh DESCRIPTION
27*fd13d761SRobert Mustacchi.Nm
28*fd13d761SRobert Mustacchireports the activity of running KVM virtual machines and their exit activity,
29*fd13d761SRobert Mustacchiinjected interrupts, emulations, and more, on a per virtual CPU basis.
30*fd13d761SRobert Mustacchi.Lp
31*fd13d761SRobert Mustacchi.Nm
32*fd13d761SRobert Mustacchishould be used when trying to get a rough sense of guest activity from the
33*fd13d761SRobert Mustacchihypervisor's perspective, and allows one to understand from a low-level
34*fd13d761SRobert Mustacchiperspective, what kind of activity is going on inside of the virtual machine. In
35*fd13d761SRobert Mustacchiaddition,
36*fd13d761SRobert Mustacchi.Nm
37*fd13d761SRobert Mustacchiis useful for diagnosing reports of pathological or faulty behavior inside of
38*fd13d761SRobert Mustacchiguests. While there is no expected range of values for the fields displayed as
39*fd13d761SRobert Mustacchithat varies with the use of virtual machines, if all of the virtual CPUs for a
40*fd13d761SRobert Mustacchigiven virtual machine are consistently zero, then that may indicate that a
41*fd13d761SRobert Mustacchiproblem has occurred, for example, a panic inside of the guest or a bug in the
42*fd13d761SRobert Mustacchihypervisor.
43*fd13d761SRobert Mustacchi.Lp
44*fd13d761SRobert MustacchiIf no operands are specified, then
45*fd13d761SRobert Mustacchi.Nm
46*fd13d761SRobert Mustacchiwill display statistics every second until the program is terminated.
47*fd13d761SRobert Mustacchi.Ss Output Fields
48*fd13d761SRobert MustacchiEvery
49*fd13d761SRobert Mustacchi.Ar interval
50*fd13d761SRobert Mustacchi.Nm
51*fd13d761SRobert Mustacchiwill report data with the following fields:
52*fd13d761SRobert Mustacchi.Bl -tag -width Ds
53*fd13d761SRobert Mustacchi.It Nm pid
54*fd13d761SRobert MustacchiIdentifier of the process controlling the virtual CPU.
55*fd13d761SRobert Mustacchi.It Nm vcpu
56*fd13d761SRobert MustacchiVirtual CPU identifier relative to its virtual machine.
57*fd13d761SRobert Mustacchi.It Nm exits
58*fd13d761SRobert MustacchiCount of all virtual machine exits for the virtual CPU over
59*fd13d761SRobert Mustacchi.Ar interval .
60*fd13d761SRobert Mustacchi.It Nm haltx
61*fd13d761SRobert MustacchiCount of virtual machine exits due to the guest executing the
62*fd13d761SRobert Mustacchi.Sy HLT
63*fd13d761SRobert Mustacchiinstruction for the virtual CPU over
64*fd13d761SRobert Mustacchi.Ar interval .
65*fd13d761SRobert Mustacchi.It Nm irqx
66*fd13d761SRobert MustacchiCount of virtual machine exits due to a pending external interrupt arriving
67*fd13d761SRobert Mustacchion the physical CPU that the virtual CPU was actively running on over
68*fd13d761SRobert Mustacchi.Ar interval .
69*fd13d761SRobert Mustacchi.It Nm irqwx
70*fd13d761SRobert MustacchiCount of virtual machine exits due to an open interrupt window on the
71*fd13d761SRobert Mustacchivirtual CPU over
72*fd13d761SRobert Mustacchi.Ar interval .
73*fd13d761SRobert Mustacchi.It Nm iox
74*fd13d761SRobert MustacchiCount of virtual machine exits due to the execution of an I/O instruction,
75*fd13d761SRobert Mustacchisuch as
76*fd13d761SRobert Mustacchi.Sy inb ,
77*fd13d761SRobert Mustacchion the virtual CPU over
78*fd13d761SRobert Mustacchi.Ar interval .
79*fd13d761SRobert Mustacchi.It Nm mmiox
80*fd13d761SRobert MustacchiCount of virtual machine exits due to performing memory mapped I/O on the
81*fd13d761SRobert Mustacchivirtual CPU over
82*fd13d761SRobert Mustacchi.Ar interval .
83*fd13d761SRobert Mustacchi.It Nm irqs
84*fd13d761SRobert MustacchiCount of interrupts injected into the virtual CPU over
85*fd13d761SRobert Mustacchi.Ar interval .
86*fd13d761SRobert Mustacchi.It Nm emul
87*fd13d761SRobert MustacchiCount of instructions the hypervisor had to emulate on behalf of the guest
88*fd13d761SRobert Mustacchivirtual CPU over
89*fd13d761SRobert Mustacchi.Ar interval .
90*fd13d761SRobert Mustacchi.It Nm eptv
91*fd13d761SRobert MustacchiCount of extended page table violations serviced on the virtual CPU over
92*fd13d761SRobert Mustacchi.Ar interval .
93*fd13d761SRobert Mustacchi.El
94*fd13d761SRobert Mustacchi.Sh OPERANDS
95*fd13d761SRobert MustacchiThe following operands are supported:
96*fd13d761SRobert Mustacchi.Bl -hang -width Ds
97*fd13d761SRobert Mustacchi.It Ar count
98*fd13d761SRobert Mustacchi.Bd -filled -compact
99*fd13d761SRobert MustacchiSpecifies the number of times that the statistics are repeated. If not
100*fd13d761SRobert Mustacchispecified,
101*fd13d761SRobert Mustacchi.Nm
102*fd13d761SRobert Mustacchiwill continue until it is terminated.
103*fd13d761SRobert Mustacchi.Ed
104*fd13d761SRobert Mustacchi.It Ar interval
105*fd13d761SRobert Mustacchi.Bd -filled -compact
106*fd13d761SRobert MustacchiSpecifies the number of seconds between reports of statistics. If not specified,
107*fd13d761SRobert Mustacchireports are generated every second.
108*fd13d761SRobert Mustacchi.Ed
109*fd13d761SRobert Mustacchi.El
110*fd13d761SRobert Mustacchi.Sh STABILITY
111*fd13d761SRobert MustacchiThe arguments are
112*fd13d761SRobert Mustacchi.Sy committed ,
113*fd13d761SRobert Mustacchiwhile the output format is
114*fd13d761SRobert Mustacchi.Sy Not an interface .
115*fd13d761SRobert Mustacchi.Sh SEE ALSO
116*fd13d761SRobert Mustacchi.Xr iostat 1M ,
117*fd13d761SRobert Mustacchi.Xr mpstat 1M ,
118*fd13d761SRobert Mustacchi.Xr attributes 5
119