Multi-region distributed load
Problem: Your application serves users from multiple continents. A test from a single cloud region does not reflect the latency seen by users who are geographically far from your origin. Multi-region load generation produces a realistic mix of latency profiles and surfaces region-specific performance differences (CDN miss rates, routing issues, regionalised services).
Test type: Load test or Stress test with geographic coverage.
Prerequisites
Section titled “Prerequisites”- A MaxoPerf workspace with access to two or more cloud load locations (visible in the Locations dropdown).
- A test file (any engine) already validated with a smoke test from a single region.
Step by step in MaxoPerf
Section titled “Step by step in MaxoPerf”1. Configure locations in the MaxoPerf console
Section titled “1. Configure locations in the MaxoPerf console”MaxoPerf distributes load across locations at the runner level — you do not need to change your test file. Location distribution is configured in the Configuration tab.
- Open the test and switch to the Configuration tab.
- Under Locations, click Add location.
- Select a second (and third) region — for example
eu-west-1 (Ireland)andus-east-1 (Virginia). - Set the weight (percentage of total VUs) for each location. Weights must sum to 100.
- Save.
Common distributions:
- 50 / 50 — equal split for a symmetric test.
- 70 / 20 / 10 — weighted toward the primary user region with minority traffic from secondary regions.
- Single secondary at 5 % — add a canary region to detect any routing anomaly without materially changing the load shape.
2. Start the run
Section titled “2. Start the run”- Click Run now.
- Open the run overview. You will see a Locations filter at the top of the charts.
3. Analyse per-region metrics
Section titled “3. Analyse per-region metrics”- In the run overview, use the Locations filter to view metrics for a single region at a time.
- Compare p95 latency between regions — a large difference (> 20 %) warrants investigation.
- Switch to the Runners tab to see each runner’s location, status, and live VU count.
Verify
Section titled “Verify”- Both (all) regions appear in the Runners tab with
Runningstatus and VU counts proportional to their weight. - The Locations filter in the overview shows distinct per-region throughput and latency charts.
- p95 latency values differ between regions by an amount consistent with the geographic distance (a few milliseconds for co-located regions; tens of milliseconds for intercontinental pairs).
- No region shows a disproportionately high error rate, which would indicate routing or firewall issues from that source region.
Variations
Section titled “Variations”- Private location + cloud location: mix a private datacenter (BYOC Outpost) location with a managed cloud region — see Private datacenter test.
- Single region targeted spike: add the spike pattern from Spike and recover but apply it only to one region by adjusting weights live.
- Different scenarios per region: Taurus supports per-executor
locationassignment if you need different scenarios from different origins — consult Taurus fundamentals.
Where to go next
Section titled “Where to go next”- Private datacenter (Outpost) test — add a location inside your own infrastructure.
- Connect a private datacenter — the how-to for installing the BYOC Outpost agent.
- Load test — the test type this recipe exercises.