Azure Load Testing で URL ベースのロードテストに要求を追加する

[アーティクル]
11/16/2023

この記事では、Azure Load Testing で URL ベースのロードテストに HTTP 要求を追加する方法について説明します。 URL ベースのロードテストを使用して、ロードテストツールやスクリプトに関する知識がなくても、Web アプリケーションや REST エンドポイントなどの HTTP エンドポイントを検証します。

Azure サポート、URL ベースのロードテストで HTTP 要求を定義する 2 つの方法があります。ロードテスト内で両方のメソッドを組み合わせることができます。

エンドポイント URL、HTTP メソッド、ヘッダー、クエリパラメーター、要求本文などの HTTP エンドポイントの詳細を指定します。
HTTP 要求の cURL コマンドを入力します。

依存要求がある場合は、1 つの要求から応答値を抽出し、後続の要求に入力として渡すことができます。たとえば、最初に顧客の詳細を取得し、顧客 ID を抽出して顧客注文の詳細を取得します。

CI/CD ワークフローで URL ベースのロードテストを使用する場合は、HTTP 要求を含む JSON ファイルをロードテストに渡すことができます。

URL ベースのロードテストには、最大 5 つの要求を追加できます。より複雑なロードテストの場合は、JMeter テストスクリプトをアップロードしてロードテストを作成できます。たとえば、5 つ以上の要求がある場合、HTTP 以外のプロトコルを使用する場合、または JMeter プラグインを使用する必要がある場合などです。

前提条件

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

HTTP の詳細を含む要求を追加する

HTTP 要求の詳細を指定することで、URL ベースのロードテストの HTTP 要求を指定できます。次の表に、Azure Load Testing で HTTP 要求用に構成できるフィールドを示します。

フィールド	詳細
URL	HTTP エンドポイントの URL。たとえば、`https://www.contoso.com/products` のようにします。
Method	HTTP メソッド。 Azure Load Testing では、GET、POST、PUT、DELETE、PATCH、HEAD、および OPTIONS がサポートされています。
クエリパラメーター	(省略可能)URL に追加するクエリ文字列パラメーターを入力します。
HTTP ヘッダー	(省略可能)HTTP 要求に含める HTTP ヘッダーを入力します。要求には最大 20 個のヘッダーを追加できます。
要求本文	(省略可能)HTTP メソッドに応じて、HTTP 本文の内容を指定できます。 Azure Load Testing では、生データ、JSON ビュー、JavaScript、HTML、XML の形式がサポートされています。

URL ベースのロードテストに HTTP 要求を追加するには、次の手順に従います。

Azure Portal
Azure Pipelines / GitHub Actions

Azure portal で、ロードテストリソースに移動します。
左側のナビゲーションで、[テスト] を選択してすべてのテストを表示します。
一覧でロードテストを選択し、[編集] を選択します。

一覧から URL ベースのロードテストを選択し、[基本] タブで [詳細設定を有効にする] を有効にしていることを確認します。
[テスト計画] タブに移動し、[要求の追加] を選択します。
[UI に入力を追加する] を選択して、HTTP 要求の詳細を入力します。

HTTP 要求の詳細を入力し、[追加] を選択してロードテストに要求を追加します。

フィールド	説明
要求の形式	[UI に入力を追加する] を選択して、Azure portal のフィールドを使用して要求の詳細を構成します。
要求の名前	要求の一意の名前を入力します。テストの失敗条件を定義するときに、この要求名を参照できます。
URL	アプリケーションエンドポイントの URL。
方法	一覧から HTTP メソッドを選択します。 Azure Load Testing では、GET、POST、PUT、DELETE、PATCH、HEAD、および OPTIONS がサポートされています。
クエリパラメーター	(省略可能)URL に追加するクエリ文字列パラメーターを入力します。
ヘッダー	(省略可能)HTTP 要求に含める HTTP ヘッダーを入力します。
本文	(省略可能)HTTP メソッドに応じて、HTTP 本文の内容を指定することもできます。 Azure Load Testing では、生データ、JSON ビュー、JavaScript、HTML、XML の形式がサポートされています。

[適用] を選択してロードテストを保存します。

GitHub Actions や Azure Pipelines などの CI/CD ワークフローの一部としてロードテストを実行する場合は、要求 JSON ファイルに HTTP 要求の一覧を指定します。ロードテスト構成 YAML ファイルでは、プロパティ内の JSON ファイルをtestPlan参照します。

HTTP 要求を requests.json 格納するファイルを作成し、次のコードスニペットをファイルに貼り付けます。

{
    "version": "1.0",
    "scenarios": {
        "requestGroup1": {
            "requests": [
            ],
            "csvDataSetConfigList": []
        }
    },
    "testSetup": [
        {
            "virtualUsersPerEngine": 50,
            "durationInSeconds": 300,
            "loadType": "Linear",
            "scenario": "requestGroup1",
            "rampUpTimeInSeconds": 60
        }
    ]
}

必要に応じて、プロパティの読み込み設定を testSetup 構成します。 URL ベースのロードテストの読み込みパラメーターの構成の詳細について説明します。

HTTP 要求の詳細をプロパティに requests 追加します。

次のコードスニペットは、HTTP POST 要求の例を示しています。次の点にrequestTypeURL注意してください。

{
    "requestName": "add",
    "responseVariables": [],
    "queryParameters": [
        {
            "key": "param1",
            "value": "value1"
        }
    ],
    "requestType": "URL",
    "endpoint": "http://www.contoso.com/orders",
    "headers": {
        "api-token": "my-token"
    },
    "body": "{\r\n  \"customer\": \"Contoso\",\r\n  \"items\": {\r\n\t  \"product_id\": 321,\r\n\t  \"count\": 50,\r\n\t  \"amount\": 245.95\r\n  }\r\n}",
    "method": "POST",
    "requestBodyFormat": "JSON"
},

ロードテスト構成 YAML ファイルを更新し、設定を設定しますtestTypetestPlan。

URL ベースのロードテストを testType 実行していることを示すようにプロパティ URL を設定してください。

このプロパティは testPlan 、前の手順で作成した要求 JSON ファイルを参照します。

次のコードスニペットは、ロードテスト構成ファイルの例のフラグメントを示しています。
```
displayName: my-first-load-test
testPlan: requests.json
description: Web application front-end
engineInstances: 1
testId: my-first-load-test
testType: URL
splitAllCSVs: False
failureCriteria: []
autoStop:
  errorPercentage: 90
  timeWindow: 60
```
両方のファイルを保存し、ソース管理リポジトリにコミットします。

cURL を使用して要求を追加する

HTTP 要求の詳細を指定する代わりに、URL ベースのロードテストで HTTP 要求の cURL コマンドを指定することもできます。 cURL は、URL ベースの要求用のコマンドラインツールおよびライブラリです。

cURL コマンドを使用してロードテストに HTTP 要求を追加するには、次の手順に従います。

Azure Portal
Azure Pipelines / GitHub Actions

テストの一覧でロードテストを選択し、[編集] を選択 します。

一覧から URL ベースのロードテストを選択し、[基本] タブで [詳細設定を有効にする] を有効にしていることを確認します。
[テスト計画] タブに移動し、[要求の追加] を選択します。
cURL を使用して HTTP 要求を作成するには、[cURL の追加] コマンドを選択します。
cURL コマンドフィールドに cURL コマンドを入力し、[追加] を選択してロードテストに要求を追加します。

次の例では、cURL を使用して HTTP GET 要求を実行し、HTTP ヘッダーを指定します。
```
curl --request GET 'http://www.contoso.com/customers?version=1' --header 'api-token: my-token'
```
[適用] を選択してロードテストを保存します。

HTTP 要求を格納する JSON ファイルを作成し、ファイルに次のコードスニペットを貼り付けます。

{
    "version": "1.0",
    "scenarios": {
        "requestGroup1": {
            "requests": [
            ],
            "csvDataSetConfigList": []
        }
    },
    "testSetup": [
        {
            "virtualUsersPerEngine": 50,
            "durationInSeconds": 300,
            "loadType": "Linear",
            "scenario": "requestGroup1",
            "rampUpTimeInSeconds": 60
        }
    ]
}

プロパティに cURL コマンドを requests 追加します。

次のコードスニペットは、HTTP POST 要求の例を示しています。次の点にrequestTypeCURL注意してください。

{
    "requestName": "get-customers",
    "responseVariables": [],
    "requestType": "CURL",
    "curlCommand": "curl --request GET 'http://www.contoso.com/customers?version=1' --header 'api-token: my-token'"
},

testType testPlanロードテスト構成 YAML ファイルで、要求 JSON ファイルを参照するように設定します。

URL ベースのロードテストを testType 実行していることを示すようにプロパティ URL を設定してください。

このプロパティは testPlan 、前の手順で作成した要求 JSON ファイルを参照します。

次のコードスニペットは、ロードテスト構成ファイルの例のフラグメントを示しています。
```
displayName: my-first-load-test
testPlan: requests.json
description: Web application front-end
engineInstances: 1
testId: my-first-load-test
testType: URL
splitAllCSVs: False
failureCriteria: []
autoStop:
  errorPercentage: 90
  timeWindow: 60
```
両方のファイルを保存し、ソース管理リポジトリにコミットします。

HTTP 要求で変数を使用する

HTTP 要求で変数を使用すると、テストの柔軟性を高めたり、テスト計画にシークレットを含めたりしないようにすることができます。たとえば、エンドポイントの doメイン名の環境変数を使用し、個々の HTTP 要求で変数名を使用できます。変数を使用すると、テスト計画の柔軟性とメインを実現できます。

Azure Load Testing の URL ベースのロードテストでは、変数を使用して次の情報を参照できます。

環境変数: ロードテスト用に環境変数を構成できます
シークレット: ロードテストで Azure Key Vault シークレットを構成する
CSV 入力ファイルの値: CSV 入力ファイル内の列に変数を使用し、ファイル内の各行に対して要求を実行します
応答変数: 以前の HTTP 要求から値を抽出する

要求で変数を参照するための構文は次のとおりです ${variable-name}。

次のスクリーンショットは、HTTP ヘッダー${token}で変数をtoken参照する方法を示しています。

Note

証明書を指定すると、Azure Load Testing は各 HTTP 要求で証明書を自動的に渡します。

依存する要求に応答変数を使用する

前の要求で使用する HTTP 要求を作成するには、応答変数を使用できます。たとえば、最初の要求では、API から項目の一覧を取得し、最初の結果から ID を抽出した後、後続の ID を作成し、この ID をクエリ文字列パラメーターとして渡します。

Azure Load Testing では、HTTP 要求から値を抽出し、変数に格納するための次のオプションがサポートされています。

JSONPath
XPath
正規表現

たとえば、次の例は、XPathExtractor を使用して要求の本文を応答変数に格納する方法を token 示しています。その後、他の HTTP 要求でこの ${token} 値を参照できます。

"responseVariables": [
    {
        "extractorType": "XPathExtractor",
        "expression": "/note/body",
        "variableName": "token"
    }
]

次の方法で共有

Azure Load Testing で URL ベースのロードテストに要求を追加する

前提条件

HTTP の詳細を含む要求を追加する

cURL を使用して要求を追加する

HTTP 要求で変数を使用する

依存する要求に応答変数を使用する

フィードバック

その他のリソース

次の方法で共有

Azure Load Testing で URL ベースのロード テストに要求を追加する

前提条件

HTTP の詳細を含む要求を追加する

cURL を使用して要求を追加する

HTTP 要求で変数を使用する

依存する要求に応答変数を使用する

関連するコンテンツ

フィードバック

その他のリソース

Azure Load Testing で URL ベースのロードテストに要求を追加する