Skip to content

Commit 83bf535

Browse files
Updates based on PR auto-check warnings
1 parent 83d5224 commit 83bf535

7 files changed

+17
-22
lines changed

articles/load-testing/concept-load-testing-concepts.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -113,7 +113,7 @@ A test run represents one execution of a load test. When you run a test, the tes
113113

114114
After the test run completes, you can [view and analyze the load test results in the Azure Load Testing dashboard](./tutorial-identify-bottlenecks-azure-portal.md) in the Azure portal.
115115

116-
Alternately, you can [download the test logs](./how-to-diagnose-failing-load-test.md#download-apache-jmeter-worker-logs-for-your-load-test) and [export the test results file](./how-to-export-test-results.md).
116+
Alternately, you can [download the test logs](./how-to-diagnose-failing-load-test.md#download-apache-jmeter-or-locust-worker-logs-for-your-load-test) and [export the test results file](./how-to-export-test-results.md).
117117

118118
> [!IMPORTANT]
119119
> When you update a test, the existing test runs don't automatically inherit the new settings from the test. The new settings are only used by new test runs when you run the *test*. If you rerun an existing *test run*, the original settings of the test run are used.

articles/load-testing/how-to-diagnose-failing-load-test.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -97,7 +97,7 @@ A load test can fail to complete because of multiple reasons. Examples of why a
9797
Use the following steps to help diagnose a test not finishing:
9898

9999
1. Verify the error details on the load test dashboard.
100-
1. [Download and analyze the test logs](#download-apache-jmeter-worker-logs-for-your-load-test) to identify issues in the JMeter test script.
100+
1. [Download and analyze the test logs](#download-apache-jmeter-or-locust-worker-logs-for-your-load-test) to identify issues in the JMeter test script.
101101
1. [Download the test results](./how-to-export-test-results.md) to identify issues with individual requests.
102102

103103
### Load test completed

articles/load-testing/how-to-export-test-results.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -45,7 +45,7 @@ timeStamp,elapsed,label,responseCode,responseMessage,threadName,dataType,success
4545
After a load test run finishes, you can access and download the load test results and the HTML report through the Azure portal, or as an artifact in your CI/CD workflow.
4646

4747
>[!IMPORTANT]
48-
>For load tests with more than 45 engine instances or a greater than 3-hour test run duration, the results file is not available for download. You can [configure a JMeter Backend Listener to export the results](#export-test-results-using-jmeter-backend-listeners) to a data store of your choice or [copy the results from a storage account container](#copy-test-artifacts-from-a-storage-account-container).
48+
>For load tests with more than 45 engine instances or a greater than 3-hour test run duration, the results file is not available for download. You can [configure a JMeter Backend Listener to export the results](#export-test-results-using-listeners) to a data store of your choice or [copy the results from a storage account container](#copy-test-artifacts-from-a-storage-account-container).
4949
>For tests with samplers greater than 30, the downloaded HTML report will only have graphs for data aggregated over all samplers. Graphs will not show sampler-wise data. Additionally, the downloaded report doesn't support graphs corresponding to server-side metrics.
5050
5151
# [Azure portal](#tab/portal)

articles/load-testing/how-to-high-scale-load.md

Lines changed: 4 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -149,7 +149,7 @@ To specify the load parameters for a JMeter-based load test:
149149

150150
1. On the **Edit test** page, select the **Load** tab. Use the **Engine instances** slider control to update the number of test engine instances, or enter the value directly in the input box.
151151

152-
:::image type="content" source="media/how-to-high-scale-load/edit-test-load.png" alt-text="Screenshot of the 'Load' tab on the 'Edit test' pane." lightbox="media/how-to-high-scale-load/edit-test-load.png":::
152+
:::image type="content" source="media/how-to-high-scale-load/edit-test-load.png" alt-text="Screenshot of the 'Load' tab on the 'Edit test' pane for JMeter-based tests." lightbox="media/how-to-high-scale-load/edit-test-load.png":::
153153

154154
1. Select **Apply** to modify the test and use the new configuration when you rerun it.
155155

@@ -195,7 +195,7 @@ To specify the load parameters for a Locust-based load test:
195195
1. On the **Edit test** page, select the **Load** tab. Enter the values for the overall users required and overall spwan rate in the respective input boxes.
196196
The engine instance count required to generate this load is automatically populated. If your test script is complex and resource intensive, use the **Engine instances** slider control to update the number of test engine instances, or enter the value directly in the input box.
197197
198-
:::image type="content" source="media/how-to-high-scale-load/edit-test-load-locust.png" alt-text="Screenshot of the 'Load' tab on the 'Edit test' pane." lightbox="media/how-to-high-scale-load/edit-test-load-locust.png":::
198+
:::image type="content" source="media/how-to-high-scale-load/edit-test-load-locust.png" alt-text="Screenshot of the 'Load' tab on the 'Edit test' pane for Locust-based tests." lightbox="media/how-to-high-scale-load/edit-test-load-locust.png":::
199199
200200
Alternatively, you can configure the number of users and spawn rate in the test script or Locust configuration file and provide the number of engine instances required.
201201
@@ -277,9 +277,7 @@ To achieve a target number of requests per second, configure the total number of
277277
> [!NOTE]
278278
> Apache JMeter only reports requests that made it to the server and back, either successful or not. If Apache JMeter is unable to connect to your application, the actual number of requests per second will be lower than the maximum value. Possible causes might be that the server is too busy to handle the request, or that a TLS/SSL certificate is missing. To diagnose connection problems, you can check the **Errors** chart in the load testing dashboard and [download the load test log files](./how-to-diagnose-failing-load-test.md).
279279

280-
## Test engine instances and virtual users
281-
282-
# [Apache JMeter](#tab/jmeter)
280+
## Test engine instances and virtual users for JMeter-based tests
283281

284282
In the Apache JMeter script, you can specify the number of parallel threads. Each thread represents a virtual user that accesses the application endpoint. We recommend that you keep the number of threads in a script below a maximum of 250.
285283

@@ -293,7 +291,7 @@ For example, to simulate 1,000 virtual users, set the number of threads in the A
293291

294292
The location of the Azure Load Testing resource determines the location of the test engine instances. All test engine instances within a Load Testing resource are hosted in the same Azure region.
295293

296-
# [Locust](#tab/locust)
294+
## Test engine instances and virtual users for Locust-based tests
297295

298296
Configure the total number of users required for your load test. This represents the peak number of concurrent Locust users. You can configure this in the load configuration while creating a test in Azure Load Testing. You can also configure this in your test script or the Locust configuration file. We recommend running upto 500 users from a test engine instance.
299297

articles/load-testing/how-to-parameterize-load-tests.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -265,6 +265,7 @@ You first define a user-defined variable that reads the environment variable, an
265265
```xml
266266
<stringProp name="HTTPSampler.domain">${udv_webapp}</stringProp>
267267
```
268+
268269
# [Locust](#tab/locust)
269270

270271
1. Initialize a variable with the environment variable's value using the *Name* specified in the load test configuration.

articles/load-testing/how-to-read-csv-data.md

Lines changed: 4 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -35,9 +35,7 @@ In this section, you configure your test script to reference the external CSV fi
3535
> [!IMPORTANT]
3636
> Azure Load Testing uploads the JMX file and all related files in a single folder. When you reference an external file in your JMeter script, verify that you have no file path references in your test script.
3737
38-
# [Apache JMeter](#tab/jmeter)
39-
40-
Modify the JMeter script by using the Apache JMeter GUI:
38+
For JMeter-based tests, modify the JMeter script by using the Apache JMeter GUI:
4139

4240
1. Select the **CSV Data Set Config** element in your test script.
4341

@@ -53,9 +51,7 @@ Modify the JMeter script by using the Apache JMeter GUI:
5351

5452
1. Save the JMeter script and upload the script to your load test.
5553

56-
# [Locust](#tab/locust)
57-
58-
Modify the Locust script by opening it an editor of your choice.
54+
For Locust-based tests, update the Locust script by opening it an editor of your choice.
5955

6056
1. In the section where you open the file, update the **Filename** information and remove any file path reference.
6157

@@ -130,7 +126,7 @@ For example, if you have a large customer CSV input file, and the load test runs
130126
131127
> [!IMPORTANT]
132128
> Azure Load Testing doesn't preserve the header row when splitting your CSV file.
133-
> 1. [Configure your test script](#update-your-jmeter-script-to-read-csv-data) to use variable names when reading the CSV file.
129+
> 1. [Configure your test script](#update-your-test-script-to-read-csv-data) to use variable names when reading the CSV file.
134130
> 1. Remove the header row from the CSV file before you add it to the load test.
135131
136132
To configure your load test to split input CSV files:
@@ -173,7 +169,7 @@ To configure your load test to split input CSV files:
173169

174170
### Test status is failed and test log has `File {my-filename} must exist and be readable`
175171

176-
When the load test completes with the Failed status, you can [download the test logs](./how-to-diagnose-failing-load-test.md#download-apache-jmeter-worker-logs-for-your-load-test).
172+
When the load test completes with the Failed status, you can [download the test logs](./how-to-diagnose-failing-load-test.md#download-apache-jmeter-or-locust-worker-logs-for-your-load-test).
177173

178174
When you receive an error message `File {my-filename} must exist and be readable` in the test log, the input CSV file couldn't be found when running the test script.
179175

articles/load-testing/how-to-test-secured-endpoints.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -130,11 +130,9 @@ The following code snippet gives an example of how to configure a load test secr
130130
```
131131
---
132132

133-
### Retrieve and use the secret value in the test script
133+
### Retrieve and use the secret value in the JMeter script
134134

135-
You can now retrieve the secret value in the test script and pass it to the application request. For example, use an `Authorization` HTTP header to pass an OAuth token to a request.
136-
137-
# [Apache JMeter](#tab/jmeter)
135+
You can now retrieve the secret value in the JMeter script by using the `GetSecret` custom function and pass it to the application request. For example, use an `Authorization` HTTP header to pass an OAuth token to a request.
138136

139137
1. Create a user-defined variable that retrieves the secret value with the `GetSecret` custom function:
140138

@@ -148,7 +146,9 @@ You can now retrieve the secret value in the test script and pass it to the appl
148146

149147
:::image type="content" source="./media/how-to-test-secured-endpoints/jmeter-add-http-header.png" alt-text="Screenshot that shows how to add an authorization header to a request in JMeter." lightbox="./media/how-to-test-secured-endpoints/jmeter-add-http-header.png":::
150148

151-
# [Locust](#tab/locust)
149+
### Retrieve and use the secret value in the Locust script
150+
151+
You can now retrieve the secret value in the Locust script and pass it to the application request. For example, use an `Authorization` HTTP header to pass an OAuth token to a request.
152152

153153
The secrets configured in the load test configuration are accessible as environment variables.
154154

0 commit comments

Comments
 (0)