HP Integrity Virtual Machines 4.2: Installation, Configuration, and Administration

hpvmsar(1M)
NAME
hpvmsar -- Display statistics about running virtual machines.
SYNOPSIS
hpvmsar [-s rate ] [-n count ] [-h rate] [-M] [-m mode] [ -a | -A | vm-name ... ]
DESCRIPTION
The hpvmsar command displays statistics, such as CPU utilization, for running virtual machines.
The command displays the statistics graphically using X11 when the DISPLAY environment is
defined; otherwise it displays them as text.
With the -a option, the hpvmsar command displays information about all running guests. The
display is reformatted as guests are started or stopped.
With the -A option, the hpvmsar command displays information about all guests, whether they
are running or not. Guests that are not running display as blank entries. Without these options,
the hpvmsar command displays information about the specified virtual machines.
In graphical mode, the hpvmsar command displays information using the following conventions:
• Blue: Busy time — which counts whenever the guest runs. It includes the time necessary to
run the guest operating system, guest applications, and virtual machine monitor on behalf
of the guest.
• Green: Idle time — which counts when the guest has no activity and the CPU was returned
to the host. The same time may be counted as idle in multiple guest simultaneously, therefore,
the sum of idle times may exceed 100%.
• Orange: Wait time — which counts when the guest was pre-empted but had some activity
pending. It indicates that the guest could have used the time, but was prevented, because
it was pre-empted.
• Grey: Host time — which counts when the host is running, as seen from the guest's point
of view. Under normal conditions, host time is approximately the sum of idle time and wait
time. Differences may arise when context switch time or interrupt time becomes significant.
Options
The hpvmsar command recognizes the following command-line options and arguments:
-s rate Collects and displays data every rate seconds. The default
is 1 second.
-n count
Counts how many samples are taken, with zero (0) indicating
to sample forever. The default is 5 samples in text mode and
0 (infinity) in graphical mode.
-h rate
In text mode, sets how frequently the header is displayed.
Header information indicates that each column of text
represents. The default is to display the header every 8th
sample
-M
Displays separate information for each virtual CPU (vCPU)
individually. By default, it is displayed per guest, as an
average of all vCPUs.
-m mode When displaying information graphically, hpvmsar offers
multiple viewing modes. The initial mode is selected using
the -m option, with the default being mode 0, stacked up.
This option has no effect if DISPLAY is not set. The display
mode can be changed by pressing any key and cycles
295