你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

使用 Apache JMeter 插件和 Azure 负载测试自定义负载测试

本文介绍如何在负载测试脚本中使用 Apache JMeter 插件和 Azure 负载测试。可以使用插件扩展 Apache JMeter 的核心功能。例如，若要添加用于执行数据操作的功能、实现自定义请求采样器等。

在测试脚本中使用 JMeter 插件时，需要将该插件上传到 Azure 负载测试中的测试引擎实例。有两个选项可用于将 JMeter 插件与 Azure 负载测试配合使用：

来自 https://jmeter-plugins.org. 的插件Azure 负载测试会自动从 https://jmeter-plugins.org中预安装插件。
其他插件。创建负载测试时，需要将 JMeter 插件 Java 存档（JAR）文件添加到负载测试配置。 Azure 负载测试在负载测试启动时将插件 JAR 文件上传到测试引擎实例。

注意

如果使用自己的插件代码，建议使用 Java 17 生成可执行 JAR。

先决条件

若要在负载测试中使用 JMeter 插件，必须创作 JMX 测试脚本并引用插件。使用 Azure 负载测试时，脚本中没有引用插件的特殊说明。

按照以下步骤使用 JMeter GUI 在测试脚本中安装和引用插件：

通过以下两种方式之一在本地 JMeter 实例上安装 JMeter 插件：
- 如果插件可用，请使用插件管理器。
- 若要使用自己的插件代码，请将插件 JAR 文件复制到 lib/ext 本地 JMeter 安装的文件夹。
安装插件后，插件功能将显示在 Apache JMeter 用户界面中。
现在可以在测试脚本中引用插件功能。

以下屏幕截图显示了如何使用 示例采样器 插件的示例。根据插件的类型，用户界面中可能有不同的选项。

注意

还可以通过编辑 JMX 文件直接引用 JMeter 插件。在这种情况下，无需在本地安装插件。

如果仅引用插件 https://jmeter-plugins.org，可以通过上传 JMX 测试脚本来创建负载测试。 Azure 负载测试将插件 JAR 文件预安装到测试引擎实例上。

如果在测试脚本中使用自己的插件，则必须将插件 JAR 文件添加到负载测试配置。然后，Azure 负载测试会在测试启动时在负载测试引擎上安装插件。

可以在创建新的负载测试时或随时更新现有测试时添加插件 JAR 文件。

按照以下步骤使用 Azure 门户上传 JAR 文件：

在 CI/CD 工作流中运行负载测试时，会在测试配置 YAML 文件中的设置中configurationFiles引用插件 JAR 文件。

若要在测试配置 YAML 文件中引用插件 JAR 文件，请执行以下操作：

将插件 JAR 文件添加到源代码管理存储库，其中包含负载测试配置。
在 Visual Studio Code 或所选编辑器中打开 YAML 测试配置文件。
将 JAR 文件添加到 configurationFiles 设置。可使用通配符或指定多个单独的文件。
```
testName: MyTest
testPlan: SampleApp.jmx
description: Run a load test for my sample web app
engineInstances: 1
configurationFiles:
- examplesampler-1.0.jar
```
注意

如果将 JAR 文件存储在单独的文件夹中，请指定具有相对路径名称的文件。有关详细信息，请参阅测试配置 YAML 语法。
保存 YAML 配置文件并将其提交到源代码管理存储库。

下次运行 CI/CD 工作流时，它将使用更新的配置，Azure 负载测试将在每个测试引擎实例上部署插件。