SQL Server Reporting Services LoadTest
This project contains a Visual Studio Load Test 2015 solution to execute synthetic load for SQL Server Reporting Services 2016, SQL Server Reporting Services 2017 and Power BI Report Server. It uses Visual Studio 2015 Enterprise but you can also run them in Visual Studio 2017 Enterprise.
The usage of the project requires a good understanding of Reporting Services and the different types of items (reports, datasets, data sources, mobile reports, Power BI reports, Excel workbooks) that are available in SQL Server Reporting Services/Power BI Report Server. There is an extensive use of APIs in this project, which is not designed for typical user comsumption and can change in future versions of SQL Server Reporting Services and/or Power BI Report Server.
In a Visual Studio Tools Command Prompt
c:\repos\Reporting-Services-LoadTest>build.cmd
Integration tests that requires a configured SQL Server Reporting Services 2016
c:\repos\Reporting-Services-LoadTest>Test.cmd
Integration tests that requires a configured SQL Server Reporting Services 2016 and the Data sources
c:\repos\Reporting-Services-LoadTest>TestContent.cmd
Included integration tests that requires a configured SQL Server Reporting Services Technical Preview with the Data sources
c:\repos\Reporting-Services-LoadTest>TestContentWithPBI.cmd
You can also build and run the tests from Visual Studio 2015, in such case ensure is using RSLoadTest.testsettings
- Visual Studio Menu > Test > Test Settings > Select Test Settings File
This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.
The tests can be executed locally or in the cloud, instructions for both are detailed below
Update the file RSTest.Common.ReportServer.dll.Config with the Reporting Services environment
<Configuration>
<ReportServerUrl>http://ssrs.westus.cloudapp.azure.com/ReportServer</ReportServerUrl>
<ReportPortalUrl>http://ssrs.westus.cloudapp.azure.com/Reports</ReportPortalUrl>
<DatasourceDatabaseServer>ssrs-datasource</DatasourceDatabaseServer>
<ExecutionAccount>contoso\ProvideAUser</ExecutionAccount>
<ExecutionAccountPwd>ProvideAPassword</ExecutionAccountPwd>
<DatasourceSQLUser>ProvideASQLUser</DatasourceSQLUser>
<DatasourceSQLPassword>ProvideASQLPassword</DatasourceSQLPassword>
<ASWindowsUser>contoso\ProvideAUser</ASWindowsUser>
<ASWindowsPassword>ProvideAPassword</ASWindowsPassword>
</Configuration>- ReportServerUrl, ReportPortalUrl should be updated to the correct location
- ExecutionAccount and ExecutionAccountPwd should be windows users that have administrator privileges in the Reporting Services Portal
- DatasourceSQLUser and DatasourceSQLPassword should be SQL Logins with access to the databases specified in the data sources
- ASWindowsUser and ASWindowsPassword should be windows user that is able to connect to the Analysis Services databases specified in Power BI Reports
In order to create a SQL Server Reporting Services Load enviroment in Azure see the section Create a SSRS Load Environment in Azure
This setting is defined in the rsreportserver.config file in the Reporting Services Server you are testing, the tests use only one Windows user to access the server and the default value is 20, if is not modified an artificial throttling will affect the test results
- Open the RSLoadTest.testsettings file (double click on the file) and select "Run tests using local computer or a test controller"
- Open the LoadTest to run (For example MixedLoad.loadtest)
- Run the test
- In the left upper corner there is a test dropdown
- Select Run Load Test or Debug Load Test
- Make sure that you have a reasonable amount of users for a local run so you can adequately debug.
- In the left upper corner there is a test dropdown
In case you need to store a large number of test results is recommended to use a Load Test Results Repository Using SQL
- Create a Load Database, detailed instructions here https://msdn.microsoft.com/en-us/library/ms182600.aspx
- Visual Studio Menu > Load Test > Manage Test Controller
- Controller: Select "Local No Controller"
- Load test result store: Your configured load database store from the previous step
- Open the RSLoadTest.testsettings file (double click on the file) and select "Run tests using local computer or a test controller"
- Open the LoadTest to run (For example MixedLoad.loadtest)
- Run the test
- Open the RSLoadTest.testsettings file (double click on the file) and select "Run Tests Using Visual Studio Team Services"
- Detailed instructions on https://www.visualstudio.com/en-us/docs/test/performance-testing/getting-started/getting-started-with-performance-testing , check the section Connect to your Visual Studio Team Services account for example https://ssrsload.visualstudio.com
- Open the load solution
- Connect to your Visual Studio Team Services account (for example https://ssrsload.visualstudio.com)
- Open the Load Test Manager
- Load Test > Load Test Manager
- Double click in the result you want to see
You can use the UI
or PowerShell
- Install Azure PowerShell (https://azure.microsoft.com/en-us/documentation/articles/powershell-install-configure/)
- Edit the \Reporting-Services-LoadTest\ArmTemplate\SSRS-MultiMachine\azuredeploy.parameters.json
- Provide a unique ssrsDNSPrefix
- Provide the passwords (this user and passwords need to be used on RSTest.Common.ReportServer.dll.Config)
- Edit other parameter of the template such as VM Size
- Replace 'YOUR_RESOURCE_GROUP_NAME' to a unique resource group name and then run the deployment using the following command:
PS C:\repos\Reporting-Services-LoadTest\ArmTemplate\SSRS-MultiMachine\> .\Deploy-AzureResourceGroup.ps1 -ResourceGroupName 'YOUR_RESOURCE_GROUP_NAME' -ResourceGroupLocation 'westus2' -TemplateFile azuredeploy.json -TemplateParametersFile azuredeploy.parameters.json- Remote desktop into the Azure RS machine named SSRS-RS (using username and password specified in azuredeploy.parameters.json)
- Configure SQL Server Reporting Services and ensure is running
- In case you need to do advanced troubleshooting configure the service to take Full Dumps rsreportserver.config
- Increase the number of MaxActiveReqForOneUser to at least 800 in rsreportserver.config (but this really depends on your load test configuration)
The deployment will take around 30 minutes. It sets up a Domain Controller, a RS Server, a SQL Server with Catalog DB and another SQL Server with a set o fdatabases that the tests uses.
How to onboard a new Paginated Reports Scenario
How to onboard a new Mobile Reports Scenario
How to onboard a new PowerBI Reports
The LoadTest files contains a set of scenarios that will drive the load in the system, those are standard Visual Studio Load Test files and the details of the different settings can be found on Editing Load Test Using the Load Test Editor
The Load tests deploy a set of Reports, Data sources, Mobile Reports, KPIs, Power BI Reports, and Excel Workbooks during the initialization. Most of those resources can be found under Reporting-Services-LoadTest\src\RSLoad\ContentManager\RuntimeResources. The remaining of the resources are stored at https://rsload.blob.core.windows.net/load/largefiles. Due to GitHub restriction of a file size cannot exceed 100 MB, we had to store any resource that exceeded this size in the public facing RSLoad blob.
All the databases used in the tests can be found https://rsload.blob.core.windows.net/load/databases. In order to deploy them to your environment, you can run the CreateDataBase.sql script (located in that folder).
The load test consists of several scenarios, which each require one or more resources. Prior to executing a scenarion, a folder will be created on the Report Server with the scenario's name. Then all the resources, required by the tests of that scenario, will be deploy on the Report Server. There will also be a set of shared data sources created in each folder. These data sources are defined in Reporting-Services-LoadTest\src\RSLoad\ContentManager\DataSources.xml.
None of the load tests create subscriptions, cache refresh plans or schedule data refreshes. Historically, this was done because the underlying code involved behind subscriptions and cache refresh plans was the same as rendering a paginated report. However, starting with the introduction of Power BI Reports with embedded models, we recommend you to create Schedule Data Refreshes prior to executing a load test. To learn more on how to create a schedule data refresh, please look at our Documentation.
- DataSources.xml : Define the datasources that will be created in the server during the test initialization (Located on Reporting-Services-LoadTest\src\RSLoad\ContentManager\DataSources.xml)
- Paginated Reports Only
- ScaleReportsWeight.xml: Specifies how often a report will be used during the test execution (Located on Reporting-Services-LoadTest\src\RSLoad\ContentManager\Paginated\ScaleReportsWeight.xml)
- BadCombinations.xml: Specifies what combinatios of tests and reports shouldn't be used (Located on Reporting-Services-LoadTest\src\RSLoad\ContentManager\Paginated\BadCombinations.xml)