hpvmsar — Display statistics about running virtual machines.
-
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. EXAMPLES The following examples displays data about all running guests at the rate of every 5 seconds: # hpvmsar -s 5 -a The following example displays data for all guests, even those not running, in the cumulative view: # hpvmsar -m 1 -A 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)
© Lightnetics 2024