Apache JMeter プラグインと Azure Load Testing を使用してロード テストをカスタマイズする

この記事では、Azure Load Testing でのロード テスト スクリプトで Apache JMeter プラグインを使用する方法について説明します。 プラグインを使用して Apache JMeter のコア機能を拡張できます。 たとえば、データ操作を実行するための機能を追加したり、カスタム要求サンプラーを実装したりすることができます。

テスト スクリプトで JMeter プラグインを使用する場合は、Azure Load Testing のテスト エンジン インスタンスにプラグインをアップロードする必要があります。 Azure Load Testing で JMeter プラグインを使用するには、次の 2 つのオプションがあります。

• https://jmeter-plugins.org のプラグインを使用する。Azure Load Testing では、https://jmeter-plugins.org からプラグインが自動的にプレインストールされます。

• その他のプラグインを使用する。 ロード テストを作成するときは、JMeter プラグイン Java アーカイブ (JAR) ファイルをロード テストの構成に追加する必要があります。 Azure Load Testing では、ロード テストの開始時に、プラグイン JAR ファイルがテスト エンジン インスタンスにアップロードされます。

Note

独自のプラグイン コードを使用する場合は、Java 17 を使用して実行可能 JAR をビルドすることをお勧めします。

前提条件

• アクティブなサブスクリプションが含まれる Azure アカウント。 Azure サブスクリプションをお持ちでない場合は、始める前に無料アカウントを作成してください。
• Azure Load Testing リソース。 Load Testing リソースを作成するには、「ロード テストの作成と実行」を参照してください。
• (省略可能)テスト スクリプトを作成する Apache JMeter GUI。 Apache JMeter をインストールするには、「Apache JMeter はじめに」を参照してください。

テスト スクリプトで JMeter プラグインを参照する

ロード テストで JMeter プラグインを使用するには、JMX テスト スクリプトを作成し、プラグインを参照する必要があります。 Azure Load Testing を使用する場合は、スクリプトでプラグインを参照するための特別な手順はありません。

JMeter GUI を使用して、テスト スクリプトにプラグインをインストールして参照するには、次の手順に従います。

1. 次の 2 つの方法のいずれかで、JMeter プラグインをローカル JMeter インスタンスにインストールします。

   • プラグインが使用可能な場合は、 プラグイン マネージャー を使用します。

   • 独自のプラグイン コードを使用するには、プラグイン JAR ファイルをローカル JMeter インストールの lib/ext フォルダーにコピーします。

   プラグインをインストールすると、プラグイン機能が Apache JMeter ユーザー インターフェイスに表示されます。

2. これで、テスト スクリプトでプラグイン機能を参照できるようになりました。

   次のスクリーンショットは、 Example Sampler プラグインの使用方法の例を示しています。 プラグインの種類によっては、ユーザー インターフェイスのオプションが異なる場合があります。

   

Note

JMX ファイルを編集して、JMeter プラグインを直接参照することもできます。 この場合、プラグインをローカルにインストールする必要はありません。

JMeter プラグインを使用するロード テストを作成する

https://jmeter-plugins.orgからのプラグインのみを参照する場合は、JMX テスト スクリプトをアップロードしてロード テストを作成 することができます。 Azure Load Testing では、プラグイン JAR ファイルがテスト エンジン インスタンスにプレインストールされます。

テスト スクリプトで独自のプラグインを使用する場合は、プラグイン JAR ファイルをロード テスト構成に追加する必要があります。 その後、Azure Load Testing は、テストの開始時にロード テスト エンジンにプラグインをインストールします。

プラグイン JAR ファイルは、新しいロード テストを作成するとき、または既存のテストを更新するときに追加することができます。

Azure Portal

以下の手順に従って Azure portal を使用して JAR ファイルをアップロードします。

1. Azure portal の Azure Load Testing リソースに移動します。

2. 左側のウィンドウで [テスト] を選択して、テストの一覧を表示します。

3. [作成 ] > [JMeter スクリプトをアップロードする] の順に選択し、JMeter スクリプトを使用して新しいロード テストを作成します。

   

4. または、既存のロード テストがある場合は、チェック ボックスをオンにして一覧からテストを選択し、[編集] を選択します。

   

5. [テスト計画] タブを選択します。

6. お使いのコンピューターから JAR ファイルを選択し、[アップロード] を選択して Azure にファイルをアップロードします。

   

7. [適用] を選択してテストを変更するか、[レビューおよび作成] を選択して新しいテストを作成します。

   テストが実行されると、Azure Load Testing は各テスト エンジン インスタンスにプラグインをデプロイします。

GitHub Actions / Azure Pipelines

CI/CD ワークフロー内でロード テストを実行する場合は、 テスト構成 YAML ファイルの configurationFiles 設定でプラグイン JAR ファイルを参照します。

テスト構成 YAML ファイルの JAR ファイルを参照するには:

1. ロード テスト構成が含まれるソース管理リポジトリにプラグイン JAR ファイルを追加します。

2. Visual Studio Code または任意のエディターで YAML テスト構成ファイルを開きます。

3. configurationFiles 設定に JAR ファイルを追加します。 ワイルドカードを使用するか、複数の個々のファイルを指定できます。

   testName: MyTest
   testPlan: SampleApp.jmx
   description: Run a load test for my sample web app
   engineInstances: 1
   configurationFiles:
   - examplesampler-1.0.jar
   

   Note

   JAR ファイルを別のフォルダーに格納する場合は、相対パス名でファイルを指定します。 詳細については、「テスト構成 YAML 構文」を参照してください。

4. YAML 構成ファイルを保存し、ソース管理リポジトリにコミットします。

   次回 CI/CD ワークフローが実行されると、更新された構成が使用され、Azure Load Testing によって各テスト エンジン インスタンスにプラグインがデプロイされます。