> ## Documentation Index
> Fetch the complete documentation index at: https://docs.shiftlabs.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Multi-Region Tests

> Run load tests from multiple geographic locations simultaneously

Multi-Region Tests allow you to run the same load test from multiple geographic locations at once. This helps understand how your application performs for users around the world and identify regional performance differences.

## Key Benefits

<CardGroup cols={2}>
  <Card title="Global Performance Visibility" icon="earth-americas">
    See how latency varies across continents and identify regions with poor performance.
  </Card>

  <Card title="Simultaneous Execution" icon="arrows-split-up-and-left">
    All regions start testing at the same time for accurate comparison under identical conditions.
  </Card>

  <Card title="Aggregated Metrics" icon="chart-mixed">
    View combined statistics across all regions plus detailed per-region breakdowns.
  </Card>

  <Card title="Fastest/Slowest Detection" icon="ranking-star">
    Automatically identifies best and worst performing regions for quick analysis.
  </Card>
</CardGroup>

## Available Regions

Tests can run from locations across six continents:

| Region            | Countries                                                      |
| ----------------- | -------------------------------------------------------------- |
| **North America** | United States, Canada, Mexico                                  |
| **South America** | Brazil, Argentina                                              |
| **Europe**        | UK, Germany, France, Netherlands, Spain, Italy, Poland, Sweden |
| **Asia Pacific**  | Japan, South Korea, Singapore, Hong Kong, India                |
| **Oceania**       | Australia, New Zealand                                         |
| **Africa**        | South Africa                                                   |
| **Middle East**   | UAE                                                            |

<Info>
  Available countries may vary based on proxy provider availability. The country selection dialog shows only currently available locations.
</Info>

## How to Create a Multi-Region Test

<Steps>
  <Step title="Create a Test Plan First">
    Multi-region tests use existing [Test Plans](/guide/load-testing/test-plans). If you don't have one, create it from the [New Test](/guide/load-testing/new-test) wizard first.
  </Step>

  <Step title="Open Multi-Region Tests">
    Navigate to **Load Testing → Multi-Region Tests**.
  </Step>

  <Step title="Click New Multi-Region Test">
    Click the **New Multi-Region Test** button.
  </Step>

  <Step title="Enter Test Name">
    Provide a descriptive name (e.g., "Global API Performance Q1 2024").
  </Step>

  <Step title="Select Test Plan">
    Choose the test plan to run across all regions.
  </Step>

  <Step title="Select Regions">
    Click on countries to select them. You must select at least 2 regions.
  </Step>

  <Step title="Start Test">
    Click **Start Test**. Tests begin simultaneously in all selected regions.
  </Step>
</Steps>

<Warning>
  Running tests from many regions simultaneously consumes more resources. Consider your load testing quota when selecting region count.
</Warning>

## Test Status Types

| Status      | Description                             |
| ----------- | --------------------------------------- |
| **Pending** | Test created, waiting to start          |
| **Running** | Tests actively executing across regions |
| **Success** | All regions completed successfully      |
| **Partial** | Some regions succeeded, some failed     |
| **Failed**  | All regions failed                      |

## Multi-Region Run List

The main page shows all multi-region test runs in a table:

| Column      | Description                                 |
| ----------- | ------------------------------------------- |
| **Name**    | Test name and associated plan               |
| **Regions** | Country flags for selected regions          |
| **Status**  | Current execution status                    |
| **Metrics** | Aggregated average latency and success rate |
| **Created** | When the test was started                   |
| **Actions** | View details or cancel (if running)         |

### Stats Cards

Quick overview showing:

* **Total Runs**: Number of multi-region tests executed
* **Successful**: Tests where all regions passed
* **Running**: Currently executing tests
* **Regions Used**: Unique regions tested across all runs

## How to View Multi-Region Results

<Steps>
  <Step title="Find the Test">
    Locate the multi-region run in the list.
  </Step>

  <Step title="Click to Open">
    Click the arrow icon or anywhere on the row to open details.
  </Step>

  <Step title="Review Aggregated Metrics">
    The header cards show combined statistics across all regions.
  </Step>

  <Step title="Compare Regional Performance">
    The latency comparison chart ranks regions by response time.
  </Step>

  <Step title="Drill Into Individual Regions">
    Click **View Test Details** on any region card to see full test results.
  </Step>
</Steps>

## Detail Page Components

### Aggregated Metrics Cards

| Metric              | Description                              |
| ------------------- | ---------------------------------------- |
| **Total Requests**  | Sum of requests across all regions       |
| **Avg Latency**     | Average response time across all regions |
| **Min Latency**     | Fastest region's average latency         |
| **Max Latency**     | Slowest region's average latency         |
| **Avg Success**     | Average success rate across regions      |
| **Regions OK/Fail** | Count of successful vs failed regions    |

### Latency Comparison Chart

Horizontal bar chart comparing response times:

* Sorted by latency (fastest at top)
* Color-coded by performance:
  * **Green** (\< 100ms): Excellent
  * **Yellow** (100-200ms): Good
  * **Orange** (200-500ms): Acceptable
  * **Red** (> 500ms): Needs improvement
* Shows status for incomplete or failed regions

### Region Cards

Each region displays:

* **Country flag and name**
* **Status badge** (Success, Failed, Running, Pending)
* **Latency**: Average response time
* **Success Rate**: Percentage of successful requests
* **Requests**: Total requests from this region
* **Fastest/Slowest badges**: Highlights best and worst performers
* **Link to full test results** (for successful tests)

## Live Progress Tracking

While tests are running:

* Progress bar shows completion percentage
* Status updates automatically every few seconds
* Region cards update as each test completes
* No manual refresh needed

## How to Cancel a Running Test

<Steps>
  <Step title="Find the Running Test">
    Locate the test with "Running" status in the list.
  </Step>

  <Step title="Click Cancel">
    Click the **X** button in the actions column.
  </Step>

  <Step title="Confirm">
    The test is cancelled. Completed regions retain their results; pending regions are stopped.
  </Step>
</Steps>

## Use Cases

### Global CDN Validation

Test your API through CDN edge locations to verify caching and routing work correctly worldwide.

### Regional Compliance

Verify that data residency requirements are met by testing response content from specific regions.

### Performance Baseline

Establish baseline latency expectations for users in different geographic areas.

### Incident Response

During outages, quickly test from multiple regions to identify if issues are global or regional.

## Troubleshooting

<AccordionGroup>
  <Accordion title="Some regions show Failed status" icon="circle-question">
    * Check the error message on the region card
    * The target server may block requests from certain countries
    * Network issues or rate limiting at specific locations
    * Try running a single-region test from that location to debug
  </Accordion>

  <Accordion title="Test stuck in Pending" icon="circle-question">
    * Proxy resources may be temporarily unavailable
    * Try reducing the number of selected regions
    * Check if other tests are consuming available proxies
  </Accordion>

  <Accordion title="Large latency variance between regions" icon="circle-question">
    * Expected for geographically distributed servers
    * Check if your server has regional deployments
    * Consider CDN or edge caching for global performance
  </Accordion>

  <Accordion title="Cannot select certain countries" icon="circle-question">
    * Country may be temporarily unavailable
    * Proxy provider may not support that location
    * Try again later or select alternative nearby regions
  </Accordion>

  <Accordion title="Test shows Partial status" icon="circle-question">
    * Some regions succeeded, others failed
    * Review individual region cards for failure reasons
    * Partial results are still valuable for successful regions
  </Accordion>
</AccordionGroup>

## FAQ

<AccordionGroup>
  <Accordion title="How many regions can I select?">
    You can select any number of available regions (minimum 2). However, more regions consume more resources and may take longer to complete.
  </Accordion>

  <Accordion title="Do all regions use the same test configuration?">
    Yes. The selected test plan's configuration (URL, method, load pattern, thresholds) is identical across all regions. Only the geographic origin differs.
  </Accordion>

  <Accordion title="Can I compare results from different multi-region runs?">
    Individual region tests appear in [Test Results](/guide/load-testing/test-results) and can be compared using the standard comparison feature.
  </Accordion>

  <Accordion title="Why is one region much slower than others?">
    Physical distance to your server is the primary factor. A server in the US will naturally have higher latency from Asia than from Canada. Consider deploying to multiple regions or using a CDN.
  </Accordion>

  <Accordion title="Are tests truly simultaneous?">
    Tests are dispatched to all regions within seconds of each other. Minor timing differences (1-5 seconds) may occur due to proxy initialization, but this doesn't affect comparison validity.
  </Accordion>

  <Accordion title="Can I schedule recurring multi-region tests?">
    Direct scheduling is not available in the UI. Use the API to integrate multi-region tests into CI/CD pipelines for automated execution.
  </Accordion>
</AccordionGroup>