Test: Cloud-based Web Performance Test

Azure Pipelines | TFS 2018 | TFS 2017 | TFS 2015


Build and release pipelines are called definitions in TFS 2018 and in older versions. Service connections are called service endpoints in TFS 2018 and in older versions.

icon Runs the Quick Web Performance Test with Azure Pipelines.

The task can be used in a build or release pipeline to generate load against an application URL using the Azure Pipelines Cloud-based Load Test Service. The Cloud-based Load Test Service is based in Microsoft Azure and can be used to test your app's performance by generating load on it, and verify it exists and is responsive.


The agent must have the following capability:

  • Azure PowerShell

YAML snippet

# Cloud-based Web Performance Test
# Runs a quick web performance test in the cloud with Azure Pipelines.
- task: QuickPerfTest@1
    #connectedServiceName: # Optional
    #vuLoad: '25' # Options: 25, 50, 100, 250
    #runDuration: '60' # Options: 60, 120, 180, 240, 300
    #geoLocation: 'Default' # Optional. Options: default, australia East, australia Southeast, brazil South, central India, central US, east Asia, east US 2, east US, japan East, japan West, north Central US, north Europe, south Central US, south India, southeast Asia, west Europe, west US
    #machineType: '0' # Options: 0, 2
    #resourceGroupName: 'default' # Optional
    #numOfSelfProvisionedAgents: # Optional
    #avgResponseTimeThreshold: '0' # Optional


Argument Description
Azure Pipelines connection The name of a Generic service connection that references the Azure DevOps organization you will be running the load test from and publishing the results to.
- Required for builds and releases on TFS and must specify a connection to the Azure DevOps organization where the load test will run.
- Optional for builds and releases on Azure Pipelines. In this case, if not provided, the current Azure Pipelines connection is used.
- See Generic service connection.
Website Url Required. The URL of the app to test.
Test Name Required. A name for this load test, used to identify it for reporting and for comparison with other test runs.
User Load Required. The number of concurrent users to simulate in this test. Select a value from the drop-down list.
Run Duration (sec) Required. The duration of this test in seconds. Select a value from the drop-down list.
Load Location The location from which the load will be generated. Select a global Azure location, or Default to generate the load from the location associated with your Azure DevOps organization.
Run load test using Select Automatically provisioned agents if you want the cloud-based load testing service to automatically provision agents for running the load tests. The application URL must be accessible from the Internet.
Select Self-provisioned agents if you want to test apps behind the firewall. You must provision agents and register them against your Azure DevOps organization when using this option. See Testing private/intranet applications using Cloud-based load testing.
Fail test if Avg. Response Time (ms) exceeds Specify a threshold for the average response time in milliseconds. If the observed response time during the load test exceeds this threshold, the task will fail.
Control options See Control options

More Information

Open source

This task is open source on GitHub. Feedback and contributions are welcome.

Q & A

I use TFS on-premises and I don't see some of these features. Why not?

Some of these features are available only on Azure Pipelines and not yet available on-premises. Some features are available on-premises if you have upgraded to the latest version of TFS.

Help and support