パフォーマンス SDK によるマルチユーザーテストを実行する

[アーティクル]
04/03/2024

この記事では、Microsoft Visual Studio、パフォーマンスソフトウェア開発キット (SDK)、およびタスクレコーダーテストスクリプトを使用してマルチユーザーテストを実行する方法について説明します。

重要

Visual Studio 2019 は Web パフォーマンスや負荷テストの機能を含む Visual Studio の最終バージョンであり、今後非推奨になる予定です。パフォーマンステストには、Apache JMeter を使用することをお勧めします。詳細については、JMeter を参照してください。

JMeter は Apache が所有しているため、Microsoft はサポートしていません。しかし、以下の一連のブログ投稿では、Dynamics 365 財務と運用アプリで JMeter を使用するいくつかの有用なヒントを提供しています。

前提条件

この記事の手順を完了する前に、次の前提条件が満たされていることを確認してください:

開発環境には Visual Studio Enterprise Edition があります。負荷テストを作成するには、Enterprise Edition が必要です。 Microsoft Dynamics Lifecycle Services (LCS) を通じてクラウドホスト環境として開発ボックスを配置する場合は、配置する適切な Visual Studio バージョンを選択してください。
Visual Studio Web パフォーマンスおよび負荷テストツールは、負荷テストコンポーネントのインストールの説明に従ってインストールされます。
開発環境と同じリリース (アプリケーションバージョンとプラットフォーム更新プログラム) の階層 2 以上のサンドボックス環境があります。
タスクレコーダーとパフォーマンス SDK を使用したシングルユーザーテストの手順に従って開発環境を構成しました。
エンドツーエンド (E2E) シナリオ用に C# パフォーマンステストクラスが生成され、タスクレコーダーとパフォーマンス SDK を使用したシングルユーザーテストの手順に従ってシングルユーザーテストを実行できます。

マルチユーザーテストのための開発環境のコンフィギュレーション

次のコンフィギュレーションは、テストコントローラーおよびエージェントをローカルにホストするために使用される開発マシンで設定する必要があります。

メモ

Microsoft が管理するすべてのサンドボックスおよびセルフサービスタイプのサンドボックスについて、Microsoft はご使用の環境の証明書を生成し、事前に構成します。

TestRoot という名前の環境変数を作成し、Windows PowerShell で次のコマンドレットを実行して PerfSDK フォルダーをポイントします。
```
[ENVIRONMENT]::SETENVIRONMENTVARIABLE("TESTROOT", "K:\PERFSDK\PERFSDKLOCALDIRECTORY", "USER")
```
変数を検証するには、Windows PowerShell 次のコマンドを実行します。
```
[ENVIRONMENT]::GETENVIRONMENTVARIABLE("TESTROOT", "USER") | Write-Host
```
LCS で、ターゲットサンドボックス環境の環境の詳細ページを開きます。

環境の詳細ページの管理メニューには、次の 2 つの新しいコマンドが表示されます。
- RSAT 証明書のダウンロード
- RSAT 証明書を再生成する
RSAT 証明書をダウンロードを選択して、証明書バンドルを ZIP ファイルとして取得します。
クリアテキストのパスワードが画面に表示されるという警告が表示されます。はいを選択して続行します。
後で必要になるため、クリアテキストのパスワードをコピーします。
ZIP ファイルをダウンロードした後、解凍します。内部には、証明書 (.cer) ファイルと個人情報交換 (.pfx) ファイルがあります。
証明書 (.cer) ファイルをダブルタップ (またはダブルクリック) して開き、インストールを選択します。この証明書をローカルコンピューターにインストールしてから、個人ストアを参照します。ローカルコンピューターの場所に対してこの手順を繰り返し、特定の信頼済ルート証明機関ストアを参照します。
個人情報交換 (.pfx) ファイルをダブルタップ (またはダブルクリック) して開き、インストールを選択します。この証明書をローカルコンピューターにインストールしてから、手順 5 でコピーしたパスワードを入力して、個人ストアを参照します。ローカルコンピューターの場所に対してこの手順を繰り返し、手順 5 でコピーしたパスワードを入力して、特定の信頼済ルート証明機関ストアを参照します。
証明書ファイルをダブルタップ (またはダブルクリック) して、開きます。詳細タブで、拇印セクションが見つかるまで下にスクロールします。拇印を選択し、テキストボックスに ID をコピーします。この拇印を保存し、パフォーマンス SDK に対して CloudEnvironment.config 拇印を更新します。

メモ

Microsoft は、有効期限が切れる前に証明書を自動的にローテーションします。その時点で、証明書の新しいバージョンをダウンロードする必要があります。セルフサービス環境では、証明書は有効期限に最も近いダウンタイムウィンドウで 60 日ごとにローテーションされます。ダウンタイムウィンドウには、顧客が開始したパッケージ展開、および環境を対象とするデータベース移動操作が含まれます。

マルチユーザーテスト用の PerfSDKSample ソリューションの準備

次の手順に従って、パフォーマンステスト用のサンプルソリューションを準備します。サンプルソリューションは、開発環境の Performance SDK フォルダーにあります。既定では、フォルダは K:\PerfSDK\PerfSDKLocalDirectory です。

上位のアクセス許可で次のコマンドレットを実行して、以前にインストールした証明書が正しくインストールされていること、および以前に保存した拇印がローカルコンピューターの個人ストアにあることを確認します。
```
cd Cert:\LocalMachine\My
Get-ChildItem | Where-Object { $_.Subject -like "CN=127.0.0.1" }
```
次の図は、サンプル結果を示します。以前に保存した拇印がリストにあることを確認してください。
Performance SDK フォルダーの CloudEnvironment.config 構成ファイルを更新し、対象の環境を記述します。この更新プログラムの一部として、次の手順を実行します。
1. HostName と SOAPHostName の設定が階層 2 以上のサンドボックス環境と一致することを確認します。
2. SelfSigningCertateThumbprint の値として以前に保存した拇印を追加します。構成ファイルにエントリがない場合は、次の図に示すように追加できます。
3. UserCount の設定を更新して、ケースのテストユーザーの数と一致するようにします。
4. UserFormat の設定を更新して、テストユーザーの名前付け規則と一致するようにします。
5. AuthenticatorConfigurationCollection 要素の下の各 AuthenticatorConfiguration 要素で、MS.Dynamics.TestTools.CloudCommonTestUtilities.Authentication.SelfMintedTokenAadAuthenticator を MS.Dynamics.TestTools.CloudCommonTestUtilities.Authentication.SelfMintedTokenAuthenticator で置き換えます。
6. AzureActiveDirectoryConfiguration 要素と KeyVaultConfigurations 要素をコメント行にします。
メモ

財務と運用アプリが 21Vianet に配置されている場合、必ず NetworkDomain="https://sts.chinacloudapi.cn/" を SelfMintingSysUser および SelfMintingAdminUser で指定してください。

結果は次の例のようになります。
vsonline.testsettings ファイルの名前を local.testsettings に変更します。
Visual Studio で local.testsettings ファイルを開き、次の手順に従って変更します。
1. テストの設定 ダイアログボックスの一般タブの テストの実行場所 フィールドグループで ローカルコンピューターまたはテストコントローラーを使用してテストを実行 オプションを選択します。
2. 配置タブで配置を有効にするチェックボックスを選択し、ディレクトリの追加ボタンを使用して bin\debug を配置する追加のファイルやディレクトリ フィールドに追加します。
3. ホスト タブの 32 ビットまたは 64 ビットプロセスでテストを実行 フィールドで、64 ビットコンピューターで 64 ビットプロセスのテストを実行 を選択します。
4. 適用を選択して テストの設定 ダイアログボックスを閉じます。
5. プロジェクトコンフィギュレーションを開き、ターゲットフレームワークを .NET Framework 4.6.2 に設定して変更します。
メモ

Microsoft Dynamics 365 アドインを使用してタスク記録から C# パフォーマンステストを生成するたびに、ソリューション全体を再度開くのではなく、プロジェクトを Visual Studio に再読み込みします。負荷テストを実行する前に、必ずソリューションを再読み込みして、テスト設定ファイルが表示されていることを確認してください。

パフォーマンステストソースの変更

ソリューションで生成された各パフォーマンステストごとに、次の手順に従います。

使用ディレクティブセクションの上部に、次のステートメントを追加します。
```
using MS.Dynamics.TestTools.UIHelpers.Core;
```

全体を次の行に置き換えて、TestSetup メソッドを変更します。

private DispatchedClient Client;
private UserContext _userContext;
private TimerProvider timerProvider;
[TestInitialize]
public void TestSetup()
{
    if (this.TestContext != null)
    {
        timerProvider = new TimerProvider(this.TestContext);
    }
    SetupData();
    Client = new DispatchedClientHelper().GetClient();
    Client.ForceEditMode = false;
    Client.Company = WellKnownCompanyID.USMF.ToString();
    Client.Open();
}

次の例と同様に TestCleanup メソッドを変更します。

public void TestCleanup()
{
    Client.Close();
    Client.Dispose();
    Client = Null;
}

ソリューションを構築します。

負荷テストミックスにテストの追加

次の手順に従って、テストミックスにパフォーマンステストを追加します。

SampleLoadTest.loadtest ファイルを開き、テストミックス ノードを検索します。
テストミックス ノードを選択し、保留 (または右クリック) し、テストミックスの編集を選択します。
テストミックスの編集ダイアログボックスで、追加を選択してテストをミックスに追加します。
実行設定ノードで、プロパティを変更し、実行設定 1 のタイミング フィールドを更新します。これらのフィールドは ウォームアップ期間、実行期間、クールダウン期間 を含みます。
シナリオ ノードで、必ず負荷パターン プロパティを更新し、定数ユーザー数パラメーターをテストの実行に使用するユーザーの総数に設定してください。

新規ユーザーのテスト

テストユーザーは、ターゲット環境に追加する必要があります。名前付けパターンは CloudEnvironment.config 構成ファイルで指定されたパターンと一致している必要があります。 Microsoft Dynamics 365 環境でユーザーを手動で作成するか、Performance SDK フォルダーの MS.Dynamics.Performance.CreateUsers.exe コンソールアプリケーションを使用できます。

ユーザーを手動で作成する場合は、各ユーザーにシステム管理者セキュリティロールが割り当てられている必要があります。

コンソールアプリケーションを使用してユーザーを作成することをお勧めします。コンソールアプリケーションは構成ファイルを読み取り、適切なサービスエンドポイントを呼び出すためです。

ローカルテストコントローラーを使用したマルチユーザーテストの実行

Visual Studio プロジェクトで、SampleLoadTest.loadtest ファイルを開き、負荷テストを実行を選択します。
テスト出力を確認します。

トラブルシューティング

パフォーマンス SDK を使用するシングルユーザーまたはマルチユーザーのテストの詳細については、パフォーマンス SDK によるシングルユーザーまたはマルチユーザーのテストに関するトラブルシューティングガイドを参照してください。

次の方法で共有

パフォーマンス SDK によるマルチユーザーテストを実行する

前提条件

マルチユーザーテストのための開発環境のコンフィギュレーション

マルチユーザーテスト用の PerfSDKSample ソリューションの準備

パフォーマンステストソースの変更

負荷テストミックスにテストの追加

新規ユーザーのテスト

ローカルテストコントローラーを使用したマルチユーザーテストの実行

トラブルシューティング

フィードバック

フィードバック

その他のリソース

次の方法で共有

パフォーマンス SDK によるマルチユーザー テストを実行する

前提条件

マルチ ユーザー テストのための開発環境のコンフィギュレーション

マルチユーザー テスト用の PerfSDKSample ソリューションの準備

パフォーマンス テスト ソースの変更

負荷テスト ミックスにテストの追加

新規ユーザーのテスト

ローカル テスト コントローラーを使用したマルチユーザー テストの実行

トラブルシューティング

フィードバック

フィードバック

その他のリソース

パフォーマンス SDK によるマルチユーザーテストを実行する

マルチユーザーテストのための開発環境のコンフィギュレーション

マルチユーザーテスト用の PerfSDKSample ソリューションの準備

パフォーマンステストソースの変更

負荷テストミックスにテストの追加

ローカルテストコントローラーを使用したマルチユーザーテストの実行