4.1.8. prlctl statistics

Print statistics for running containers on the server.

Syntax. 

prlctl statistics {<CT_UUID_or_name>|-a, --all} [--loop] [--filter <filter>]

Table 4.8. Options

NameDescription

`-a, --all

Print statistics for all virtual machines and containers on the server.

--loop

Print statistics every second until the program is terminated.

--filter &lt;pattern&gt;

Specifies the subset of performance statistics to collect and print. If omitted, all available statistics is shown. Asterisks (*) can be used as wildcards for any number of arbitrary characters. The available filters are listed below (&lt;N&gt; is the device or filesystem index).

Storage device statistics

  • devices.{ide

scsi

sata}<N>.read_requests - Total count of read requests to IDE, SCSI, or SATA controller * devices.{ide

scsi

sata}<N>.read_total - Total count of read bytes for IDE, SCSI, or SATA controller * devices.{ide

scsi

sata}<N>.write_requests - Total count of write requests to IDE, SCSI, or SATA controller * devices.{ide

scsi

sata}<N>.write_total - Total count of written bytes for IDE, SCSI, or SATA controller

Network statistics

  • net.nic<N>.pkts_in - Total number of incoming packets for network adapter
  • net.nic<N>.pkts_out - Total number of outgoing packets for network adapter
  • net.nic<N>.bytes_in - Total number of incoming bytes for network adapter
  • net.nic<N>.bytes_out - Total number of outgoing bytes for network adapter

Classful network statistics

The result is provided in five columns: Class, Input(bytes), Input(packets), Output(bytes), Output(packets).

  • net.classful.traffic - Total counters for IPv4 and IPv6 traffic
  • net.classful.traffic.ipv4 - Counters for IPv4 traffic
  • net.classful.traffic.ipv6 - Counters for IPv6 traffic

CPU statistics

  • guest.cpu.usage - Guest OS CPU usage, in percent
  • guest.cpu.time - Sum of guest CPU time differences since the last query for each vCPU averaged by the number of host CPUs, in microseconds
  • host.cpu.time - Sum of host CPU time differences since the last query for each vCPU averaged by the number of host CPUs, in microseconds
  • guest.vcpu<N>.time - per-vCPU statistics, in nanoseconds

RAM statistics

  • guest.ram.usage - Guest OS used RAM, in MiB
  • guest.ram.cached - Guest OS cached RAM, in MiB
  • guest.ram.total - Guest OS total RAM, in MiB
  • guest.ram.swap_in - Guest OS virtual memory stats, in counts
  • guest.ram.swap_out - Guest OS virtual memory stats, in counts
  • guest.ram.minor_fault - Guest OS minor page fault count
  • guest.ram.major_fault - Guest OS major page fault count
  • guest.ram.balloon_actual - Guest OS balloon size, in MiB

Mounted filesystems statistics

  • guest.fs<N>.name - Device name as seen from inside the guest filesystem
  • guest.fs<N>.total - Total size of the filesystem, in KiB
  • guest.fs<N>.free - Amount of free space on the filesystem, in KiB
  • guest.fs<N>.disk.<N> - Disk indices