チュートリアル: ロードテストを実行して、Web アプリのパフォーマンスのボトルネックを特定する

2025-08-15

このチュートリアルでは、Azure Load Testing を使用して Web アプリケーションのパフォーマンスのボトルネックを特定する方法について説明します。サンプル Node.js Web アプリケーションの負荷をシミュレートした後、ロードテストダッシュボードを使用してクライアント側とサーバー側のメトリックを分析します。

サンプルアプリケーションは、NoSQL データベースと対話する Node.js Web API で構成されます。 Web API を Azure App Service Web アプリにデプロイし、データベースとして Azure Cosmos DB を使用します。

このチュートリアルでは、以下の内容を学習します。

サンプルアプリをデプロイします。
ロードテストを作成して実行します。
ロードテストに Azure アプリコンポーネントを追加します。
ロードテストダッシュボードを使用して、パフォーマンスのボトルネックを特定します。

[前提条件]

アクティブなサブスクリプションを持つ Azure アカウント。 Azure サブスクリプションをお持ちでない場合は、開始する前に無料アカウントを作成してください。
ご利用のローカルコンピューターに Azure CLI がインストールされていること。
Azure CLI バージョン 2.2.0 以降。 az --versionを実行して、コンピューターにインストールされているバージョンを見つけます。 Azure CLI をインストールまたはアップグレードする必要がある場合は、「Azure CLI をインストールする方法」を参照してください。
Visual Studio Code。お持ちでない場合は、ダウンロードしてインストールしてください。
Git。お持ちでない場合は、ダウンロードしてインストールしてください。

前提条件の確認

開始する前に、環境を検証します。

Azure portal にサインインし、ご利用のサブスクリプションがアクティブであることを確認します。
az --version を実行して、ターミナルまたはコマンドウィンドウの Azure CLI のバージョンを確認します。最新バージョンについては、最新のリリースノートを参照してください。

最新バージョンを使用していない場合は、オペレーティングシステムまたはプラットフォーム用のインストールガイドに従ってインストールを更新します。

サンプルアプリケーションをデプロイする

このチュートリアルでは、Azure App Service にデプロイするサンプル Web アプリケーションに対する負荷を生成します。 Azure CLI コマンド、Git コマンド、PowerShell コマンドを使用して、Azure サブスクリプションにサンプルアプリケーションをデプロイします。

Windows PowerShell を開き、Azure にサインインして、サブスクリプションを設定します。
```
az login
az account set --subscription <your-Azure-Subscription-ID>
```
サンプルアプリケーションのソースリポジトリを複製します。
```
git clone https://github.com/Azure-Samples/nodejs-appsvc-cosmosdb-bottleneck.git
```
サンプルアプリケーションは、Azure App Service Web コンポーネントと Azure Cosmos DB データベースで構成される Node.js アプリです。リポジトリには、サンプルアプリを Azure サブスクリプションにデプロイする PowerShell スクリプトが含まれています。また、後の手順で使用する Apache JMeter スクリプトもあります。
Node.js アプリのディレクトリに移動し、次の PowerShell スクリプトを使用してサンプルアプリをデプロイします。
```
cd nodejs-appsvc-cosmosdb-bottleneck
.\deploymentscript.ps1
```
ヒント

PowerShell は Linux/WSL または macOS にインストールできます。

インストールした後は、前のコマンドを pwsh ./deploymentscript.ps1として実行できます。
プロンプトで、次の情報を入力します。
- Azure のサブスクリプション ID。
- Web アプリの一意の名前。
- ある場所。既定では、場所は eastus です。 Get-AzLocation コマンドを実行すると、リージョンコードを取得できます。
Von Bedeutung

Web アプリの名前には、小文字と数字のみを使用します。スペースや特殊文字は使用しないでください。
デプロイが完了したら、ブラウザーウィンドウで https://<yourappname>.azurewebsites.net を開いて、実行中のサンプルアプリケーションに移動します。

サンプルアプリケーションをデプロイして実行したら、Azure ロードテストリソースとロードテストを作成できます。

ロードテストの作成

このチュートリアルでは、JMeter テストスクリプト (jmx ファイル) をアップロードして、Azure CLI でロードテストを作成します。サンプルアプリケーションリポジトリには、ロードテスト構成ファイルと JMeter テストスクリプトが既に含まれています。

Azure portal を使用してロードテストを作成するには、「クイックスタート: JMeter スクリプトを使用してロードテストを作成する」の手順に従います。

Azure CLI を使用して Azure ロードテストリソースとロードテストを作成するには、次の手順に従います。

ターミナルウィンドウを開き、次のコマンドを入力して Azure サブスクリプションにサインインします。
```
az login
```
サンプルアプリケーションディレクトリに移動します。
```
cd nodejs-appsvc-cosmosdb-bottleneck
```
Azure ロードテストリソースのリソースグループを作成します。

必要に応じて、前にデプロイしたサンプルアプリケーションのリソースグループを再利用することもできます。

<load-testing-resource-group-name> テキストプレースホルダーをリソースグループの名前に置き換えます。
```
resourceGroup="<load-testing-resource-group-name>"
___location="East US"

az group create --name $resourceGroup --___location $___location
```
az load create コマンドを使用して Azure ロードテストリソースを作成します。

<load-testing-resource-name> テキストプレースホルダーをロードテストリソースの名前に置き換えます。
```
# This script requires the following Azure CLI extensions:
# - load

loadTestResource="<load-testing-resource-name>"

az load create --name $loadTestResource --resource-group $resourceGroup --___location $___location
```
az load test create コマンドを使用して、サンプルアプリケーションに対する負荷をシミュレートするためのロードテストを作成します。

<web-app-hostname> テキストプレースホルダーを、サンプルアプリケーションの App Service ホスト名に置き換えます。この値は、 myapp.azurewebsites.net形式です。 URL の https:// 部分は含めないでください。
```
testId="sample-app-test"
webappHostname="<web-app-hostname>"

az load test create --test-id $testId --load-test-resource $loadTestResource --resource-group $resourceGroup --load-test-config-file SampleApp.yaml --env webapp=$webappHostname
```
このコマンドは、SampleApp.jmx JMeter テストスクリプトを参照するSampleapp.yamlロードテスト構成ファイルを使用します。コマンドラインパラメーターを使用して、サンプルアプリケーションのホスト名をロードテストに渡します。

Azure サブスクリプションのサンプル Web アプリケーションに対して負荷を生成するための Azure ロードテストリソースとロードテストが作成されました。

Azure アプリコンポーネントを追加してアプリケーションを監視する

Azure Load Testing を使用すると、アプリケーションの Azure コンポーネントのリソースメトリックを監視できます。これらの サーバー側メトリックを分析することで、Azure Load Testing ダッシュボードから直接、アプリケーションのパフォーマンスと安定性の問題を特定できます。

このチュートリアルでは、アプリサービス、Cosmos DB アカウントなど、Azure にデプロイしたサンプルアプリケーションの Azure コンポーネントを追加します。

サンプルアプリケーションの Azure アプリコンポーネントをロードテストに追加するには:

Azure portal で Azure ロードテストリソースに移動します。
左側のウィンドウで、[ テスト ] を選択してロードテストの一覧を表示します
ロードテストの横にあるチェックボックスをオンにし、[ 編集] を選択します。
[ 監視 ] タブに移動し、[ 追加/変更] を選択します。
前にデプロイしたサンプルアプリケーションのチェックボックスをオンにし、[ 適用] を選択します。

ヒント

リソースグループフィルターを使用すると、サンプルアプリケーションリソースグループ内の Azure リソースのみを表示できます。
[ 適用] を選択して、変更をロードテスト構成に保存します。

ロードテストの実行中にサーバー側メトリックの監視を有効にするために、サンプルアプリケーションの Azure アプリコンポーネントをロードテストに正常に追加しました。

ロードテストを実行する

ロードテストを実行して、Azure サブスクリプションにデプロイしたサンプルアプリケーションに対する負荷をシミュレートできるようになりました。このチュートリアルでは、Azure portal 内からロードテストを実行します。または、ロードテストを実行するように CI/CD ワークフローを構成することもできます。

Azure portal でロードテストを実行するには:

Azure portal で Azure ロードテストリソースに移動します。
左側のウィンドウで、[ テスト ] を選択してロードテストの一覧を表示します
一覧からロードテストを選択して、テストの詳細とテストの実行の一覧を表示します。
[ 実行] を選択し、もう一度実行してロードテストを開始します。

必要に応じて、テスト実行の説明を入力できます。

ロードテストを実行すると、Azure Load Testing によって JMeter テストスクリプトと追加のファイルがテストエンジンインスタンスにデプロイされ、ロードテストが開始されます。
ロードテストが開始されると、ロードテストダッシュボードが表示されます。

ダッシュボードが表示されない場合は、[最新の情報に更新 ] を選択し、一覧からテストの実行を選択できます。

ロードテストダッシュボードには、クライアント側のメトリックやサーバー側のアプリケーションメトリックなどのテスト実行の詳細が表示されます。ダッシュボードのグラフが自動的に更新されます。

複数のフィルターを適用したり、結果を異なるパーセンタイルに集計してグラフをカスタマイズしたりできます。

ヒント

[停止] を選択すると、Azure portal からいつでもロードテストを停止できます。

ロードテストが完全に完了するまで待ってから、次のセクションに進みます。

サーバー側メトリックを使用してパフォーマンスのボトルネックを特定する

このセクションでは、ロードテストの結果を分析して、アプリケーションのパフォーマンスのボトルネックを特定します。クライアント側とサーバー側の両方のメトリックを調べて、問題の根本原因を特定します。

まず、クライアント側のメトリックを確認します。 addおよびget API 要求の応答時間メトリックの 90 パーセンタイルが、lasttimestamp API の場合よりも大きいことがわかります。

エラーのパターンも似ていますが、lasttimestamp API のエラー数は他の API よりも少なくなります。

add API と get API の結果は似ていますが、lasttimestamp API の動作は異なります。 add API とget API の両方にデータベースアクセスが含まれているため、データベースに関連する原因が考えられます。
このボトルネックをさらに詳しく調査するには、[ サーバー側メトリック ダッシュボード] セクションまで下にスクロールします。

サーバー側のメトリックは、Azure アプリケーションコンポーネント (Azure App Service プラン、Azure App Service Web アプリ、Azure Cosmos DB) に関する詳細情報を示します。

Azure App Service プランのメトリックでは、 CPU の割合 と メモリの割合 のメトリックが許容範囲内にあることがわかります。
次に、Azure Cosmos DB のサーバー側メトリックを確認します。

正規化された RU 消費量メトリックは、リソース使用率が 100% でデータベースが迅速に実行されたことを示していることに注意してください。リソース使用率が高い場合は、データベース調整エラーが発生する可能性があります。また、 add および get Web API の応答時間が長くなる可能性もあります。

また、Azure Cosmos DB インスタンスの プロビジョニング済みスループット メトリックの最大スループットは 400 RU であることがわかります。データベースのプロビジョニング済みスループットを増やすと、パフォーマンスの問題が解決する可能性があります。

データベースのスループットを向上させる

このセクションでは、パフォーマンスのボトルネックを解決するために、データベースにより多くのリソースを割り当てます。

Azure Cosmos DB の場合は、データベースの RU スケール設定を増やします。

サンプルアプリケーションのデプロイの一部としてプロビジョニングした Azure Cosmos DB リソースに移動します。
[ データエクスプローラー ] タブを選択します。
[ スケールと設定] を選択し、スループット値を 1200 に更新します。
変更を確認するには保存を選択します。

パフォーマンスの向上を検証する

データベースのスループットを向上させたので、ロードテストを再実行し、パフォーマンスの結果が向上したことを確認します。

テスト実行ダッシュボードで、[再実行] を選択し、[テストの再実行] ウィンドウで [再実行] を選択します。

[プロビジョニング]、[実行中]、[完了] の各状態を循環する状態列を含む新しいテスト実行エントリを確認できます。いつでもテストの実行を選択して、ロードテストの進行状況を監視します。
ロードテストが完了したら、 応答時間 の結果とクライアント側メトリックの エラー 結果を確認します。
Azure Cosmos DB のサーバー側メトリックを確認し、パフォーマンスが向上していることを確認します。

Azure Cosmos DB の正規化された RU 消費量 の値は、100%を大きく下回りました。

データベースのスケール設定を更新すると、次のことがわかります。

add API と get API の応答時間が改善されました。
正規化された RU 消費量は、制限を十分に超えています。

その結果、アプリケーションの全体的なパフォーマンスが向上しました。

リソースをクリーンアップする

Von Bedeutung

作成した Azure Load Testing リソースは、他の Azure Load Testing チュートリアルおよびハウツー記事で再利用できます。

作成したどのリソースも使用する予定がない場合は、追加の課金が発生しないように削除します。別のリソースグループにサンプルアプリケーションをデプロイした場合は、次の手順を繰り返します。

Azure portal を使用してリソースを削除するには、次のようにします。

左上隅にあるメニューボタンを選択して、[リソースグループ] を選択します。
一覧から、作成したリソースグループを選択します。
[リソースグループの削除] を選択します。
リソースグループ名を入力します。次に、 [削除] を選択します。

Azure CLI を使用してリソースを削除するには、次のコマンドを入力します。

az group delete --name <yourresourcegroup>

リソースグループを削除すると、そのグループに含まれるすべてのリソースが削除されるので注意してください。

失敗したテストを診断する方法の詳細を確認する
サーバー側のメトリックを監視して、アプリケーションのパフォーマンスのボトルネックを特定する
ロードテストの失敗条件を定義して、サービス要件に照らしてテスト結果を検証する
Azure Load Testing の主要な概念の詳細を確認します。

次の方法で共有

チュートリアル: ロード テストを実行して、Web アプリのパフォーマンスのボトルネックを特定する

[前提条件]

前提条件の確認

サンプル アプリケーションをデプロイする

ロード テストの作成

Azure アプリ コンポーネントを追加してアプリケーションを監視する

ロード テストを実行する