Skip to main content
The Storage section provides visibility into persistent storage resources in your Kubernetes cluster.

Overview

Kubernetes storage resources manage persistent data:
  • PersistentVolumes (PV) - Cluster-wide storage resources
  • PersistentVolumeClaims (PVC) - Requests for storage by pods
  • StorageClasses - Define storage provisioners and policies
  • CSI Drivers - Container Storage Interface implementations
  • CSI Nodes - Node-level CSI capabilities
  • Volume Attachments - Track volume attachments to nodes

Accessing Storage Resources

Navigate to your cluster and click Kubernetes in the sidebar. Storage resources include:

PersistentVolumes (PV)

PersistentVolumes are cluster-level storage resources.

Viewing PersistentVolumes

Access Modes

Reclaim Policies

PV Details

Click a PV to view:
  • Capacity - Storage size
  • Volume Mode - Filesystem or Block
  • Access Modes - Supported access patterns
  • Reclaim Policy - What happens when released
  • Storage Class - Provisioner configuration
  • Claim Reference - Bound PVC details
  • Source - Underlying storage (CSI, NFS, etc.)

PersistentVolumeClaims (PVC)

PVCs are requests for storage by pods.

Viewing PersistentVolumeClaims

PVC States

PVC Details

Click a PVC to view:
  • Request - Requested storage size
  • Capacity - Actual provisioned size
  • Access Modes - Granted access modes
  • Volume Name - Bound PersistentVolume
  • Storage Class - Provisioner used
  • Volume Mode - Filesystem or Block
  • Pods - Pods using this claim

Troubleshooting Pending PVCs

  1. Check if a matching StorageClass exists
  2. Verify storage class is set to provision dynamically
  3. Check cloud provider quotas and limits
  4. Review PVC events for errors

StorageClasses

StorageClasses define how storage is provisioned.

Viewing StorageClasses

Volume Binding Modes

StorageClass Details

  • Provisioner - CSI driver name
  • Parameters - Provisioner-specific settings
  • Reclaim Policy - Default for created PVs
  • Allow Volume Expansion - Whether resize is supported
  • Mount Options - Default mount options

Common Provisioners


CSI Resources

CSI Drivers

CSI Drivers are storage plugins that implement the Container Storage Interface.

CSI Nodes

CSI Nodes show storage capabilities per node.

Common Tasks

Finding Which Pod Uses a PVC

  1. Navigate to PersistentVolumeClaims
  2. Click on the PVC
  3. View the Pods section to see which pods have mounted this volume

Expanding a Volume

  1. Navigate to PersistentVolumeClaims
  2. Click on the PVC
  3. Check if the StorageClass allows expansion
  4. Edit the PVC to request more storage
  5. The filesystem will be expanded (may require pod restart)

Troubleshooting Storage Issues

  1. PVC Pending:
    • Check StorageClass exists and is valid
    • Verify provisioner is running
    • Check cloud provider quotas
    • Review events for error messages
  2. Mount Failures:
    • Check node can access the storage
    • Verify CSI driver is installed on the node
    • Check for conflicting access modes
  3. Data Loss:
    • Check reclaim policy before deleting PVCs
    • Use Retain policy for important data
    • Set up backup solutions

Tips

WaitForFirstConsumer: Use this binding mode to ensure volumes are provisioned in the same zone as your pod.
Storage Class Defaults: Set a default StorageClass so PVCs without explicit class still work.
Reclaim Policy: Change to Retain for production data to prevent accidental deletion.

Still have questions? Join our Slack community and we’ll help out.