forked from Qortal/Brooklyn
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
124 lines
2.7 KiB
124 lines
2.7 KiB
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 <[email protected]>
|
|
|