Creating a Multi-Test

Create multi-tests for distributed load testing. The multi-test synchronizes and aggregates the results from multiple test sessions into a single aggregated report.

The multi-test configuration includes individual test configurations orchestrated to run simultaneously. Each test is still individual and can be run independently as well.

In order to create multi-tests, you must have an account on a Pro subscription or higher.

Set Up a Multi-Test

  • Only tests within the same project can be included in a multi-test.
  • You cannot add a specific test multiple times to the same multi-test with the same name. Instead, make one or more copies of the test, each with unique test names that are different from the original test name. Then, when building the multi-test, add the original test and its copies.

Follow these steps:

  1. In the main menu, click the Performance tab.
  2. Click Create Test.
  3. Select a project.
  4. Click Multi Test.
    create a multi test
    A multi-test configuration screen opens.
    multi test
  5. Click the Add tests search box.
    A drop-down list with tests appears.
  6. Check the box next to each test that you want to add to the multi-test. You can also type in a name of the test and then select the test.

  7. Click the Add tests button at the bottom of the list.

    You can only add up to 20 scenarios in one multi-test.

    multi tests selection

To close the window, click anywhere outside of the window.

Your multi-test summary shows:

multi test summary

Review the Summary

The main Summary section of the configuration page provides an overview of of the combined multi-test.

  • Scenarios
    Shows the total number of scenarios (single tests) that you chose for the multi-test, and lists the name of each scenario.
  • Locations
    Lists all locations used by all scenarios combined.
  • Duration
    The total duration of the entire multi-test. This duration is determined by the duration of your single scenarios.
  • VU
    The total number of virtual users (VUs) executed across all scenarios combined.

The graph to the right of the summary is a visual representation of the total VUs (y-axis) across the total duration (x-axis).

Review the Scenarios

Under the summary is a section dedicated to each individual scenario within the multi-test.

The initial scenario window displays (from top-left to bottom-right):

  • The name of the single test.
  • The name of the single tests scenario(s).
  • The type of test.
  • The location(s) the test will run from.
  • The total virtual users to run.
  • The duration of the single test.

Modify the Scenarios

To expand the scenario summary to see additional details, click the right arrow (>) in the individual scenario summary. To remove a test, click the bin icon for the scenario.

remove test

multi test 2

A miniature version of the Load Configuration and the Load Distribution screens appears. You can modify an individual test scenario but only when it runs as part of this multi-test.

Disabling overrides in Load Configuration will cause the values to be taken from the single test's original script, and not from that test's original configuration (if overrides are enabled).

Run the Multi-Test

Once you are satisfied with the summary and have made any adjustment to your scenarios, click the Run Test button on the left-hand side of the screen to run your new multi-test.

run test

The next screen provides a final summary of the test you are about to execute.

launch multi test

There are two options you can select prior to launching:

  • Synchronized start
    Ensures that all servers are up before actually starting the test. Select this option if you have a concern that some servers or locations are significantly slower than others and you wish to synchronize them.
  • Run test in the background
    Executes the test behind the scenes so that you can continue working in BlazeMeter.

Add Load or Logic During a Test

You can add additional load or entirely new test logic to a large test that is already running. No need to stop, reconfigure and re-launch. Launch an additional test and join it to the multi-test in progress.

Follow these steps:

  1. Start a multi-test.
  2. Once the multi-test is started, start an individual single test.
  3. On the Launch Test screen, click the dropdown menu under Run this test as part of a master session? and select Run as a test under {name of your multi-test}.
    launch test config
  4. Click the Launch Servers button.

You can then return to your multi-test in progress, which is now running with the additional scenario.

For more information, including how to add tests via the API, see Adding Users Dynamically.