[Docs] kvm plugin documentation
This patch adds usage docs for the kvm plugin. Change-Id: I6a28ae46f10bf97bcbe504e40353a2b0f3f8fe87
This commit is contained in:
parent
20cd4f08c2
commit
137a0f5cf9
|
@ -0,0 +1,41 @@
|
||||||
|
``kvm`` - get details from running KVM instances
|
||||||
|
================================================
|
||||||
|
|
||||||
|
The KVM plugin connects to libvirt and retrieves details about KVM instances on
|
||||||
|
the system. It returns basic information, including:
|
||||||
|
|
||||||
|
* number of instances on the host (``kvm_vms``)
|
||||||
|
* total number of virtual CPUs that libvirt can use (``kvm_total_vcpus``)
|
||||||
|
* the total number of virtual CPUs scheduled (``kvm_scheduled_vcpus``)
|
||||||
|
|
||||||
|
Usage
|
||||||
|
-----
|
||||||
|
|
||||||
|
This plugin takes no arguments.
|
||||||
|
|
||||||
|
Example
|
||||||
|
-------
|
||||||
|
|
||||||
|
Run the plugin:
|
||||||
|
|
||||||
|
.. code-block:: console
|
||||||
|
|
||||||
|
$ monitorstack kvm
|
||||||
|
|
||||||
|
Example output in JSON format:
|
||||||
|
|
||||||
|
.. code-block:: json
|
||||||
|
|
||||||
|
{
|
||||||
|
"variables": {
|
||||||
|
"kvm_vms": 1,
|
||||||
|
"kvm_scheduled_vcpus": 2,
|
||||||
|
"kvm_total_vcpus": 4
|
||||||
|
},
|
||||||
|
"meta": {
|
||||||
|
"kvm_host_id": 2046744907101423228
|
||||||
|
},
|
||||||
|
"message": "kvm is ok",
|
||||||
|
"exit_code": 0,
|
||||||
|
"measurement_name": "kvm"
|
||||||
|
}
|
Loading…
Reference in New Issue