1kvm_stat(1) 2=========== 3 4NAME 5---- 6kvm_stat - Report KVM kernel module event counters 7 8SYNOPSIS 9-------- 10[verse] 11'kvm_stat' [OPTION]... 12 13DESCRIPTION 14----------- 15kvm_stat prints counts of KVM kernel module trace events. These events signify 16state 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 the 20output. 21While running in regular mode, use any of the keys listed in section 22'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 version 26or architecture. It is best to check the KVM kernel module source code for the 27meaning of events. 28 29INTERACTIVE COMMANDS 30-------------------- 31[horizontal] 32*b*:: toggle events by guests (debugfs only, honors filters) 33 34*c*:: clear filter 35 36*f*:: filter by regular expression 37 :: *Note*: Child events pull in their parents, and parents' stats summarize 38 all child events, not just the filtered ones 39 40*g*:: filter by guest name/PID 41 42*h*:: display interactive commands reference 43 44*o*:: toggle sorting order (Total vs CurAvg/s) 45 46*p*:: filter by guest name/PID 47 48*q*:: quit 49 50*r*:: reset stats 51 52*s*:: set update interval 53 54*x*:: toggle reporting of stats for child trace events 55 :: *Note*: The stats for the parents summarize the respective child trace 56 events 57 58Press any other key to refresh statistics immediately. 59 60OPTIONS 61------- 62-1:: 63--once:: 64--batch:: 65 run in batch mode for one second 66 67-l:: 68--log:: 69 run in logging mode (like vmstat) 70 71-t:: 72--tracepoints:: 73 retrieve statistics from tracepoints 74 75-d:: 76--debugfs:: 77 retrieve statistics from debugfs 78 79-i:: 80--debugfs-include-past:: 81 include all available data on past events for debugfs 82 83-p<pid>:: 84--pid=<pid>:: 85 limit statistics to one virtual machine (pid) 86 87-g<guest>:: 88--guest=<guest_name>:: 89 limit statistics to one virtual machine (guest name) 90 91-f<fields>:: 92--fields=<fields>:: 93 fields to display (regex), "-f help" for a list of available events 94 95-h:: 96--help:: 97 show help message 98 99SEE ALSO 100-------- 101'perf'(1), 'trace-cmd'(1) 102 103AUTHOR 104------ 105Stefan Hajnoczi <stefanha@redhat.com> 106