PVC Utilization
CloudPilot AI displays the current utilization and Kubernetes lifecycle state of Persistent Volume Claims (PVCs) in the selected cluster. This view is read-only and does not create alerts, send notifications, or resize volumes.
View PVC utilization
Open a cluster and select Cluster > Overview. The Persistent Volume Claims card appears below the CPU and memory utilization charts.
The card initially shows up to five PVCs. PVCs with current measurements appear first in descending utilization order, followed by stale measurements and then PVCs without a measurement. Select View all to expand the card, search PVCs, filter lifecycle and data states, and browse the complete list.
Summary
| Field | Description |
|---|---|
| Total PVCs | All PVCs in the cluster, including pending and unbound claims |
| Bound PVCs | PVCs currently bound to a PersistentVolume |
| Provisioned Capacity | Capacity provisioned for bound PVCs; this is not the capacity of the underlying storage pool |
| Measured Utilization | Total used bytes divided by total kubelet-reported filesystem capacity for PVCs with current metrics |
Measured Utilization includes a coverage count. For example, 18 / 20 PVCs measured means that the aggregate percentage is based on 18 PVCs. PVCs
without current metrics are not treated as 0% and are not included in the
aggregate.
PVC details
Each row separates the Kubernetes lifecycle state from metric availability:
| Field | Description |
|---|---|
| PVC | PVC name and namespace |
| Lifecycle | Pending, Bound, Lost, Terminating, or Unknown |
| Utilization | Raw percentage and used filesystem bytes divided by filesystem capacity |
| Available | Kubelet-reported available filesystem bytes |
| Storage Class | StorageClass associated with the PVC |
| Data | Fresh, Stale, or the reason a metric is unavailable, together with the metric collection time |
A real zero value is displayed as 0%. If no reliable metric is available,
the numeric fields display a dash instead.
Data availability
PVC filesystem metrics come from the kubelet volume statistics summary. A mounted PVC can be unavailable when the CSI driver does not report volume statistics or when the node could not be collected. An unmounted or unbound PVC does not normally have a filesystem utilization value.
CloudPilot AI keeps the last known value when a collection is only partially successful and marks that value as stale. Data older than ten minutes is also reported as stale.
Disk Monitor
PVC utilization and node filesystem utilization share the Disk Monitor setting under Cluster > Setting. Disk Monitor is enabled by default.
When it is disabled, the PVC card remains visible and reports that collection is disabled. Re-enabling it starts a new collection; the card reports Collecting until the first snapshot is available.
Data Protection Mode
No PVC identities (including UID, name, namespace, PersistentVolume, or StorageClass) or utilization details are uploaded when Data Protection Mode is enabled. The PVC card remains visible and explains that PVC utilization is unavailable in this mode.