Task 04: Storage Performance Validation
DOCUMENT CATEGORY: Implementation Runbook
SCOPE: The storage of a deployed Azure Local cluster
PURPOSE: Check pool, disk and volume health and capacity, and optionally measure latency
MASTER REFERENCE: Storage Spaces Direct overview
Status: Active
The VMFleet baseline of Part 6 task 02 is the performance acceptance test. This task is the quick health and capacity read for the handover and after changes; with -RunPerformanceTest it also writes and reads a test file on each volume. That generates I/O on the cluster: run it in a maintenance window on a production cluster.
Values from infrastructure.yml
The values for this task come from infrastructure.yml (schema 5). Every key, with its type, default and example, is in the variables reference.
| Key | What the script does with it |
|---|---|
cluster.name | The cluster to test |
The limits (-CsvUsageWarningPercent, -MaxAvgWriteLatencyMs, -MaxAvgReadLatencyMs) are parameters, not values of a deployment.
Execution Options
- PowerShell on a cluster machine
- PowerShell
PowerShell on a cluster machine
Get-StoragePool -IsPrimordial $false; Get-VirtualDisk; Get-PhysicalDisk
Get-ClusterSharedVolume | Select-Object Name, State, OwnerNode
PowerShell
| Script | What it does |
|---|---|
scripts/deploy/07-validation-handover/task-04-storage-performance-validation/powershell/Test-StoragePerformance.ps1 | Pool health and capacity, virtual disk health and resiliency, physical disks, volume ownership, state and usage, and with -RunPerformanceTest average write and read latency |
| Parameter | Meaning |
|---|---|
-InfrastructureFile | The infrastructure.yml (schema 5). Required |
-VolumeNames | Only these volumes. Default: all |
-RunPerformanceTest, -DurationSeconds | The I/O test and its length in seconds (at least 2, default 60) |
-CsvUsageWarningPercent | A volume fuller than this is a warning (default 85) |
-MaxAvgWriteLatencyMs, -MaxAvgReadLatencyMs | Latency above which the test warns (defaults 10 and 5) |
-OutputPath | A folder for the JSON results |
./Test-StoragePerformance.ps1 -InfrastructureFile ./infrastructure.yml -OutputPath ./handover
Exit codes: 0 no check logged an error, 1 a check or the run failed, 2 cluster.name is missing or the file cannot be read.
Validation
- Exit code 0, every pool and virtual disk
Healthy - Every volume
Onlineand below the usage limit - With
-RunPerformanceTest: latency below the limits
Troubleshooting
| Issue | Cause | Resolution |
|---|---|---|
| A volume is above the usage limit | The volume is filling | Extend it, or move data; plan capacity (Task 04 of Part 8, Capacity) |
A virtual disk is Warning | A repair job is running | Get-StorageJob; wait |
| Latency is above the limit | The cluster is busy, or a disk is slow | Run it again in a quiet window; check Get-PhysicalDisk |
Navigation
| Previous | Up | Next |
|---|---|---|
| Task 03: Network Configuration | Part 7 Index | Task 05: Deployment Documentation |
Version Control
| Version | Date | Author | Changes |
|---|---|---|---|
| 1.0.0 | 2026-11-15 | Azure Local Cloud | Initial release. The script reads cluster.name from infrastructure.yml (it was -ClusterName) |