From c1be22f971e3aa58afada294066c7636ad624db4 Mon Sep 17 00:00:00 2001 From: Viktor Mihajlovski Date: Thu, 13 Oct 2016 13:42:47 +0200 Subject: [PATCH] doc: update virsh domstats documentation for vcpu statistics Added description for new vcpu..halted statistics value. While there, also added a description for vcpu..wait and clarified the units displayed for time and wait. Signed-off-by: Viktor Mihajlovski Reviewed-by: Bjoern Walk --- tools/virsh.pod | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/tools/virsh.pod b/tools/virsh.pod index a18eaf4c28..62c592cf62 100644 --- a/tools/virsh.pod +++ b/tools/virsh.pod @@ -887,6 +887,9 @@ default all supported statistics groups are returned. Supported statistics groups flags are: I<--state>, I<--cpu-total>, I<--balloon>, I<--vcpu>, I<--interface>, I<--block>, I<--perf>. +Note that - depending on the hypervisor type and version or the domain state +- not all of the following statistics may be returned. + When selecting the I<--state> group the following fields are returned: "state.state" - state of the VM, returned as number from virDomainState enum, "state.reason" - reason for entering given state, returned as int from @@ -917,6 +920,11 @@ I<--vcpu> returns: "vcpu..state" - state of the virtual CPU , as number from virVcpuState enum, "vcpu..time" - virtual cpu time spent by virtual CPU + (in microseconds), +"vcpu..wait" - virtual cpu time spent by virtual CPU +waiting on I/O (in microseconds), +"vcpu..halted" - virtual CPU is halted: yes or no (may indicate +the processor is idle or even disabled, depending on the architecture) I<--interface> returns: "net.count" - number of network interfaces on this domain, -- 2.47.2