Test: Cloud-based Web Performance Test

VSTS | 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 VSTS.

The task can be used in a build or release pipeline to generate load against an application URL using the VSTS 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 build agent must have the following capabilities:

  • MSBuild
  • Azure PowerShell

YAML snippet

# Cloud-based Web Performance Test
# Runs a quick web performance test in the cloud with Visual Studio Team Services
- 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
VSTS connection The name of a Generic service connection that references the VSTS 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 VSTS organization where the load test will run.
- Optional for builds and releases on VSTS. In this case, if not provided, the current VSTS 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 VSTS 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 VSTS 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 VSTS 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