Troubleshooting: Storage¶

Storage full¶

Symptom: STORAGE_FULL (CRITICAL). Diagnostics name the exact backend or pool that is full. New guests cannot be created until capacity is restored.

Free space or expand the backend.
Check for large snapshots and orphaned disks.

Low space¶

Symptom: STORAGE_LOW_SPACE. Plan a capacity expansion before it becomes a failure. Thresholds are reported at 70/80/90/95 %.

Backend offline¶

Symptom: STORAGE_BACKEND_OFFLINE. Check the pool and the network path to network storage.

LVM metadata high¶

Symptom: LVM_METADATA_HIGH. The volume group metadata usage is above the warning threshold. Expand LVM metadata capacity; do not delete logical volumes to reclaim metadata.

Mapping missing¶

Symptom: STORAGE_MAPPING_MISSING. Re-run the provider asset sync.

A volume resize did not shrink¶

By design: volumes are grow-only. A provider-side success is never shrunk back.

Commands¶

php artisan pterocloud:storage:health
php artisan pterocloud:storage:inspect <pool_uuid>
php artisan pterocloud:storage:audit