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 through all available modes. The following modes
are provided:
0: Stacked up values — Stacks up busy time,
idle time, and wait time vertically. Busy time is on the bottom and
wait time is on the top of the column.
1: Cumulative view — Stacks the busy time of
multiple guests from the left of the window and the wait time of multiple
guests from the right of the window. This mode makes it possible to
see how multiple guest share the total available host time.
2: History — Displays a graph of historical
values for busy and wait time, showing the evolution of these values
over time.
3: Raw data — Displays one bar for each individual
value.
- [-a | -A | vm-name ...]
The -a option displays only running guests. The -A option
displays all guests, including those that are not running. If you
specify a virutal machine name, hpvmsar displays
information about the specified virtual machine.
RETURN VALUES
The hpvmsar command exits
with one of the following values:
- 0: Successful completion.
- 1: One or more error
conditions occurred.
DIAGNOSTICS
The hpvmsar command displays
the following messages:
Invalid display mode x
(max y): The display mode is not supported by this version of hpvmsar.
Missing argument to option
(followed by usage): A required argument was not provided.
Missing option (followed
by usage): An option was not recognized.
Nothing to display, exiting:
No -a specified and no guest either.
Unable to find guest X:
The guest name is not spelled correctly.
Unable to allocate memory
for history: Really low memory on the VM Host.
AUTHORS
The hpvmsar command was developed
by HP.
SEE ALSO
On the VM Host:
hpvm(5), hpvmclone(1M), hpvmcollect(1M), hpvmconsole(1M), hpvmcreate(1M), hpvmdevmgmt(1M), hpvmdevtranslate(1M), hpvmhostrdev(1M)hpvminfo(1M), hpvmmigrate(1M), hpvmmodify(1M), hpvmnet(1M), hpvmpubapi(3), hpvmremove(1M), hpvmresources(5), hpvmstatus(1M), hpvmstop(1M), hpvmupgrade(1M)p2vassist(1M)
On the Integrity VM guest:
hpvmcollect(1M), hpvminfo(1M), hpvmmgmt(1M), hpvmpubapi(3)
Printable version
