pstat

Parallels Cloud Server real-time monitoring utility. Displays the status and load of the system, including disk, network, CPU, and memory parameters (swap included). The status is updated in a preset time interval. pstat also provides a sortable list of running virtual machines and Containers together with their resources consumption statistics. Utility's display output can be customized.

Syntax

pstat [ -l ] [ -d <X> ] [ -p <CT_ID> ] [ -b | -v ] [ -t ] [ -a ]

Options

Name	Description
-l	Print information once and exit immediately.
-d `<X>`	Specify the delay between screen updates. Can be changed on the fly by the `t` interactive command. Default is 1 sec.
-p `<CT_ID>`	Monitor only Containers with the specified `CT_IDs` . This flag can be given up to twenty times as follows: `-p` `CT_ID` `1 -p` `CT_ID` `2 [...]` . This option is not available interactively.
-b	"Brief" mode. Minimal details level. Shows only one summary line about each monitoring subsystem. By default, "standard" details level is in use. Valid levels are "brief", "standard" and "verbose". Can be set on the fly by the `b` interactive command. See also the `-v` command-line option and `s` and `v` interactive commands.
-v	"Verbose" mode. Provides maximum details about all monitored subsystems. Can be set on the fly by the `v` interactive command. See also the `-b` command-line option and `b` and `s` interactive commands.
-t	Text mode, provides information once. It is printed in terse form, suitable for parsing by other programs. All output data are not aligned and numbers are not in a human readable format. In the text mode, there are no colors in the output and only the top 10 Containers sorted by their CPU usage are shown.
-a	Display the current disk input and output (I/O) statistics for virtual machines and Containers.
-i	Display the IO accounting information for virtual machines and Containers.
-m	Display disc statistics for all file system types. By default, the statistics is shown for ext2, ext3, ext4, and reiserfs.
-o	Filter the output by the specified parameters. You can specify multiple parameters and separate them by commas. The list of available parameters is given below.
-O	Filter the output by the specified parameters. Unlike the `-o` option, the produced output already contains some default columns (for example, Container ID and IP address). The list of available parameters is given below.
-n	Display network statistics.
-s	Filter the output by the specified keys. The list of available parameters is given below.
-c	Display I/O statistics in the specified units of measurement: `B` (bytes), `K` (kilobytes), `M` (megabytes), or `G` (gigabytes).

You can use the following parameters with the -o , -O , and -s options to filter the information related to virtual machines and Containers:

Name	Column	Description
id	`CTID`	virtual machine or Container ID
st	`ST`	virtual machine or Container status.
vm	`%VM`	Virtual memory usage, in per cent of the total memory on the Node. It's displayed in the form of "actual usage/barrier". This parameter corresponds to the `PHYSPAGES` VSwap parameter.
km	`%KM`	Kernel memory usage, in per cent of the normal zone size. It's displayed in the form of "actual usage/barrier". This parameter corresponds to the `kmemsize` UBC parameter.
sw	`%SW`	Swap space usage, in per cent of the total swap space on the Node. It's displayed in the form of "actual usage/barrier". This parameter corresponds to the `SWAPPAGES` VSwap parameter.
swapin	`SWAPIN`	I/O operations with the swap space, in operations per second.
proc	`PROC`	Process information. It's displayed in the form of "running processes/total processes/barrier".
cpu	`CPU`	CPU usage. It's displayed in the form of "actual CPU usage/guaranteed CPU usage". If more than one processor is installed on the server, all processors are considered as 100%.
cpu_iowait	`CPU IOWAIT`	Percentage of time that Container processes lost waiting for I/O.
cpu_iowait_acc	`ACC IOWAIT`	Percentage of time that Container processes lost waiting for I/O, accumulated since utility start.
sock	`SOCK`	Sockets usage calculated as the sum of UBC numtcpsock and numothersock parameters. It's displayed in the form of "open sockets/barrier".
fcnt	`FCNT`	Fail counters—that is, the number of UBC fail counters for all resources.
mlat	`MLAT`	Maximum process scheduling latency, in milliseconds. In this case, the latency means the maximum time a process in a virtual machine or Container is waiting for the CPU.
io	`IO`	I/O rate and limit, in bytes, kilobytes, megabytes, or gigabytes per second.
iops	`IOPS`	I/O operations rate and limit, in operations per second.
iow	`IOW`	Transfer rate at which data is written to the virtual machine or Container.
ior	`IOR`	Transfer rate at which data is read from the virtual machine or Container.
iowt	`IOWT`	Total amount of data that was written to the virtual machine or Container.
iort	`IORT`	Total amount of data that was read from the virtual machine or Container.
ios	`IOS`	Synchronization rate.
iod	`IOD`	Flushing rate of dirty pages (pages that have been changed but are not yet written to the virtual machine or Container disk).
ioused	`IOUSED%`	Percentage of time the disks are used by the virtual machine or Container.
iowait	`IOWAIT%`	Percentage of time when at least one I/O transaction in the virtual machine or Container is waiting for being served.
rx	`RX`	Incoming traffic rate, in megabytes per second.
tx	`TX`	Outgoing traffic, in megabytes per second.
rxt	`RXT`	Total amount of incoming traffic, in megabytes.
txt	`TXT`	Total amount of outgoing traffic, in megabytes.
rxp	`RXP`	Incoming traffic, in packets per second.
txp	`TXPT`	Outgoing traffic, in packets per second.
rxpt	`RXPT`	Total amount of incoming packets.
txpt	`TXPT`	Total amount of outgoing packets.

Top of page

Feedback