Skip to content

Introduction ​

Category: Getting Started

The Azure Local Load Testing Framework is a comprehensive, automated solution for load testing Azure Local (Azure Stack HCI) clusters. It validates storage, network, and compute performance before production or development workloads are migrated or deployed.

Why Load Test Azure Local? ​

Azure Local clusters represent significant infrastructure investments. Before committing production workloads, organizations need confidence that:

  • Storage performance meets application IOPS, throughput, and latency requirements
  • Network throughput supports east-west traffic, RDMA/SMB Direct expectations
  • Compute capacity handles expected virtual machine density
  • The cluster operates stably under sustained load without thermal throttling or hardware degradation

Supported Load Testing Tools ​

ToolPurposeStatus
VMFleetStorage load generation via VM fleet running DiskSpd workloadsImplemented, unit-tested, not proven on hardware
fioFine-grained storage I/O benchmarking (Linux VMs)Implemented, unit-tested, not proven on hardware
iPerf3Network bandwidth and latency testingImplemented, unit-tested, not proven on hardware
HammerDBDatabase workload benchmarking (OLTP/OLAP)Implemented, unit-tested, not proven on hardware
stress-ngCPU, memory, and system stress testingImplemented, unit-tested, not proven on hardware

Each tool is standalone — pick one and follow the "Run This Test" instructions on its page. No CI/CD pipeline is required.

Key Features ​

  • 100% Automated — End-to-end pipeline from cluster validation to report generation
  • Configuration-Driven — Master environment file with tagged variables; nothing hardcoded
  • Credential Security — Azure Key Vault, environment variable or parameter credentials; no prompts
  • Comprehensive Monitoring — Real-time storage, network, and compute metric collection
  • Multi-Format Reports — PDF, Word (DOCX), and Excel (XLSX) output
  • CI/CD Ready — GitHub Actions, Azure DevOps, and GitLab CI pipeline definitions
  • Modular Architecture — Add new testing tools without modifying existing automation

Project Repository ​

The source code is hosted at https://github.com/AzureLocal/azurelocal-loadtools.

Next Steps ​

Released under the MIT License.