125 lines · plain
1kvm_stat(1)2===========3 4NAME5----6kvm_stat - Report KVM kernel module event counters7 8SYNOPSIS9--------10[verse]11'kvm_stat' [OPTION]...12 13DESCRIPTION14-----------15kvm_stat prints counts of KVM kernel module trace events. These events signify16state transitions such as guest mode entry and exit.17 18This tool is useful for observing guest behavior from the host perspective.19Often conclusions about performance or buggy behavior can be drawn from the20output.21While running in regular mode, use any of the keys listed in section22'Interactive Commands' below.23Use batch and logging modes for scripting purposes.24 25The set of KVM kernel module trace events may be specific to the kernel version26or architecture. It is best to check the KVM kernel module source code for the27meaning of events.28 29INTERACTIVE COMMANDS30--------------------31[horizontal]32*b*:: toggle events by guests (debugfs only, honors filters)33 34*c*:: clear filter35 36*f*:: filter by regular expression37 :: *Note*: Child events pull in their parents, and parents' stats summarize38 all child events, not just the filtered ones39 40*g*:: filter by guest name/PID41 42*h*:: display interactive commands reference43 44*o*:: toggle sorting order (Total vs CurAvg/s)45 46*p*:: filter by guest name/PID47 48*q*:: quit49 50*r*:: reset stats51 52*s*:: set delay between refreshs53 54*x*:: toggle reporting of stats for child trace events55 :: *Note*: The stats for the parents summarize the respective child trace56 events57 58Press any other key to refresh statistics immediately.59 60OPTIONS61-------62-1::63--once::64--batch::65 run in batch mode for one second66 67-c::68--csv::69 log in csv format. Requires option -l/--log or -L/--log-to-file.70 When used with option -L/--log-to-file, the header is only ever71 written to start of file to preserve the format.72 73-d::74--debugfs::75 retrieve statistics from debugfs76 77-f<fields>::78--fields=<fields>::79 fields to display (regex), "-f help" for a list of available events80 81-g<guest>::82--guest=<guest_name>::83 limit statistics to one virtual machine (guest name)84 85-h::86--help::87 show help message88 89-i::90--debugfs-include-past::91 include all available data on past events for debugfs92 93-l::94--log::95 run in logging mode (like vmstat)96 97 98-L<file>::99--log-to-file=<file>::100 like -l/--log, but logging to a file. Appends to existing files.101 102-p<pid>::103--pid=<pid>::104 limit statistics to one virtual machine (pid)105 106-s::107--set-delay::108 set delay between refreshs (value range: 0.1-25.5 secs)109 110-t::111--tracepoints::112 retrieve statistics from tracepoints113 114-z::115--skip-zero-records::116 omit records with all zeros in logging mode117 118SEE ALSO119--------120'perf'(1), 'trace-cmd'(1)121 122AUTHOR123------124Stefan Hajnoczi <stefanha@redhat.com>125