Re: [PATCH v2 0/5] Improve KVM per VM monitoring

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 




On 18/05/2016 13:26, Janosch Frank wrote:
> This patchset introduces KVM per VM exit statistics monitoring via
> debugfs, as well as moves a tool to display VM statistics from qemu to
> tools/.
> 
> The new debugfs per VM statistics are an alternative to the already
> available VM tracepoints. They are easier to read and have low
> overhead.
> 
> The kvm_stat python script is moved to the kernel, as we can make sure
> here that the right version of the script is used with the right
> kernel version. This is not given for qemu, as it supports a wide
> range of linux kernel versions.

The patches look good, but you are not moving over the documentation.

I started looking at asciidoc, but perf's documentation Makefiles seem
to be overkill for our purposes.  (My prototype conversion of the docs
to asciidoc after my signature).

Perhaps pod2man could be an alternative (using QEMU's texi2pod to
build the kvm_stat.pod input)?

Paolo


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.

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.

Note that trace events are counted globally across all running guests.

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

-f<fields>::
--fields=<fields>::
	fields to display (regex)

-h::
--help::

  show help message

SEE ALSO
--------
perf(1), trace-cmd(1)

AUTHOR
------
Stefan Hajnoczi <stefanha@xxxxxxxxxx>

--
To unsubscribe from this list: send the line "unsubscribe kvm" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html



[Index of Archives]     [KVM ARM]     [KVM ia64]     [KVM ppc]     [Virtualization Tools]     [Spice Development]     [Libvirt]     [Libvirt Users]     [Linux USB Devel]     [Linux Audio Users]     [Yosemite Questions]     [Linux Kernel]     [Linux SCSI]     [XFree86]
  Powered by Linux