使用 Apache JMeter 外掛程式和 Azure 負載測試自訂負載測試

在本文中，您將瞭解如何在負載測試腳本中使用 Apache JMeter 外掛程式搭配 Azure 負載測試。您可以使用外掛程式擴充 Apache JMeter 的核心功能。例如，若要新增執行資料操作的功能、實作自訂要求取樣器等等。

當您在測試腳本中使用 JMeter 外掛程式時，外掛程式必須上傳至 Azure 負載測試中的測試引擎實例。您有兩個選項可搭配 Azure 負載測試使用 JMeter 外掛程式：

來自 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 負載測試會在每個測試引擎實例上部署外掛程式。