Manage load test results in the Load Test Results Repository

Applies to: yesVisual Studio noVisual Studio for Mac

Note

This article applies to Visual Studio 2017. If you're looking for the latest Visual Studio documentation, see Visual Studio documentation. We recommend upgrading to the latest version of Visual Studio. Download it here

When you run your load tests, any information gathered during a load test run may be stored in the Load Test Results Repository, which is a SQL database. The Load Test Results Repository contains performance counter data and any information about recorded errors. The Results Repository database is created by setup for controllers, or created automatically on the first local run of a load test. For a local run, the database will be created automatically if the load test schema is not present.

Note

Web performance and load test functionality is deprecated. Visual Studio 2019 is the last version where web performance and load testing will be fully available. For more information, see the Cloud-based load testing service end of life blog post. To reduce the impact on users some minimum support is still available in Visual Studio 2022 Preview 3 or later. Users should also note web performance and load test functionality only supports Internet Explorer which is not available on Windows 11 and some versions of Windows 10. Read more on Internet Explorer Lifecycle policy.

If you modify the controller's results repository connection string to use a different server, the new server must have the loadtestresultsrepository.sql script run to create the schema.

Visual Studio Enterprise provides named counter sets which collect common performance counters based on a technology. These sets are useful when you are analyzing an IIS server, an ASP.NET server, or a SQL server. All of the data collected with counter sets is stored in the Load Test Results Repository.

Important

There is a difference between a counter set and the performance counter data. A counter set is metadata. It defines a group of performance counters that should be collected from a computer that is performing a particular role such as IIS or SQL Server. The counter set is part of the load test definition. Performance counter data is collected based on the counter sets, the mapping of the counter set to a specific computer, and the sample rate.

SQL Server versions

To use load tests, you can use SQL Server Express LocalDB, which is installed with Visual Studio. It is the default database server for load tests (including Microsoft Excel integration). SQL Server Express LocalDB is an execution mode of SQL Server Express that is targeted to program developers. SQL Server Express LocalDB installation copies a minimal set of files necessary to start the SQL Server Database Engine.

If your team expects heavy database needs, or your projects outgrow SQL Server Express LocalDB, you should consider upgrading to either SQL Express or full SQL Server to provide further scaling potential. If you upgrade SQL Server, the MDF and LDF files for the SQL Server Express LocalDB are stored in the user profile folder. These files can be used to import the load test database to SQL Server Express or SQL Server.

Load test results store considerations

When Visual Studio Enterprise is installed, the load test results store is set up to use an instance of SQL Express that is installed on the computer. SQL Express is limited to using a maximum of 4 GB of disk space. If you will run many load tests over a long period of time, you should consider configuring the load test results store to use an instance of the full SQL Server product if available.

Load Test Analyzer tasks

Tasks Associated topics
Set up a load test results repository: You can set up a load test results repository on a SQL database. Note: A load test repository can also be created when you install a test controller. For more information, see Install and configure test agents.
Selecting and viewing a results repository: You can select a specific results repository. You are not limited to a local results store. Frequently, load tests are run on a remote set of Agent computers. Test results from your agents or your local computer can be saved to any SQL server on which you have created a load test results store. In either case, you must identify where to store your load test results by using the Administer Test Controllers window. - How to: Select a load test results repository
- How to: Access load test results for analysis
Deleting a load test result from the repository: You can remove a load test result from the Load Test Editor by using the Open and Manage Load Test Results dialog box. - How to: Delete load test results from a repository
Import and export results into a repository: You can import and export load test results from the Load Test Editor. - How to: Import load test results into a repository
- How to: Export load test results from a repository

Analyze load test results

You can view the results of both a running load test and a completed load test by using the Load Test Analyzer.

See also