Merge pull request #241487 from ntrogh/alt-jmeter-features

[Azure Load Testing] Add resource article for supported JMeter features

Author: v-ccolin

articles/load-testing/how-to-create-and-run-load-test-with-jmeter-script.md

@@ -13,9 +13,7 @@ adobe-target: true
 
 # Load test a website by using an existing JMeter script in Azure Load Testing
 
-Learn how to use an Apache JMeter script to load test a web application with Azure Load Testing from the Azure portal.
-
-Azure Load Testing enables you to take an existing Apache JMeter script, and use it to run a load test at cloud scale. Alternatively, you can also [create a URL-based load test in the Azure portal](./quickstart-create-and-run-load-test.md).
+Learn how to use an Apache JMeter script to load test a web application with Azure Load Testing from the Azure portal. Azure Load Testing enables you to take an existing Apache JMeter script, and use it to run a load test at cloud scale. Learn more about which [JMeter functionality that Azure Load Testing supports](./resource-jmeter-support.md).
 
 Use cases for creating a load test with an existing JMeter script include:
 
@@ -24,6 +22,8 @@ Use cases for creating a load test with an existing JMeter script include:
 - You have a data-driven load test. For example, you want to [read CSV data in a load test](./how-to-read-csv-data.md).
 - You want to test endpoints that are not HTTP-based, such as databases or message queues. Azure Load Testing supports all communication protocols that JMeter supports.
 
+If you want to create a load test without a JMeter script, learn how you can [create a URL-based load test in the Azure portal](./quickstart-create-and-run-load-test.md).
+
 ## Prerequisites
 
 - An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).

articles/load-testing/overview-what-is-azure-load-testing.md

@@ -71,7 +71,7 @@ You can trigger Azure Load Testing from Azure Pipelines or GitHub Actions workfl
 
 ## How does Azure Load Testing work?
 
-Azure Load Testing uses Apache JMeter version 5.5 for running load tests. You can use Apache JMeter plugins from https://jmeter-plugins.org or [upload your own plugin code](./how-to-use-jmeter-plugins.md). Azure Load Testing supports all communication protocols that JMeter supports. For example, to load test a database connection or message queue.
+Azure Load Testing uses Apache JMeter for running load tests. You can use Apache JMeter plugins from https://jmeter-plugins.org or [upload your own plugin code](./how-to-use-jmeter-plugins.md). Azure Load Testing supports all communication protocols that JMeter supports. For example, to load test a database connection or message queue. Learn more about the [supported Apache JMeter functionality](./resource-jmeter-support.md).
 
 The Azure Load Testing test engines abstract the required infrastructure for [running a high-scale load test](./how-to-high-scale-load.md). Each test engine instance runs your JMeter script to simulate a large number of virtual users simultaneously accessing your application endpoints. When you create a load test based on a URL (*quick test*), Azure Load Testing automatically generates a JMeter test script for you. To scale out the load test, you can configure the number of test engines.
 

articles/load-testing/resource-jmeter-support.md

@@ -0,0 +1,46 @@
+---
+title: Supported Apache JMeter features
+titleSuffix: Azure Load Testing
+description: Learn which Apache JMeter features are supported in Azure Load Testing. You can upload an existing JMeter script to create and run a load test.
+services: load-testing
+ms.service: load-testing
+ms.topic: reference
+ms.author: nicktrog
+author: ntrogh
+ms.date: 06/14/2023
+---
+
+# Supported Apache JMeter features in Azure Load Testing
+
+Azure Load Testing enables you to use an existing Apache JMeter script (JMX) to create and run a load test. This article explains which Apache JMeter features are supported in Azure Load Testing.
+
+See the Azure Load Testing overview to learn [how Azure Load Testing works](./overview-what-is-azure-load-testing.md#how-does-azure-load-testing-work).
+
+## Supported Apache JMeter version
+
+Azure Load Testing uses Apache JMeter version 5.5 for running load tests.
+
+## Apache JMeter support details
+
+The following table lists the Apache JMeter features and their support in Azure Load Testing.
+
+| Feature | Details | More information |
+| ------- | ------- | ---------------- |
+| Test plan elements | - Thread groups<br/>- Variables<br/>- Functions<br/>- Samplers<br/>- Logic controllers<br/>- Timers<br/>- Assertions<br/>- Preprocessors<br/>- Postprocessors | [Create a load test by using a JMeter script](./how-to-create-and-run-load-test-with-jmeter-script.md) |
+| Samplers | All samplers and protocols are supported. | [Create a load test with a JMeter script](./how-to-create-and-run-load-test-with-jmeter-script.md) |
+| Controllers | All logic controllers are supported, except for [Include controller](https://jmeter.apache.org/usermanual/component_reference.html#Include_Controller), [Module controller](https://jmeter.apache.org/usermanual/component_reference.html#Module_Controller), and [Recording controller](https://jmeter.apache.org/usermanual/component_reference.html#Recording_Controller). | [Create a load test with a JMeter script](./how-to-create-and-run-load-test-with-jmeter-script.md) |
+| Scripting | - BeanShell<br/>- JSR223 script | |
+| Configuration elements | All configuration elements are supported.  | Example: [Read data from a CSV file](./how-to-read-csv-data.md) |
+| JMeter properties | Azure Load Testing supports uploading a single user properties file per load test to override JMeter configuration settings or add custom properties.<br/>System properties files aren't supported. | [Configure JMeter user properties](./how-to-configure-user-properties.md) |
+| Plugins | Azure Load Testing lets you use plugins from https://jmeter-plugins.org, or upload a Java archive (JAR) file with your own plugin code.<br/>The [Web Driver sampler](https://jmeter-plugins.org/wiki/WebDriverSampler/) and any plugins that use backend listeners aren't supported. | [Customize a load test with plugins](./how-to-use-jmeter-plugins.md) |
+| Listeners | Azure Load Testing ignores all [Results Collectors](https://jmeter.apache.org/api/org/apache/jmeter/reporters/ResultCollector.html), which includes visualizers such as the [results tree](https://jmeter.apache.org/usermanual/component_reference.html#View_Results_Tree) or [graph results](https://jmeter.apache.org/usermanual/component_reference.html#Graph_Results).<br/>[Backend listeners](https://jmeter.apache.org/usermanual/component_reference.html#Backend_Listener) aren't supported. | |
+| Dashboard report | The Azure Load Testing dashboard shows the client metrics, and optionally the server-side metrics. <br/>You can export the load test results to use them in a reporting tool or [generate the JMeter dashboard](https://jmeter.apache.org/usermanual/generating-dashboard.html#report) on your local machine.| [Export test results](./how-to-export-test-results.md) | 
+| Test fragments| Not supported. | |
+
+## Next steps
+
+Start using Azure Load Testing:
+
+- [Quickstart: Create a URL-based load test from the Azure portal](./quickstart-create-and-run-load-test.md)
+- [Create a load test with a JMeter script](./how-to-create-and-run-load-test-with-jmeter-script.md)
+- [Quickstart: Add a load test to CI/CD](./quickstart-add-load-test-cicd.md)

articles/load-testing/toc.yml

@@ -120,6 +120,8 @@ items:
       href: https://azure.microsoft.com/explore/global-infrastructure/products-by-region/?products=load-testing
     - name: Samples
       href: /samples/?expanded=azure&products=azure-load-testing
+    - name: Supported Apache JMeter features
+      href: resource-jmeter-support.md
     - name: Supported Azure resource types
       href: resource-supported-azure-resource-types.md
     - name: Service limits