2016-05-24 10:41:15 +02:00
|
|
|
kvm_stat(1)
|
|
|
|
===========
|
|
|
|
|
|
|
|
NAME
|
|
|
|
----
|
|
|
|
kvm_stat - Report KVM kernel module event counters
|
|
|
|
|
|
|
|
SYNOPSIS
|
|
|
|
--------
|
|
|
|
[verse]
|
|
|
|
'kvm_stat' [OPTION]...
|
|
|
|
|
|
|
|
DESCRIPTION
|
|
|
|
-----------
|
|
|
|
kvm_stat prints counts of KVM kernel module trace events. These events signify
|
|
|
|
state transitions such as guest mode entry and exit.
|
|
|
|
|
|
|
|
This tool is useful for observing guest behavior from the host perspective.
|
|
|
|
Often conclusions about performance or buggy behavior can be drawn from the
|
|
|
|
output.
|
2017-03-10 13:40:07 +01:00
|
|
|
While running in regular mode, use any of the keys listed in section
|
|
|
|
'Interactive Commands' below.
|
|
|
|
Use batch and logging modes for scripting purposes.
|
2016-05-24 10:41:15 +02:00
|
|
|
|
|
|
|
The set of KVM kernel module trace events may be specific to the kernel version
|
|
|
|
or architecture. It is best to check the KVM kernel module source code for the
|
|
|
|
meaning of events.
|
|
|
|
|
2017-03-10 13:40:07 +01:00
|
|
|
INTERACTIVE COMMANDS
|
|
|
|
--------------------
|
|
|
|
[horizontal]
|
2017-06-25 21:34:16 +02:00
|
|
|
*b*:: toggle events by guests (debugfs only, honors filters)
|
|
|
|
|
2017-03-10 13:40:14 +01:00
|
|
|
*c*:: clear filter
|
|
|
|
|
2017-03-10 13:40:07 +01:00
|
|
|
*f*:: filter by regular expression
|
2019-04-21 15:26:24 +02:00
|
|
|
:: *Note*: Child events pull in their parents, and parents' stats summarize
|
|
|
|
all child events, not just the filtered ones
|
2017-03-10 13:40:07 +01:00
|
|
|
|
2018-02-22 12:16:27 +01:00
|
|
|
*g*:: filter by guest name/PID
|
2017-03-10 13:40:13 +01:00
|
|
|
|
2017-06-07 21:08:38 +02:00
|
|
|
*h*:: display interactive commands reference
|
|
|
|
|
2017-06-07 21:08:41 +02:00
|
|
|
*o*:: toggle sorting order (Total vs CurAvg/s)
|
|
|
|
|
2018-02-22 12:16:27 +01:00
|
|
|
*p*:: filter by guest name/PID
|
2017-03-10 13:40:07 +01:00
|
|
|
|
|
|
|
*q*:: quit
|
|
|
|
|
2017-03-10 13:40:15 +01:00
|
|
|
*r*:: reset stats
|
|
|
|
|
2017-06-07 21:08:39 +02:00
|
|
|
*s*:: set update interval
|
|
|
|
|
2017-03-10 13:40:07 +01:00
|
|
|
*x*:: toggle reporting of stats for child trace events
|
2017-12-11 12:25:23 +01:00
|
|
|
:: *Note*: The stats for the parents summarize the respective child trace
|
|
|
|
events
|
2017-03-10 13:40:07 +01:00
|
|
|
|
|
|
|
Press any other key to refresh statistics immediately.
|
|
|
|
|
2016-05-24 10:41:15 +02:00
|
|
|
OPTIONS
|
|
|
|
-------
|
|
|
|
-1::
|
|
|
|
--once::
|
|
|
|
--batch::
|
|
|
|
run in batch mode for one second
|
|
|
|
|
|
|
|
-l::
|
|
|
|
--log::
|
|
|
|
run in logging mode (like vmstat)
|
|
|
|
|
|
|
|
-t::
|
|
|
|
--tracepoints::
|
|
|
|
retrieve statistics from tracepoints
|
|
|
|
|
|
|
|
-d::
|
|
|
|
--debugfs::
|
|
|
|
retrieve statistics from debugfs
|
|
|
|
|
2017-06-25 21:34:15 +02:00
|
|
|
-i::
|
|
|
|
--debugfs-include-past::
|
|
|
|
include all available data on past events for debugfs
|
|
|
|
|
2016-05-18 13:26:24 +02:00
|
|
|
-p<pid>::
|
|
|
|
--pid=<pid>::
|
|
|
|
limit statistics to one virtual machine (pid)
|
|
|
|
|
2017-03-10 13:40:13 +01:00
|
|
|
-g<guest>::
|
|
|
|
--guest=<guest_name>::
|
|
|
|
limit statistics to one virtual machine (guest name)
|
|
|
|
|
2016-05-24 10:41:15 +02:00
|
|
|
-f<fields>::
|
|
|
|
--fields=<fields>::
|
2017-12-11 12:25:24 +01:00
|
|
|
fields to display (regex), "-f help" for a list of available events
|
2016-05-24 10:41:15 +02:00
|
|
|
|
|
|
|
-h::
|
|
|
|
--help::
|
|
|
|
show help message
|
|
|
|
|
|
|
|
SEE ALSO
|
|
|
|
--------
|
|
|
|
'perf'(1), 'trace-cmd'(1)
|
|
|
|
|
|
|
|
AUTHOR
|
|
|
|
------
|
|
|
|
Stefan Hajnoczi <stefanha@redhat.com>
|