サードパーティ製のツールで使用するために Azure Load Testing からテスト結果をエクスポートする

[アーティクル]
02/19/2024

この記事では、Azure Load Testing のテスト結果をエクスポートする方法について説明します。結果は Azure portal を利用してダウンロードするか、CI/CD ワークフローで成果物としてダウンロードするか、バックエンドリスナーを利用して JMeter でダウンロードするか、Azure ストレージアカウントからコピーできます。これらの結果は、サードパーティ製のツールでのレポート作成やテストエラーの診断に使用される可能性があります。 Azure Load Testing では、コンマ区切り値 (CSV) ファイル形式でテスト結果を生成し、ロードテストの各アプリケーション要求の詳細が提供されます。

ロードテスト中のエラーを診断するためにテスト結果を使うこともできます。 responseCode と responseMessage の各フィールドで、失敗した要求に関する詳細な情報がわかります。エラーの調査の詳細については、失敗したロードテストを診断する方法に関するページを参照してください。

こちらで説明する手順に従って、CSV ログファイルから Apache JMeter ダッシュボードを生成できます。

前提条件

アクティブなサブスクリプションが含まれる Azure アカウント。 Azure サブスクリプションをお持ちでない場合は、始める前に無料アカウントを作成してください。
テスト実行が完了した Azure Load Testing リソース。 Azure Load Testing リソースを作成する必要がある場合は、ロードテストの作成と実行に関するページを参照してください。

テスト結果ファイル形式

Azure Load Testing では、テストエンジンインスタンスごとにテスト結果の CSV ファイル生成されます。ロードテストをスケールアウトする方法を確認してください。

Azure Load Testing では、Apache JMeter CSV ログ形式が使用されます。各フィールドの詳細については、Apache JMeter ドキュメントの JMeter 用語集を参照してください。

ロードテストの実行に対する各アプリケーション要求の詳細は、テスト結果ファイルで確認できます。次のスニペットは、テスト結果のサンプルを示しています。

timeStamp,elapsed,label,responseCode,responseMessage,threadName,dataType,success,failureMessage,bytes,sentBytes,grpThreads,allThreads,URL,Latency,IdleTime,Connect
1676040230680,104,Homepage,200,OK,172.18.33.7-Thread Group 1-5,text,true,,1607,133,5,5,https://www.example.com/,104,0,100
1676040230681,101,Homepage,200,OK,172.18.33.7-Thread Group 1-3,text,true,,1591,133,5,5,https://www.example.com/,101,0,93
1676040230680,101,Homepage,200,OK,172.18.33.7-Thread Group 1-1,text,true,,1591,133,5,5,https://www.example.com/,98,0,94

ロードテストの結果にアクセスしてダウンロードする

ロードテストの実行が完了したら、Azure portal から、または CI/CD ワークフローの成果物として、ロードテストの結果にアクセスしてダウンロードできます。

重要

エンジンインスタンスが 45 を超える、またはテストの実行期間が 3 時間を超えるロードテストの場合、結果ファイルはダウンロードできません。 JMeter バックエンドリスナーを構成して、選択したデータストアに結果をエクスポートするか、ストレージアカウントコンテナーから結果をコピーできます。

次の手順で、Azure portal でテスト実行のテスト結果をダウンロードします。

Azure portal の Azure Load Testing リソースに移動します。
左側のペインで、[テスト] を選択してテストの一覧を表示し、対象のテストを選択します。

ヒント

検索ボックスと [時間の範囲] フィルターを使用して、リストに表示されるテストの数を制限できます。
テスト結果ファイルは、次の 2 つのいずれかの方法で zip 形式のフォルダーとしてダウンロードできます。
- 使用しているロードテストの実行の横にある省略記号 (...) を選択し、[Download results file]$結果ファイルのダウンロード$ を選択します。
  
  Note
  
  結果ファイルをダウンロードするには、ロードテストの実行状態が "完了"、"停止済み"、または "失敗" である必要があります。
- [テストの実行の詳細] ペインで、[ダウンロード] を選択してから、[結果] を選択します。
任意の zip ツールを使用してフォルダーを抽出し、テスト結果にアクセスできます。

フォルダーには、テストエンジンごとに個別の CSV ファイルが含まれており、ロードテスト中にテストエンジンによって実行された要求の詳細が含まれています。

CI/CD パイプラインの一部としてロードテストを実行すると、Azure Load Testing によってテスト結果ファイルが生成されます。次の手順に従って、これらのテスト結果を発行し、CI/CD パイプラインの実行にアタッチします。

GitHub リポジトリにアクセスし、[コード] を選択します。
[コード] ウィンドウで、.github/workflow フォルダーにある GitHub Actions ワークフローの YAML ファイルを選択します。

ワークフローファイルを編集し、ワークフローファイルの azure/load-testing アクションの後に actions/upload-artifact アクションを追加します。

Azure Load Testing では、テスト結果は、GitHub Actions ワークスペースの loadTest フォルダーに配置されます。

- name: 'Azure Load Testing'
    uses: azure/load-testing@v1
    with:
      loadTestConfigFile: 'SampleApp.yaml'
      loadTestResource: ${{ env.LOAD_TEST_RESOURCE }}
      resourceGroup: ${{ env.LOAD_TEST_RESOURCE_GROUP }}

- uses: actions/upload-artifact@v2
  with:
    name: loadTestResults
    path: ${{ github.workspace }}/loadTest

GitHub Actions ワークフローが完了したら、ワークフロー実行の [概要] ページの [アーティファクト] セクションからテスト結果を選択できます。

対象の Azure DevOps プロジェクトで、左側のナビゲーションから [パイプライン] を選択し、一覧からパイプラインを選択します。
パイプラインの詳細ページで、[編集] を選択してワークフロー定義を編集します。
ワークフローファイルを編集し、ワークフローファイルの AzureLoadTest タスクの後に publish タスクを追加します。

Azure Load Testing では、テスト結果は、Azure Pipelines の既定の作業ディレクトリの loadTest フォルダーに配置されます。
```
- task: AzureLoadTest@1
  inputs:
    azureSubscription: $(serviceConnection)
    loadTestConfigFile: 'SampleApp.yaml'
    resourceGroup: $(loadTestResourceGroup)
    loadTestResource: $(loadTestResource)

- publish: $(System.DefaultWorkingDirectory)/loadTest
  artifact: results
```
Azure Pipelines ワークフローが完了したら、ワークフロー実行の [概要] ページの [ステージ] セクションからテスト結果を選択できます。

テスト結果は、[結果] フォルダーで見つけてダウンロードできます。

JMeter バックエンドリスナーを使用してテスト結果をエクスポートする

JMeter バックエンドリスナーを使用して、データベース (InfluxDB、MySQL、Azure Application Insights などの監視ツール) にテスト結果をエクスポートできます。

既定の JMeter バックエンドリスナー、jmeter-plugins.org のバックエンドリスナー、または Java アーカイブ (JAR) ファイルの形式のカスタムバックエンドリスナーを使用できます。

次のコードスニペットは、JMeter ファイル (JMX) 内にある Azure Application Insights のバックエンドリスナーを使用する方法の例を示しています。

<BackendListener guiclass="BackendListenerGui" testclass="BackendListener" testname="Backend Listener" enabled="true">
  <elementProp name="arguments" elementType="Arguments" guiclass="ArgumentsPanel" testclass="Arguments" enabled="true">
    <collectionProp name="Arguments.arguments">
      <elementProp name="testName" elementType="Argument">
        <stringProp name="Argument.name">testName</stringProp>
        <stringProp name="Argument.value">jmeter</stringProp>
        <stringProp name="Argument.metadata">=</stringProp>
      </elementProp>
      <elementProp name="connectionString" elementType="Argument">
        <stringProp name="Argument.name">connectionString</stringProp>
        <stringProp name="Argument.value">Enter your AppInsights connection string</stringProp>
        <stringProp name="Argument.metadata">=</stringProp>
      </elementProp>
      <elementProp name="liveMetrics" elementType="Argument">
        <stringProp name="Argument.name">liveMetrics</stringProp>
        <stringProp name="Argument.value">true</stringProp>
        <stringProp name="Argument.metadata">=</stringProp>
      </elementProp>
      <elementProp name="samplersList" elementType="Argument">
        <stringProp name="Argument.name">samplersList</stringProp>
        <stringProp name="Argument.value"></stringProp>
        <stringProp name="Argument.metadata">=</stringProp>
      </elementProp>
      <elementProp name="useRegexForSamplerList" elementType="Argument">
        <stringProp name="Argument.name">useRegexForSamplerList</stringProp>
        <stringProp name="Argument.value">false</stringProp>
        <stringProp name="Argument.metadata">=</stringProp>
      </elementProp>
      <elementProp name="logResponseData" elementType="Argument">
        <stringProp name="Argument.name">logResponseData</stringProp>
        <stringProp name="Argument.value">OnFailure</stringProp>
        <stringProp name="Argument.metadata">=</stringProp>
      </elementProp>
      <elementProp name="logSampleData" elementType="Argument">
        <stringProp name="Argument.name">logSampleData</stringProp>
        <stringProp name="Argument.value">OnFailure</stringProp>
        <stringProp name="Argument.metadata">=</stringProp>
      </elementProp>
    </collectionProp>
  </elementProp>
  <stringProp name="classname">io.github.adrianmo.jmeter.backendlistener.azure.AzureBackendClient</stringProp>
</BackendListener>

Azure Application Insights バックエンドリスナーの使用例の完全版をダウンロードできます。

ストレージアカウントコンテナーからテスト成果物をコピーする

重要

ストレージアカウントコンテナーからのテスト成果物のコピーは、45 を超えるエンジンインスタンスを含むロードテストか、テストの実行時間が 3 時間を超えるロードテストでのみ有効になります。

ストレージアカウントからテスト実行のテスト結果とログファイルをコピーするには、Azure portal で次の手順を実行します。

Azure portal の Azure Load Testing リソースに移動します。
左側のペインで、[テスト] を選択してテストの一覧を表示し、対象のテストを選択します。
テスト実行の一覧から、テストの実行を選択します。

ヒント

検索ボックスと [時間の範囲] フィルターを使用して、リストに表示されるテストの数を制限できます。
[テストの実行の詳細] ペインで [成果物のコピー] を選択します。

Note

結果ファイルをダウンロードするには、ロードテストの実行状態が [完了]、[停止済み]、または [失敗] である必要があります。
ストレージアカウントコンテナーの SAS URL をコピーします。

Azure Storage Explorer または AzCopy で SAS URL を使用し、テストの実行の結果 CSV ファイルとログファイルをストレージアカウントにコピーできます。

SAS URL は、生成された時点から 60 分間有効です。 URL の有効期限が切れた場合、[成果物のコピー] を選択して新しい SAS URL を生成します。

失敗したロードテストを診断する方法についてはこちらを参照してください。
複数のテスト結果を比較する方法についてはこちらを参照してください。
Azure Pipelines で自動パフォーマンステストを構成する方法についてはこちらを参照してください。

サードパーティ製のツールで使用するために Azure Load Testing からテスト結果をエクスポートする

前提条件

テスト結果ファイル形式

ロードテストの結果にアクセスしてダウンロードする

JMeter バックエンドリスナーを使用してテスト結果をエクスポートする

ストレージアカウントコンテナーからテスト成果物をコピーする

フィードバック

フィードバック

その他のリソース

サードパーティ製のツールで使用するために Azure Load Testing からテスト結果をエクスポートする

前提条件

テスト結果ファイル形式

ロード テストの結果にアクセスしてダウンロードする

JMeter バックエンド リスナーを使用してテスト結果をエクスポートする

ストレージ アカウント コンテナーからテスト成果物をコピーする

関連するコンテンツ

フィードバック

フィードバック

その他のリソース

ロードテストの結果にアクセスしてダウンロードする

JMeter バックエンドリスナーを使用してテスト結果をエクスポートする

ストレージアカウントコンテナーからテスト成果物をコピーする