Skip to content

[docs][monitoring] NFS PVC capacity metrics displayed incorrectly in monitoring graphs #16270

@neermilov

Description

@neermilov

Preflight Checklist

  • I agree to follow the Code of Conduct that this project adheres to.
  • I have searched the issue tracker for an issue that matches the one I want to file, without success.

Version

v1.69.5

Expected Behavior

Add clear notes and warnings to csi-nfs module documentation (or to grafana panel's description) so users understand this limitation and don't expect precise disk usage metrics per PVC

Actual Behavior

Disk usage metrics for NFS PVCs (via csi-nfs) in monitoring dashboards may show incorrect or misleading values about its provisioned capacity. This is expected behavior due to NFS protocol and CSI driver limitations.

Limitations:

  • Metrics from NFS PVCs reflect usage of the entire NFS server filesystem, not the individual PVC.
  • NFS does not support per-directory quotas or true PVC size limits

Steps To Reproduce

  1. Enable csi-nfs
  2. Create PVC from NFS storage class
  3. Look at PVC dashboards in Grafana (f.e. Main / Namespace / Controller / Pod)

Additional Information

Materials about limitations

  1. NFS CSI provisioner not showing actual usage of each PVC kubernetes-csi/csi-driver-nfs#517
  2. https://hirohirolab.com/en/blog/2024/09/nfs_storage_capacity_does_not_work_in_k8s/#2-the-cause

Logs

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions