Proxmox VE
Overview
The Proxmox VE integration with ObserveOps (formerly known as AIOps) collects operational telemetry from Proxmox Virtual Environment hypervisor nodes and clusters. It monitors node system health, CPU and memory utilization, disk and network performance, storage pools, LVM configurations, ZFS pools, network interfaces, and virtual machine resource consumption.
These metrics help administrators track hypervisor health, monitor VM performance, manage storage capacity, and maintain operational visibility across Proxmox VE environments.
Prerequisites
- The Proxmox VE node or cluster is reachable from ObserveOps over the network.
- The user account used for integration has API read access on the Proxmox VE host.
- Required Proxmox API endpoints are reachable from ObserveOps.
- The Proxmox VE host is added in discovery with correct credentials and connection configuration.
List of Supported KPIs
Node System
| Metric | Description | Type |
|---|---|---|
| proxmox.ve.state | Current operational state of the Proxmox VE node. | String |
| proxmox.ve.pve.version | Proxmox VE version running on the node. | String |
| proxmox.ve.kernel.version | Kernel version running on the node. | String |
| proxmox.ve.cpu.cores | Total number of CPU cores on the node. | Count |
| proxmox.ve.cpu.model | CPU model installed on the node. | String |
| proxmox.ve.memory.bytes | Total physical memory capacity of the node. | Bytes |
| proxmox.ve.disk.bytes | Total disk capacity of the node. | Bytes |
| proxmox.ve.started.time.seconds | Node start time as a Unix timestamp in seconds. | Seconds |
| proxmox.ve.started.date | Date and time when the node was last started. | Timestamp |
Node Performance
| Metric | Description | Type |
|---|---|---|
| proxmox.ve.cpu.percent | CPU utilization percentage of the node. | Percent |
| proxmox.ve.memory.used.bytes | Amount of memory currently in use on the node. | Bytes |
| proxmox.ve.memory.free.bytes | Amount of memory currently free on the node. | Bytes |
| proxmox.ve.memory.used.percent | Memory utilization percentage of the node. | Percent |
| proxmox.ve.disk.free.bytes | Free disk capacity on the node. | Bytes |
| proxmox.ve.disk.used.percent | Disk utilization percentage of the node. | Percent |
| proxmox.ve.swap.memory.bytes | Total swap memory capacity of the node. | Bytes |
| proxmox.ve.swap.memory.free.bytes | Amount of swap memory currently free on the node. | Bytes |
| proxmox.ve.swap.memory.used.percent | Swap memory utilization percentage of the node. | Percent |
| proxmox.ve.network.in.bytes.per.sec | Inbound network throughput on the node in bytes per second. | Bytes/sec |
| proxmox.ve.network.out.bytes.per.sec | Outbound network throughput on the node in bytes per second. | Bytes/sec |
Physical Disks
| Metric | Description | Type |
|---|---|---|
| proxmox.ve.disk | Identifier of an individual physical disk on the node. | String |
| proxmox.ve.disk.type | Type of the disk — SSD, HDD, or NVMe. | String |
| proxmox.ve.disk.usage | Usage classification of the disk. | String |
| proxmox.ve.disk.size.octet | Total capacity of the disk in bytes. | Bytes |
| proxmox.ve.disk.model | Model name of the disk. | String |
| proxmox.ve.disk.serial.number | Serial number of the disk. | String |
| proxmox.ve.disk.health | SMART health status of the disk. | String |
| proxmox.ve.disk.vendor | Vendor name of the disk. | String |
LVM
| Metric | Description | Type |
|---|---|---|
| proxmox.ve.lvm | Identifier of an LVM volume group on the node. | String |
| proxmox.ve.lvm.lvs | Number of logical volumes in the LVM volume group. | Count |
| proxmox.ve.lvm.assigned.lvs.percent | Percentage of logical volumes assigned in the volume group. | Percent |
| proxmox.ve.lvm.size.octet | Total capacity of the LVM volume group in bytes. | Bytes |
| proxmox.ve.lvm.free.octet | Free capacity in the LVM volume group in bytes. | Bytes |
| proxmox.ve.lvm.disk.partition | Disk partition backing this LVM volume group. | String |
LVM Thin Pools
| Metric | Description | Type |
|---|---|---|
| proxmox.ve.lvm.thin | Identifier of an LVM thin pool on the node. | String |
| proxmox.ve.lvm.thin.volume.group | Volume group this thin pool belongs to. | String |
| proxmox.ve.lvm.thin.octet | Total capacity of the thin pool in bytes. | Bytes |
| proxmox.ve.lvm.thin.used.octet | Amount of data currently stored in the thin pool in bytes. | Bytes |
| proxmox.ve.lvm.thin.metadata.octet | Total metadata capacity of the thin pool in bytes. | Bytes |
| proxmox.ve.lvm.thin.metadata.used.octet | Amount of metadata currently used in the thin pool in bytes. | Bytes |
Directories
| Metric | Description | Type |
|---|---|---|
| proxmox.ve.directory | Identifier of a directory storage on the node. | String |
| proxmox.ve.directory.device | Block device or path backing this directory storage. | String |
| proxmox.ve.directory.type | Filesystem type of this directory storage. | String |
| proxmox.ve.directory.options | Mount options configured for this directory storage. | String |
| proxmox.ve.directory.unitfile | Systemd unit file associated with this directory storage. | String |
ZFS Pools
| Metric | Description | Type |
|---|---|---|
| proxmox.ve.zfs | Identifier of a ZFS pool on the node. | String |
| proxmox.ve.zfs.health | Health status of the ZFS pool. | String |
| proxmox.ve.zfs.size.octet | Total capacity of the ZFS pool in bytes. | Bytes |
| proxmox.ve.zfs.allocated.octet | Amount of space currently allocated in the ZFS pool in bytes. | Bytes |
| proxmox.ve.zfs.free.octet | Free space in the ZFS pool in bytes. | Bytes |
| proxmox.ve.zfs.fragmentation | Fragmentation percentage of the ZFS pool. | Percent |
| proxmox.ve.zfs.deduplication | Deduplication ratio of the ZFS pool. | Count |
Network Interfaces
| Metric | Description | Type |
|---|---|---|
| proxmox.ve.interface | Identifier of a network interface on the node. | String |
| proxmox.ve.interface.ip.address | IP address assigned to this interface. | String |
| proxmox.ve.interface.type | Type of the interface — bridge, bond, VLAN, or Ethernet. | String |
| proxmox.ve.interface.active | Indicates whether the interface is currently active. | Boolean |
| proxmox.ve.interface.ports | Physical ports or member interfaces of this interface. | String |
| proxmox.ve.interface.netmask | Subnet mask configured for this interface. | String |
| proxmox.ve.interface.cidr | CIDR notation of the IP address and subnet. | String |
| proxmox.ve.interface.gateway | Gateway address configured for this interface. | String |
| proxmox.ve.interface.vlan.id | VLAN ID configured for this interface. | Count |
| proxmox.ve.interface.mtu.bytes | MTU size configured for this interface in bytes. | Bytes |
Storage
| Metric | Description | Type |
|---|---|---|
| proxmox.ve.storage | Identifier of a storage resource on the node. | String |
| proxmox.ve.storage.type | Type of the storage — dir, LVM, ZFS, NFS, or CIFS. | String |
| proxmox.ve.storage.enabled | Indicates whether the storage is enabled. | Boolean |
| proxmox.ve.storage.active | Indicates whether the storage is currently active. | Boolean |
| proxmox.ve.storage.content | Content types this storage supports. | String |
| proxmox.ve.storage.capacity.octet | Total capacity of the storage in bytes. | Bytes |
| proxmox.ve.storage.used.octet | Amount of storage currently used in bytes. | Bytes |
| proxmox.ve.storage.free.octet | Free storage capacity in bytes. | Bytes |
| proxmox.ve.storage.shared.memory.bytes | Shared memory allocated for this storage in bytes. | Bytes |
Storage Volumes
| Metric | Description | Type |
|---|---|---|
| proxmox.ve.storage.volume | Identifier of an individual storage volume. | String |
| proxmox.ve.storage.volume.size.octet | Total capacity of the storage volume in bytes. | Bytes |
| proxmox.ve.storage.volume.content | Content type of the storage volume. | String |
| proxmox.ve.storage.volume.format | Disk image format of the storage volume. | String |
| proxmox.ve.storage.volume.created.time | Timestamp when the storage volume was created. | Timestamp |
Cluster Summary
| Metric | Description | Type |
|---|---|---|
| proxmox.ve.cluster.quorate | Indicates whether the cluster has quorum. | Boolean |
| proxmox.ve.cluster.votes | Total number of votes configured in the cluster. | Count |
| proxmox.ve.cluster.current.votes | Number of votes currently participating in the cluster. | Count |
| proxmox.ve.cluster.nodes | Total number of nodes in the cluster. | Count |
| proxmox.ve.cluster.online.nodes | Number of nodes currently online in the cluster. | Count |
| proxmox.ve.cluster.offline.nodes | Number of nodes currently offline in the cluster. | Count |
| proxmox.ve.cluster.cpu.percent | CPU utilization percentage across the cluster. | Percent |
| proxmox.ve.cluster.memory.used.percent | Memory utilization percentage across the cluster. | Percent |
| proxmox.ve.cluster.disk.used.percent | Disk utilization percentage across the cluster. | Percent |
| proxmox.ve.cluster.vms | Total number of virtual machines across the cluster. | Count |
| proxmox.ve.cluster.running.vms | Number of running virtual machines across the cluster. | Count |
| proxmox.ve.cluster.stopped.vms | Number of stopped virtual machines across the cluster. | Count |
Cluster Nodes
| Metric | Description | Type |
|---|---|---|
| proxmox.ve.cluster.node | Identifier of an individual cluster node. | String |
| proxmox.ve.cluster.node.id | Numeric ID of the cluster node. | Count |
| proxmox.ve.cluster.node.state | Current state of the cluster node. | String |
| proxmox.ve.cluster.node.ip | IP address of the cluster node. | String |
| proxmox.ve.cluster.node.version | Proxmox VE version running on the cluster node. | String |
| proxmox.ve.cluster.node.pve.version | PVE version string of the cluster node. | String |
| proxmox.ve.cluster.node.kernel.version | Kernel version running on the cluster node. | String |
| proxmox.ve.cluster.node.cpu.cores | Total CPU cores on the cluster node. | Count |
| proxmox.ve.cluster.node.cpu.percent | CPU utilization percentage of the cluster node. | Percent |
| proxmox.ve.cluster.node.memory.bytes | Total memory capacity of the cluster node. | Bytes |
| proxmox.ve.cluster.node.memory.used.bytes | Memory currently in use on the cluster node. | Bytes |
| proxmox.ve.cluster.node.memory.used.percent | Memory utilization percentage of the cluster node. | Percent |
| proxmox.ve.cluster.node.disk.bytes | Total disk capacity of the cluster node. | Bytes |
| proxmox.ve.cluster.node.disk.used.bytes | Disk space currently used on the cluster node. | Bytes |
| proxmox.ve.cluster.node.disk.used.percent | Disk utilization percentage of the cluster node. | Percent |
| proxmox.ve.cluster.node.network.in.bytes.per.sec | Inbound network throughput on the cluster node in bytes per second. | Bytes/sec |
| proxmox.ve.cluster.node.network.out.bytes.per.sec | Outbound network throughput on the cluster node in bytes per second. | Bytes/sec |
| proxmox.ve.cluster.node.storage.pools | Number of storage pools on the cluster node. | Count |
| proxmox.ve.cluster.node.storage.pool.bytes | Total capacity of storage pools on the cluster node. | Bytes |
| proxmox.ve.cluster.node.storage.pool.used.bytes | Used capacity of storage pools on the cluster node. | Bytes |
| proxmox.ve.cluster.node.vms | Number of virtual machines on the cluster node. | Count |
| proxmox.ve.cluster.node.started.time.seconds | Node start time as a Unix timestamp in seconds. | Seconds |
| proxmox.ve.cluster.node.started.date | Date and time when the cluster node was last started. | Timestamp |
Cluster Storage
| Metric | Description | Type |
|---|---|---|
| proxmox.ve.cluster.storage | Identifier of a cluster-level storage resource. | String |
| proxmox.ve.cluster.storage.octet | Total capacity of the cluster storage in bytes. | Bytes |
| proxmox.ve.cluster.storage.used.octet | Amount of cluster storage currently used in bytes. | Bytes |
| proxmox.ve.cluster.storage.free.octet | Free capacity of the cluster storage in bytes. | Bytes |
Virtual Machines
| Metric | Description | Type |
|---|---|---|
| proxmox.ve.cluster.vm | Identifier of an individual virtual machine in the cluster. | String |
| proxmox.ve.cluster.vm.name | Name of the virtual machine. | String |
| proxmox.ve.cluster.vm.state | Current power state of the virtual machine. | String |
| proxmox.ve.cluster.vm.node | Node on which the virtual machine is running. | String |
| proxmox.ve.cluster.vm.node.ip | IP address of the node hosting the virtual machine. | String |
| proxmox.ve.cluster.vm.ip | IP address assigned to the virtual machine. | String |
| proxmox.ve.cluster.vm.os.name | Operating system name of the virtual machine. | String |
| proxmox.ve.cluster.vm.os.version | Operating system version of the virtual machine. | String |
| proxmox.ve.cluster.vm.os.id | Operating system identifier of the virtual machine. | String |
| proxmox.ve.cluster.vm.cpu.cores | Number of virtual CPU cores allocated to the virtual machine. | Count |
| proxmox.ve.cluster.vm.cpu.percent | CPU utilization percentage of the virtual machine. | Percent |
| proxmox.ve.cluster.vm.memory.bytes | Total memory allocated to the virtual machine. | Bytes |
| proxmox.ve.cluster.vm.memory.used.bytes | Memory currently in use by the virtual machine. | Bytes |
| proxmox.ve.cluster.vm.memory.used.percent | Memory utilization percentage of the virtual machine. | Percent |
| proxmox.ve.cluster.vm.disk.bytes | Total disk capacity allocated to the virtual machine. | Bytes |
| proxmox.ve.cluster.vm.disk.used.bytes | Disk space currently used by the virtual machine. | Bytes |
| proxmox.ve.cluster.vm.disk.read.bytes | Total bytes read from disk by the virtual machine. | Bytes |
| proxmox.ve.cluster.vm.disk.write.bytes | Total bytes written to disk by the virtual machine. | Bytes |
| proxmox.ve.cluster.vm.network.in.bytes | Total bytes received over the network by the virtual machine. | Bytes |
| proxmox.ve.cluster.vm.network.out.bytes | Total bytes sent over the network by the virtual machine. | Bytes |
| proxmox.ve.cluster.vm.uptime.seconds | Total uptime of the virtual machine in seconds. | Seconds |