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

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

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

在测试脚本中使用 JMeter 插件时，需要将该插件上传到 Azure 负载测试中的测试引擎实例。 可以通过两种方式将 JMeter 插件与 Azure 负载测试结合使用：

• 来自 https://jmeter-plugins.org 的插件。Azure 负载测试会自动从 https://jmeter-plugins.org 预安装插件。

• 其他插件。 创建负载测试时，需要将 JMeter 插件 Java 存档 (JAR) 文件添加到负载测试配置。 Azure 负载测试会在负载测试启动时将插件 JAR 文件上传到测试引擎实例。

注意

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

先决条件

• 具有活动订阅的 Azure 帐户。 如果没有 Azure 订阅，请在开始之前创建一个免费帐户。
• Azure 负载测试资源。 若要创建负载测试资源，请参阅创建并运行负载测试。
• （可选）Apache JMeter GUI，用于创作测试脚本。 若要安装 Apache JMeter，请参阅 Apache JMeter 入门。

在测试脚本中引用 JMeter 插件

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

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

1. 通过以下两种方式之一在本地 JMeter 实例上安装 JMeter 插件：

   • 如果插件可用，请使用插件管理器。

   • 若要使用自己的插件代码，请将插件 JAR 文件复制到本地 JMeter 安装的 lib/ext 文件夹中。

   安装插件后，插件功能将显示在 Apache JMeter 用户界面中。

2. 现在可以在测试脚本中引用插件功能。

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

   

注意

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

创建使用 JMeter 插件的负载测试

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

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

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

Azure 门户

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

1. 在 Azure 门户中，转到 Azure 负载测试资源。

2. 在左窗格中，选择“测试”以查看测试列表。

3. 选择“创建”>“上传 JMeter 脚本”以使用 JMeter 脚本创建新的负载测试。

   

4. 或者，如果你有现有的负载测试，请通过选中复选框从列表中选择该测试，然后选择“编辑”。

   

5. 选择“测试计划”选项卡。

6. 从计算机中选择 JAR 文件，然后选择“上传”，将文件上传到 Azure。

   

7. 选择“应用”以修改测试，或选择“查看 + 创建”来创建新测试。

   测试运行时，Azure 负载测试将在每个测试引擎实例上部署插件。

GitHub Actions/Azure Pipelines

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

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

1. 将插件 JAR 文件添加到源代码管理存储库，其中包含负载测试配置。

2. 在 Visual Studio Code 或首选编辑器中打开 YAML 测试配置文件。

3. 将 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 语法。

4. 保存 YAML 配置文件并将其提交到源代码管理存储库。

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