Load test a website by using a JMeter script in Azure Load Testing

1. Sign in to the Azure portal by using the credentials for your Azure subscription.

2. From the Azure portal menu or the Home page, select Create a resource.

3. On the Marketplace page, search for and select Azure Load Testing.

4. On the Azure Load Testing pane, select Create.

5. On the Create a load testing resource page, enter the following information:

   Field	Description
   Subscription	Select the Azure subscription that you want to use for this Azure Load Testing resource.
   Resource group	Select an existing resource group. Or select Create new, and then enter a unique name for the new resource group.
   Name	Enter a unique name to identify your Azure Load Testing resource. The name can't contain special characters, such as \/""[]:|<>+=;,?*@&, or whitespace. The name can't begin with an underscore (_), and it can't end with a period (.) or a dash (-). The length must be 1 to 64 characters.
   Location	Select a geographic location to host your Azure Load Testing resource. This location also determines where the test engines are hosted and where the test framework requests originate from.

   Note

   Optionally, you can configure more details on the Tags tab. Tags are name/value pairs that enable you to categorize resources and view consolidated billing by applying the same tag to multiple resources and resource groups.

6. After you're finished configuring the resource, select Review + Create.

7. Review the settings you provide, and then select Create. It takes a few minutes to create the account. Wait for the portal page to display Your deployment is complete before moving on.

8. To view the new resource, select Go to resource.

   

9. Optionally, manage access to your Azure Load Testing resource.

   Azure Load Testing uses role-based access control (RBAC) to manage permissions for your resource. If you encounter this message, your account doesn't have the necessary permissions to manage tests.

   

1. Sign into Azure:

   az login
   

2. Set parameter values:

   The following values are used in subsequent commands to create the load testing resource.

   loadTestResource="<load-testing-resource-name>"
   resourceGroup="<resource-group-name>"
   location="East US"
   

3. Create an Azure load testing resource with the azure load create command:

   az load create --name $loadTestResource --resource-group $resourceGroup --location $location
   

4. After the resource is created, you can view the details with the azure load show command:

   az load show --name $loadTestResource --resource-group $resourceGroup
   

To create a load test using an existing JMeter script in the Azure portal:

1. In the Azure portal, go to your Azure Load Testing resource.

2. In the left navigation, select Tests to view all tests.

3. Select + Create, and then select Upload a JMeter script.

   

4. On the Basics tab, enter the load test details:

   Field	Description
   Test name	Enter a unique test name.
   Test description	(Optional) Enter a load test description.
   Run test after creation	Select this setting to automatically start the load test after saving it.

5. On the Test plan tab, select your Apache JMeter script, and then select Upload to upload the file to Azure.

   

   Note

   You can upload additional JMeter configuration files or other files that you reference in the JMX file. For example, if your test script uses CSV data sets, you can upload the corresponding .csv file(s). See also how to read data from a CSV file. For files other than JMeter scripts and user properties, if the size of the file is greater than 50 MB, zip the file. The size of the zip file should be below 50 MB. Azure Load Testing automatically unzips the file during the test run. Only five zip artifacts are allowed with a maximum of 1000 files in each zip and an uncompressed total size of 1 GB.

6. Select Review + create. Review all settings, and then select Create to create the load test.

To create a load test using an existing JMeter script with the Azure CLI:

1. Set parameter values.

   Specify a unique test ID for your load test, and the name of the JMeter test script (JMX file). If you use an existing test ID, a test run will be added to the test when you run it.

   testId="<test-id>"
   testPlan="<my-jmx-file>"
   

2. Use the azure load create command to create a load test:

   The following command creates a load test by using uploading the JMeter test script. The test runs on one test engine instance.

   az load test create --load-test-resource  $loadTestResource --test-id $testId  --display-name "My CLI Load Test" --description "Created using Az CLI" --test-plan $testPlan --engine-instances 1
   

If you selected Run test after creation, your load test will start automatically. To manually start the load test you created earlier, perform the following steps:

1. Go to your load testing resource, select Tests from the left pane, and then select the test that you created earlier.

   

2. On the test details page, select Run or Run test. Then, select Run on the confirmation pane to start the load test. Optionally, provide a test run description.

   

   Tip

   You can stop a load test at any time from the Azure portal.

3. Notice the test run details, statistics, and client metrics in the Azure portal.

   If you have multiple requests in your test script, the charts display all requests, and you can also filter for specific requests.

   

   Use the run statistics and error information to identify performance and stability issues for your application under load.

To run the load test you created previously with the Azure CLI:

1. Set parameter values.

   Specify a test run ID and display name.

   testRunId="run_"`date +"%Y%m%d%_H%M%S"`
   displayName="Run"`date +"%Y/%m/%d_%H:%M:%S"`
   

2. Use the azure load test-run create command to run a load test:

   az load test-run create --load-test-resource $loadTestResource --test-id $testId --test-run-id $testRunId --display-name $displayName --description "Test run from CLI"
   

3. Retrieve the client-side test metrics with the az load test-run metrics list command:

   az load test-run metrics list --load-test-resource $loadTestResource --test-run-id $testRunId --metric-namespace LoadTestRunMetrics