125 lines
2.7 KiB
Plaintext
125 lines
2.7 KiB
Plaintext
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.
|
|
While running in regular mode, use any of the keys listed in section
|
|
'Interactive Commands' below.
|
|
Use batch and logging modes for scripting purposes.
|
|
|
|
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.
|
|
|
|
INTERACTIVE COMMANDS
|
|
--------------------
|
|
[horizontal]
|
|
*b*:: toggle events by guests (debugfs only, honors filters)
|
|
|
|
*c*:: clear filter
|
|
|
|
*f*:: filter by regular expression
|
|
:: *Note*: Child events pull in their parents, and parents' stats summarize
|
|
all child events, not just the filtered ones
|
|
|
|
*g*:: filter by guest name/PID
|
|
|
|
*h*:: display interactive commands reference
|
|
|
|
*o*:: toggle sorting order (Total vs CurAvg/s)
|
|
|
|
*p*:: filter by guest name/PID
|
|
|
|
*q*:: quit
|
|
|
|
*r*:: reset stats
|
|
|
|
*s*:: set delay between refreshs
|
|
|
|
*x*:: toggle reporting of stats for child trace events
|
|
:: *Note*: The stats for the parents summarize the respective child trace
|
|
events
|
|
|
|
Press any other key to refresh statistics immediately.
|
|
|
|
OPTIONS
|
|
-------
|
|
-1::
|
|
--once::
|
|
--batch::
|
|
run in batch mode for one second
|
|
|
|
-c::
|
|
--csv::
|
|
log in csv format. Requires option -l/--log or -L/--log-to-file.
|
|
When used with option -L/--log-to-file, the header is only ever
|
|
written to start of file to preserve the format.
|
|
|
|
-d::
|
|
--debugfs::
|
|
retrieve statistics from debugfs
|
|
|
|
-f<fields>::
|
|
--fields=<fields>::
|
|
fields to display (regex), "-f help" for a list of available events
|
|
|
|
-g<guest>::
|
|
--guest=<guest_name>::
|
|
limit statistics to one virtual machine (guest name)
|
|
|
|
-h::
|
|
--help::
|
|
show help message
|
|
|
|
-i::
|
|
--debugfs-include-past::
|
|
include all available data on past events for debugfs
|
|
|
|
-l::
|
|
--log::
|
|
run in logging mode (like vmstat)
|
|
|
|
|
|
-L<file>::
|
|
--log-to-file=<file>::
|
|
like -l/--log, but logging to a file. Appends to existing files.
|
|
|
|
-p<pid>::
|
|
--pid=<pid>::
|
|
limit statistics to one virtual machine (pid)
|
|
|
|
-s::
|
|
--set-delay::
|
|
set delay between refreshs (value range: 0.1-25.5 secs)
|
|
|
|
-t::
|
|
--tracepoints::
|
|
retrieve statistics from tracepoints
|
|
|
|
*z*::
|
|
--skip-zero-records::
|
|
omit records with all zeros in logging mode
|
|
|
|
SEE ALSO
|
|
--------
|
|
'perf'(1), 'trace-cmd'(1)
|
|
|
|
AUTHOR
|
|
------
|
|
Stefan Hajnoczi <stefanha@redhat.com>
|