This document provides a comprehensive reference of all metrics collected by proxtop, organized by collector. Each metric includes its data source, description, collection cycle, and availability mode.
| Symbol | Meaning |
|---|---|
| ๐ lookup | Metric is collected during the lookup phase (VM discovery) |
| ๐ collect | Metric is collected during the collect phase (periodic sampling) |
| ๐ verbose | Only available with --verbose flag |
| ๐ internal | Internal metric, not exported but used for calculations |
| Requires root/sudo privileges |
- Base VM Metrics
- CPU Collector
- Memory Collector
- Network Collector
- Disk Collector
- I/O Collector
- Host Collector
- PSI Collector
- Metric Calculations
These metrics are always collected for each virtual machine, regardless of which collectors are enabled.
| Metric | Source | Description | Unit |
|---|---|---|---|
UUID |
libvirt/QMP | Unique identifier for the virtual machine | string |
name |
libvirt/QMP | Human-readable name of the virtual machine | string |
PID |
/proc | Process ID of the QEMU process on the host | integer |
Monitors CPU utilization, frequency, and steal time for both the host and virtual machines.
| Metric | Source | Description | Unit | Cycle |
|---|---|---|---|---|
cpu_cores |
/proc/cpuinfo | Total number of physical CPU cores | count | ๐ lookup |
cpu_curfreq |
/sys/devices/system/cpu/cpu*/cpufreq | Current mean frequency across all CPU cores | MHz | ๐ lookup |
cpu_user |
/proc/stat | Time spent executing user-space processes | % | ๐ collect |
cpu_system |
/proc/stat | Time spent executing kernel-space code | % | ๐ collect |
cpu_idle |
/proc/stat | Time spent idle (no tasks running) | % | ๐ collect |
cpu_steal |
/proc/stat | Time stolen by hypervisor for other VMs | % | ๐ collect |
| Metric | Source | Description | Unit | Cycle |
|---|---|---|---|---|
cpu_minfreq |
/sys/devices/system/cpu/cpu*/cpufreq | Minimum supported CPU frequency | MHz | ๐ lookup |
cpu_maxfreq |
/sys/devices/system/cpu/cpu*/cpufreq | Maximum supported CPU frequency | MHz | ๐ lookup |
cpu_nice |
/proc/stat | Time spent on niced (low priority) user processes | % | ๐ collect |
cpu_iowait |
/proc/stat | Time spent waiting for I/O completion | % | ๐ collect |
cpu_irq |
/proc/stat | Time spent handling hardware interrupts | % | ๐ collect |
cpu_softirq |
/proc/stat | Time spent handling software interrupts | % | ๐ collect |
cpu_guest |
/proc/stat | Time spent running guest VMs | % | ๐ collect |
cpu_guestnice |
/proc/stat | Time spent running niced guest VMs | % | ๐ collect |
| Metric | Source | Description | Unit | Cycle |
|---|---|---|---|---|
cpu_cores |
libvirt/QMP | Number of virtual CPU cores assigned to VM | count | ๐ lookup |
cpu_total |
calculated | Total CPU utilization across all vCPUs | % | ๐ collect |
cpu_steal |
calculated | CPU time stolen due to host contention | % | ๐ collect |
| Metric | Source | Description | Unit | Cycle |
|---|---|---|---|---|
cpu_other_total |
calculated | CPU overhead from I/O and emulation threads | % | ๐ collect |
cpu_other_steal |
calculated | Steal time for overhead threads | % | ๐ collect |
| Metric | Source | Description | Cycle |
|---|---|---|---|
cpu_threadIDs |
libvirt + /proc | List of thread IDs for vCPU threads | ๐ lookup |
cpu_otherThreadIDs |
libvirt + /proc | List of thread IDs for non-vCPU threads | ๐ lookup |
cpu_times_${pid} |
/proc/${pid}/schedstat | CPU time counter for each vCPU thread | ๐ collect |
cpu_runqueues_${pid} |
/proc/${pid}/schedstat | Run queue wait time for each vCPU thread | ๐ collect |
cpu_other_times_${pid} |
/proc/${pid}/schedstat | CPU time for overhead threads | ๐ collect |
cpu_other_runqueues_${pid} |
/proc/${pid}/schedstat | Run queue wait for overhead threads | ๐ collect |
Monitors memory allocation, usage, and page faults.
| Metric | Source | Description | Unit | Cycle |
|---|---|---|---|---|
ram_Total |
/proc/meminfo | Total physical RAM installed | KB | ๐ collect |
ram_Free |
/proc/meminfo | Completely unused RAM | KB | ๐ collect |
ram_Available |
/proc/meminfo | RAM available for new allocations | KB | ๐ collect |
| Metric | Source | Description | Unit | Cycle |
|---|---|---|---|---|
ram_Buffers |
/proc/meminfo | Memory used for kernel buffers | KB | ๐ collect |
ram_Cached |
/proc/meminfo | Memory used for page cache | KB | ๐ collect |
ram_SwapCached |
/proc/meminfo | Swap memory also in RAM | KB | ๐ collect |
ram_Active |
/proc/meminfo | Recently used memory | KB | ๐ collect |
ram_Inactive |
/proc/meminfo | Less recently used memory | KB | ๐ collect |
ram_ActiveAnon |
/proc/meminfo | Active anonymous memory | KB | ๐ collect |
ram_InactiveAnon |
/proc/meminfo | Inactive anonymous memory | KB | ๐ collect |
ram_ActiveFile |
/proc/meminfo | Active file-backed memory | KB | ๐ collect |
ram_InactiveFile |
/proc/meminfo | Inactive file-backed memory | KB | ๐ collect |
ram_Unevictable |
/proc/meminfo | Memory that cannot be reclaimed | KB | ๐ collect |
ram_Mlocked |
/proc/meminfo | Memory locked with mlock() | KB | ๐ collect |
ram_SwapTotal |
/proc/meminfo | Total swap space | KB | ๐ collect |
ram_SwapFree |
/proc/meminfo | Unused swap space | KB | ๐ collect |
ram_Dirty |
/proc/meminfo | Memory waiting to be written to disk | KB | ๐ collect |
ram_Writeback |
/proc/meminfo | Memory actively being written to disk | KB | ๐ collect |
ram_AnonPages |
/proc/meminfo | Anonymous mapped memory | KB | ๐ collect |
ram_Mapped |
/proc/meminfo | Files mapped into memory | KB | ๐ collect |
ram_Shmem |
/proc/meminfo | Shared memory (tmpfs, etc.) | KB | ๐ collect |
ram_Slab |
/proc/meminfo | Kernel slab allocator memory | KB | ๐ collect |
ram_SReclaimable |
/proc/meminfo | Reclaimable slab memory | KB | ๐ collect |
ram_SUnreclaim |
/proc/meminfo | Non-reclaimable slab memory | KB | ๐ collect |
ram_KernelStack |
/proc/meminfo | Kernel stack memory | KB | ๐ collect |
ram_PageTables |
/proc/meminfo | Memory for page tables | KB | ๐ collect |
ram_NFSUnstable |
/proc/meminfo | NFS pages not yet committed | KB | ๐ collect |
ram_Bounce |
/proc/meminfo | Bounce buffer memory | KB | ๐ collect |
ram_WritebackTmp |
/proc/meminfo | Temporary writeback memory | KB | ๐ collect |
ram_CommitLimit |
/proc/meminfo | Total memory available for allocation | KB | ๐ collect |
ram_CommittedAS |
/proc/meminfo | Total memory committed | KB | ๐ collect |
ram_VmallocTotal |
/proc/meminfo | Total vmalloc address space | KB | ๐ collect |
ram_VmallocUsed |
/proc/meminfo | Used vmalloc space | KB | ๐ collect |
ram_VmallocChunk |
/proc/meminfo | Largest contiguous vmalloc block | KB | ๐ collect |
ram_HardwareCorrupted |
/proc/meminfo | Memory with hardware errors | KB | ๐ collect |
ram_AnonHugePages |
/proc/meminfo | Anonymous huge pages | KB | ๐ collect |
ram_ShmemHugePages |
/proc/meminfo | Shared memory huge pages | KB | ๐ collect |
ram_ShmemPmdMapped |
/proc/meminfo | Shared memory PMD mapped | KB | ๐ collect |
ram_HugePagesTotal |
/proc/meminfo | Total huge pages configured | count | ๐ collect |
ram_HugePagesFree |
/proc/meminfo | Free huge pages | count | ๐ collect |
ram_HugePagesRsvd |
/proc/meminfo | Reserved huge pages | count | ๐ collect |
ram_HugePagesSurp |
/proc/meminfo | Surplus huge pages | count | ๐ collect |
ram_Hugepagesize |
/proc/meminfo | Size of each huge page | KB | ๐ collect |
ram_Hugetlb |
/proc/meminfo | Total huge page memory | KB | ๐ collect |
ram_DirectMap4k |
/proc/meminfo | Memory mapped with 4K pages | KB | ๐ collect |
ram_DirectMap2M |
/proc/meminfo | Memory mapped with 2M pages | KB | ๐ collect |
ram_DirectMap1G |
/proc/meminfo | Memory mapped with 1G pages | KB | ๐ collect |
| Metric | Source | Description | Unit | Cycle |
|---|---|---|---|---|
ram_total |
libvirt/QMP | Maximum memory the VM can use | KB | ๐ lookup |
ram_used |
libvirt/QMP | Currently allocated memory | KB | ๐ lookup |
| Metric | Source | Description | Unit | Cycle |
|---|---|---|---|---|
ram_vsize |
/proc/${pid}/stat | Virtual memory size of QEMU process | bytes | ๐ collect |
ram_rss |
/proc/${pid}/stat | Resident set size (physical memory used) | bytes | ๐ collect |
ram_minflt |
/proc/${pid}/stat | Minor page faults (no disk I/O) | count | ๐ collect |
ram_cminflt |
/proc/${pid}/stat | Minor faults including children | count | ๐ collect |
ram_majflt |
/proc/${pid}/stat | Major page faults (required disk I/O) | count | ๐ collect |
ram_cmajflt |
/proc/${pid}/stat | Major faults including children | count | ๐ collect |
Monitors network traffic across physical and virtual interfaces.
| Metric | Source | Description | Unit | Cycle |
|---|---|---|---|---|
net_host_receivedBytes |
/proc/net/dev | Total bytes received (sum over relevant interfaces) | bytes | ๐ collect |
net_host_transmittedBytes |
/proc/net/dev | Total bytes transmitted (sum over relevant interfaces) | bytes | ๐ collect |
net_host_speed |
/sys/class/net/${dev}/speed | Network device maximum link speed | Mbps | ๐ lookup |
| Metric | Source | Description | Unit | Cycle |
|---|---|---|---|---|
net_host_receivedPackets |
/proc/net/dev | Total packets received | count | ๐ collect |
net_host_receivedErrs |
/proc/net/dev | Receive errors | count | ๐ collect |
net_host_receivedDrop |
/proc/net/dev | Dropped incoming packets | count | ๐ collect |
net_host_receivedFifo |
/proc/net/dev | FIFO buffer errors (receive) | count | ๐ collect |
net_host_receivedFrame |
/proc/net/dev | Framing errors on receive | count | ๐ collect |
net_host_receivedCompressed |
/proc/net/dev | Compressed packets received | count | ๐ collect |
net_host_receivedMulticast |
/proc/net/dev | Multicast frames received | count | ๐ collect |
net_host_transmittedPackets |
/proc/net/dev | Total packets transmitted | count | ๐ collect |
net_host_transmittedErrs |
/proc/net/dev | Transmit errors | count | ๐ collect |
net_host_transmittedDrop |
/proc/net/dev | Dropped outgoing packets | count | ๐ collect |
net_host_transmittedFifo |
/proc/net/dev | FIFO buffer errors (transmit) | count | ๐ collect |
net_host_transmittedColls |
/proc/net/dev | Packet collisions during transmit | count | ๐ collect |
net_host_transmittedCarrier |
/proc/net/dev | Carrier losses during transmit | count | ๐ collect |
net_host_transmittedCompressed |
/proc/net/dev | Compressed packets transmitted | count | ๐ collect |
| Metric | Source | Description | Cycle |
|---|---|---|---|
net_host_ifs |
libvirt | List of relevant physical network interfaces | ๐ lookup |
| Metric | Source | Description | Unit | Cycle |
|---|---|---|---|---|
net_receivedBytes |
/proc/${pid}/net/dev | Bytes received by this VM | bytes | ๐ collect |
net_transmittedBytes |
/proc/${pid}/net/dev | Bytes transmitted by this VM | bytes | ๐ collect |
| Metric | Source | Description | Unit | Cycle |
|---|---|---|---|---|
net_receivedPackets |
/proc/${pid}/net/dev | Packets received | count | ๐ collect |
net_receivedErrs |
/proc/${pid}/net/dev | Receive errors | count | ๐ collect |
net_receivedDrop |
/proc/${pid}/net/dev | Dropped incoming packets | count | ๐ collect |
net_receivedFifo |
/proc/${pid}/net/dev | FIFO buffer errors (receive) | count | ๐ collect |
net_receivedFrame |
/proc/${pid}/net/dev | Framing errors | count | ๐ collect |
net_receivedCompressed |
/proc/${pid}/net/dev | Compressed packets received | count | ๐ collect |
net_receivedMulticast |
/proc/${pid}/net/dev | Multicast frames received | count | ๐ collect |
net_transmittedPackets |
/proc/${pid}/net/dev | Packets transmitted | count | ๐ collect |
net_transmittedErrs |
/proc/${pid}/net/dev | Transmit errors | count | ๐ collect |
net_transmittedDrop |
/proc/${pid}/net/dev | Dropped outgoing packets | count | ๐ collect |
net_transmittedFifo |
/proc/${pid}/net/dev | FIFO buffer errors (transmit) | count | ๐ collect |
net_transmittedColls |
/proc/${pid}/net/dev | Packet collisions | count | ๐ collect |
net_transmittedCarrier |
/proc/${pid}/net/dev | Carrier losses | count | ๐ collect |
net_transmittedCompressed |
/proc/${pid}/net/dev | Compressed packets transmitted | count | ๐ collect |
| Metric | Source | Description | Cycle |
|---|---|---|---|
net_interfaces |
libvirt | List of virtual network interfaces for this VM | ๐ lookup |
Monitors block storage devices and I/O operations. Use --storedev to manually specify host storage devices. This collector provides esxtop-style storage metrics.
| Metric | Display Name | Source | Description | Unit | Cycle |
|---|---|---|---|---|---|
disk_device_reads |
READS/s | /proc/diskstats | Read operations per second | ops/s | ๐ collect |
disk_device_writes |
WRITES/s | /proc/diskstats | Write operations per second | ops/s | ๐ collect |
disk_device_mbread |
MBRD/s | /proc/diskstats | MB read per second (sectors ร 512) | MB/s | ๐ collect |
disk_device_mbwrite |
MBWR/s | /proc/diskstats | MB written per second (sectors ร 512) | MB/s | ๐ collect |
disk_device_ioutil |
%UTIL | calculated | Device busy percentage (time doing I/Os) | % | ๐ collect |
disk_device_currentops |
QDEPTH | /proc/diskstats | Current I/O queue depth (ops in progress) | count | ๐ collect |
disk_device_queuelen |
QLEN | calculated | Average queue length (weighted time / elapsed) | count | ๐ collect |
disk_device_servicetime |
SVCTM | calculated | Average service time per I/O | ms | ๐ collect |
disk_device_await |
AWAIT | calculated | Average wait time per I/O (queue + service) | ms | ๐ collect |
| Metric | Source | Description | Unit | Cycle |
|---|---|---|---|---|
disk_device_readsmerged |
/proc/diskstats | Adjacent reads merged | count | ๐ collect |
disk_device_sectorsread |
/proc/diskstats | Sectors read | count | ๐ collect |
disk_device_timereading |
/proc/diskstats | Time spent reading | ms | ๐ collect |
disk_device_writesmerged |
/proc/diskstats | Adjacent writes merged | count | ๐ collect |
disk_device_sectorswritten |
/proc/diskstats | Sectors written | count | ๐ collect |
disk_device_timewriting |
/proc/diskstats | Time spent writing | ms | ๐ collect |
disk_device_timeforops |
/proc/diskstats | Total time spent on I/Os | ms | ๐ collect |
disk_device_weightedtimeforops |
/proc/diskstats | Weighted time doing I/Os | ms | ๐ collect |
disk_device_count |
/proc/diskstats | Number of relevant disks | count | ๐ lookup |
| Metric | Source | Description | Cycle |
|---|---|---|---|
disk_sources |
libvirt | List of relevant disk devices | ๐ lookup |
| Metric | Display Name | Source | Description | Unit | Cycle |
|---|---|---|---|---|---|
disk_size_capacity |
SIZE | libvirt/QMP | Maximum virtual disk capacity | bytes | ๐ lookup |
disk_size_allocation |
ALLOC | libvirt/QMP | Currently allocated disk space | bytes | ๐ lookup |
disk_ioutil |
%UTIL | calculated | Estimated I/O utilization for VM | % | ๐ collect |
disk_reads |
READS/s | libvirt/QMP | Read operations per second | ops/s | ๐ collect |
disk_writes |
WRITES/s | libvirt/QMP | Write operations per second | ops/s | ๐ collect |
disk_mbread |
MBRD/s | libvirt/QMP | MB read per second | MB/s | ๐ collect |
disk_mbwrite |
MBWR/s | libvirt/QMP | MB written per second | MB/s | ๐ collect |
disk_lat_rd |
LAT/rd | libvirt/QMP | Average read latency | ms | ๐ collect |
disk_lat_wr |
LAT/wr | libvirt/QMP | Average write latency | ms | ๐ collect |
disk_lat_fl |
LAT/fl | libvirt/QMP | Average flush latency | ms | ๐ collect |
disk_lat_avg |
LAT/avg | calculated | Average latency across all ops | ms | ๐ collect |
| Metric | Display Name | Source | Description | Unit | Cycle |
|---|---|---|---|---|---|
disk_size_physical |
PHYSICAL | libvirt | Physical space for virtual disks | bytes | ๐ lookup |
disk_stats_flushreq |
FLUSH/s | libvirt | Cache flush requests per second | ops/s | ๐ collect |
disk_stats_rdtotaltimes |
RDTM | libvirt | Total time spent on reads | ms | ๐ collect |
disk_stats_wrtotaltimes |
WRTM | libvirt | Total time spent on writes | ms | ๐ collect |
disk_stats_flushtotaltimes |
FLTM | libvirt | Total time spent on flushes | ms | ๐ collect |
disk_delayblkio |
BLKIO | /proc/${pid}/stat | Aggregated block I/O delays | ticks | ๐ collect |
| Metric | Source | Description | Cycle |
|---|---|---|---|
disk_sources |
libvirt | List of virtual disk sources | ๐ lookup |
Extends disk metrics with process-level I/O statistics. Requires root access to /proc/${pid}/io.
No host-level metrics are collected by this collector.
| Metric | Source | Description | Unit | Cycle |
|---|---|---|---|---|
io_read_bytes |
/proc/${pid}/io | Bytes read directly from disk | bytes | ๐ collect |
io_write_bytes |
/proc/${pid}/io | Bytes originally dirtied in page cache | bytes | ๐ collect |
| Metric | Source | Description | Unit | Cycle |
|---|---|---|---|---|
io_rchar |
/proc/${pid}/io | Bytes read via any read-like syscall | bytes | ๐ collect |
io_wchar |
/proc/${pid}/io | Bytes written via any write-like syscall | bytes | ๐ collect |
io_syscr |
/proc/${pid}/io | Read-like system calls performed | count | ๐ collect |
io_syscw |
/proc/${pid}/io | Write-like system calls performed | count | ๐ collect |
io_cancelled_write_bytes |
/proc/${pid}/io | Bytes "un-dirtied" (e.g., ftruncate) | bytes | ๐ collect |
Provides host identification information useful for multi-host deployments.
| Metric | Source | Description | Unit | Cycle |
|---|---|---|---|---|
host_name |
/proc/sys/kernel/hostname | Hostname of the hypervisor | string | ๐ lookup |
| Metric | Source | Description | Unit | Cycle |
|---|---|---|---|---|
host_uuid |
/sys/devices/virtual/dmi/id/product_uuid | DMI UUID of the host (requires root) | string | ๐ lookup |
| Metric | Source | Description | Unit | Cycle |
|---|---|---|---|---|
host_name |
/proc/sys/kernel/hostname | Hostname of the hypervisor running this VM | string | ๐ lookup |
Monitors Pressure Stall Information (PSI) to detect resource shortages before they cause visible performance degradation. Requires kernel 4.20+.
For more information, see: https://facebookmicrosites.github.io/psi/docs/overview
| Metric | Source | Description | Unit | Cycle |
|---|---|---|---|---|
psi_some_cpu_avg60 |
/proc/pressure/cpu | Time some tasks delayed for CPU (60s window) | % | ๐ collect |
psi_some_io_avg60 |
/proc/pressure/io | Time some tasks delayed for I/O (60s window) | % | ๐ collect |
psi_full_io_avg60 |
/proc/pressure/io | Time all tasks delayed for I/O (60s window) | % | ๐ collect |
psi_some_mem_avg60 |
/proc/pressure/mem | Time some tasks delayed for memory (60s window) | % | ๐ collect |
psi_full_mem_avg60 |
/proc/pressure/mem | Time all tasks delayed for memory (60s window) | % | ๐ collect |
| Metric | Source | Description | Unit | Cycle |
|---|---|---|---|---|
psi_some_cpu_avg10 |
/proc/pressure/cpu | CPU pressure, some tasks (10s window) | % | ๐ collect |
psi_some_cpu_avg300 |
/proc/pressure/cpu | CPU pressure, some tasks (300s window) | % | ๐ collect |
psi_some_cpu_total |
/proc/pressure/cpu | Total CPU delay for some tasks | ฮผs | ๐ collect |
psi_some_io_avg10 |
/proc/pressure/io | I/O pressure, some tasks (10s window) | % | ๐ collect |
psi_some_io_avg300 |
/proc/pressure/io | I/O pressure, some tasks (300s window) | % | ๐ collect |
psi_some_io_total |
/proc/pressure/io | Total I/O delay for some tasks | ฮผs | ๐ collect |
psi_full_io_avg10 |
/proc/pressure/io | I/O pressure, all tasks (10s window) | % | ๐ collect |
psi_full_io_avg300 |
/proc/pressure/io | I/O pressure, all tasks (300s window) | % | ๐ collect |
psi_full_io_total |
/proc/pressure/io | Total I/O delay for all tasks | ฮผs | ๐ collect |
psi_some_mem_avg10 |
/proc/pressure/mem | Memory pressure, some tasks (10s window) | % | ๐ collect |
psi_some_mem_avg300 |
/proc/pressure/mem | Memory pressure, some tasks (300s window) | % | ๐ collect |
psi_some_mem_total |
/proc/pressure/mem | Total memory delay for some tasks | ฮผs | ๐ collect |
psi_full_mem_avg10 |
/proc/pressure/mem | Memory pressure, all tasks (10s window) | % | ๐ collect |
psi_full_mem_avg300 |
/proc/pressure/mem | Memory pressure, all tasks (300s window) | % | ๐ collect |
psi_full_mem_total |
/proc/pressure/mem | Total memory delay for all tasks | ฮผs | ๐ collect |
No VM-level metrics are collected by this collector. PSI data is host-level only.
Several metrics are derived from raw data using formulas:
VM CPU metrics are calculated from scheduler statistics:
cpu_total = ฮcpu_times / ฮtime ร 100
cpu_steal = ฮcpu_runqueues / ฮtime ร 100
Where:
ฮcpu_times: Change in CPU time counters from/proc/${pid}/schedstatฮcpu_runqueues: Change in run queue wait timeฮtime: Time elapsed between measurements
Host ioutil:
disk_device_ioutil = (ฮtimeforops / ฮtime) ร 100
VM ioutil (estimated):
disk_ioutil = host_ioutil ร (vm_io_requests / total_io_requests)
Queue Size:
disk_device_queuesize = ฮweightedtimeforops / ฮtime
Queue Time:
disk_device_queuetime = ฮweightedtimeforops / (ฮreads + ฮreadsmerged + ฮwrites + ฮwritesmerged + currentops)
Service Time:
disk_device_servicetime = ฮweightedtimeforops / (ฮreads + ฮreadsmerged + ฮwrites + ฮwritesmerged)
-
Collection Cycles: Metrics marked with "lookup" are collected during VM discovery (less frequently), while "collect" metrics are gathered every sampling interval.
-
Verbose Fields: In the ncurses UI, verbose-only fields are hidden by default but can be enabled via the field selector (press
f). In CLI mode, use--verboseto enable all additional metrics. -
Human-Readable Mode: Enable with
-Hcommand-line flag or pressuin the ncurses UI to format byte values as KB/MB/GB/TB. When active, the status bar displays[H]. Changes take effect immediately. -
Root Requirements: Some metrics (I/O collector, host UUID) require root privileges to access protected proc filesystem entries.
-
Proxmox vs Libvirt: On Proxmox VE, QMP (QEMU Machine Protocol) is used instead of libvirt API for faster metric collection.
-
Rate Metrics: Most counter-based metrics (bytes, packets, etc.) should be interpreted as rates when comparing across time intervals.
-
esxtop Equivalent Metrics: proxtop provides many esxtop-equivalent metrics for VMware-to-KVM/Proxmox migrations:
%UTIL= Device busy percentage (like esxtop GAVG/DAVG context)QDEPTH= Current queue depth (like esxtop ACTV)QLEN= Average queue length (like esxtop QUED)SVCTM= Service time (like esxtop DAVG)AWAIT= Wait time (like esxtop KAVG)LAT/rd,LAT/wr,LAT/fl= Per-operation type latencies
-
Sorting: Use
</>to change sort column,rto toggle ascending/descending. The sorted column shows^(ascending) orv(descending). Numeric columns are sorted numerically. -
Physical Device Views: Press
pfor physical network interfaces orsfor physical disk devices. These views use the same field selector as VM views - pressfto show/hide columns. -
Physical Network Interface Metrics (
pkey in ncurses): Per-interface statistics from/proc/net/devwith calculated rates:net_MbRX/s= Megabits/sec receivednet_MbTX/s= Megabits/sec transmittednet_PKTRX/s= Packets/sec receivednet_PKTTX/s= Packets/sec transmitted- Raw counters (RX-Bytes, TX-Bytes, etc.) are also available via field selector
-
Physical Disk Device Metrics (
skey in ncurses): Per-device statistics from/proc/diskstatswith calculated rates:dsk_READS/s= Read operations per seconddsk_WRITES/s= Write operations per seconddsk_MBRD/s= MB/sec read throughputdsk_MBWR/s= MB/sec write throughputdsk_%UTIL= Device busy percentage (0-100%)dsk_QDEPTH= Current queue depth (I/Os in flight)dsk_SVCTM= Average service time per I/O (ms)dsk_AWAIT= Average wait time per I/O including queue time (ms)
-
Host Storage Device Views: Three separate views for different storage types, each with the same metrics as above:
- Physical Disks (
skey): SCSI/SATA (sd*), NVMe (nvme*), virtio (vd*), partitions (sda1, etc.) - LVM Volumes (
lkey): LVM logical volumes (detected viaLVM-UUID prefix in/sys/block/dm-*/dm/uuid) - Multipath Devices (
xkey): DM-Multipath devices (detected viampath-UUID prefix in/sys/block/dm-*/dm/uuid)
Device mapper devices (
dm-*) are displayed with their friendly names from/dev/mapper/instead of the rawdm-Xname.Excluded from all views:
loop*(loopback),ram*(RAM disks) - Physical Disks (