OpenText Enterprise Performance Engineeringでテストを実行する

IDEからOpenText Enterprise Performance EngineeringでのDevWebパフォーマンステストを実行できます。これにより、仮想ユーザーの数を増やすことができます。

ヒント: 次のビデオを確認します: OpenText Enterprise Performance Engineeringとの統合

このトピックの内容:

テストの準備

OpenText Enterprise Performance Engineeringで負荷テストを実行したり、利用可能なホストに関する情報を取得したりするには、有効なライセンスが必要です。

テストの準備に役立つ次の情報源を参照してください。

  • 使用法、使用可能なフラグ、および例に関する情報をIDE内で取得するには、次の引数を使用してIDEでコマンドを実行します。

    ScalUP ent -help

先頭に戻る

IDEからパフォーマンステストを実行する

IDEで、パフォーマンステストを実行するタスクを定義し、実行します。

Visual Studio Codeからタスクを実行する例については、VS Codeからテストをスケーリングするを参照してください。

注: ScalUPツールは、定義されている場合、http_proxy、https_proxy、またはno_proxyのシステム環境変数を使用します。

任意のIDEでテストを実行するには:

  1. DevWebスクリプトを作成し、OpenText Performance Engineering for Developersでテストします。
  2. ent_uploader.ymlファイルで必要な設定を構成します。詳細については、YAMLファイルの構成を参照してください。
  3. IDEでスクリプトを開きます。

  4. ScalUPツールがテストを実行するためのタスクを設定します。

    IDEでタスクを設定するときは、次の形式を使用してコマンドラインの引数とフラグを構成します。

    Windows %DEVWEB_PATH%\ScalUP.exe ent <flags> run <DevWeb script folder path>
    Linux/macOS $DEVWEB_PATH/ScalUP ent <flags> run <DevWeb script folder path>

    次のフラグを使用できます。

    -host= http/httpsプロトコルを使用したOpenText Enterprise Performance Engineeringホスト名。
    -tenantId= ユーザーのテナントID (環境に必要な場合)。
    -domain= ユーザーのドメイン名。
    -project= プロジェクト名。
    -authenticationMode= マシンへの接続に使用される認証タイプ。
    -userName= (基本認証用) マシンへのログインに使用するユーザー名。
    -password= (基本認証用) マシンへのログインに使用するパスワード。
    -clientId= (SSO認証の場合) マシンへのログインに必要なクライアントID。
    -clientSecret= (SSO認証の場合) マシンへのログインに必要なクライアントシークレット。
    -keyLocation= 構成設定ファイル内の暗号化された文字列を復号化するために使用されるキーファイルへのフルパス。
    -testPlan= スクリプトは、この名前のテスト計画フォルダーにアップロードされます。
    -testSet= パフォーマンステストは、この名前のテストセットの下に作成されます。
    -testSetFolder= テストセットは、この名前のテストセットフォルダーの下に作成されます。
    -report= 結果レポートの場所への相対パスまたはルートパス。パスが指定されていない場合、レポートは生成されません。

    report以外のすべてのフラグは、ent_uploader.ymlファイルで構成できます。コマンドラインでそれらを追加すると、フラグ定義がYAMLファイル定義を上書きします。

    たとえば、コマンドラインに次のように追加できます。

    -report=<report location> -user=KimW

    注: パスワードなどの機密情報をプレーンテキストで追加しないことをお勧めします。詳細については、データのマスクと暗号化を参照してください。

  5. IDEでタスクを実行します。

    DevWebスクリプトフォルダーは、ent_uploader.ymlファイル (パラメーターtestPlan) で構成されたテストプランフォルダーにアップロードされます。テストプラン名が設定されていない場合、スクリプトは標準設定でAutoTestPlanにアップロードされます。

    パフォーマンステストは、ラベル<スクリプト名>_PerformanceTestを使用して、同じテストセットプランフォルダーにテスト用に作成されます。

  6. パフォーマンステストは、関連するアップローダー構成設定ファイルの構成設定を使用して実行されます。

    テストが実行されると、テストインスタンスは、ent_uploader.ymlファイルで構成されているテストセットおよびテストセットフォルダーに割り当てられます。これらのパラメーターが定義されていない場合、標準設定でAutoTestSetおよびAutoTestSetFolderが使用されます。

    テストの実行には、Test Id 184などのID番号が割り当てられます。

    IDをテスト名と一緒に使用して、OpenText Enterprise Performance Engineeringでの実行を識別できます。

    OpenText Enterprise Performance Engineering UIから実行の進行状況を確認できます。

  7. テストが完了すると、OpenText Performance Engineering for Developersはサマリーレポートを表示します。電子メール通知が構成されている場合、結果は電子メールで送信されます。

    タスクが完了するのを待つ必要はありません。IDEでローカルに閉じることができます。そうしないと、タイムアウトに達した後にツールが終了します。どちらの場合も、テストは引き続きOpenText Enterprise Performance Engineeringで実行されます。後でIDEのテストに戻って、実行が完了したかどうかを確認し、結果を取得できます。詳細については、テスト実行結果の取得を参照してください。

先頭に戻る

テスト実行結果の取得

IDEでタスクを実行して、OpenText Enterprise Performance Engineeringでのパフォーマンステストの結果を確認できます。このオプションを使用すると、OpenText Performance Engineering for Developersが終了した後 (テストの実行が完了して結果が利用可能になる前) にテスト結果を取得できます。

ヒント:  

  • テストが完了するまでScalUPツールを実行し続ける場合は、YAMLファイルのwaitForRunTimeoutで値-1を構成します。詳細については、YAMLファイルの構成を参照してください。

  • Visual Studio Codeでは、Get test run results from OpenText Enterprise Performance Engineeringタスクを使用して結果を取得できます。

テスト実行結果を取得するには:

  1. テスト実行結果を取得するには、コマンドラインの引数を構成します。次のオプションを使用できます (Windows OSの場合)。

    目的 Command
    指定されたテストの最後の実行結果。 %DEVWEB_PATH%\ScalUP.exe ent <flags> getResults <script folder path>

    指定された実行IDの結果。

    適用されるログイン情報は、ScalUP.exeと同じフォルダーにあるent_uploader.ymlファイルから取得されます。

    		 %DEVWEB_PATH%\ScalUP.exe ent <flags> getResults <test run ID in OpenText Enterprise Performance Engineering>

    指定された実行IDの結果。

    指定されたスクリプトディレクトリにあるent_uploader.ymlファイルは、ScalUP.exeにあるファイルを上書きします。

    		 %DEVWEB_PATH%\ScalUP.exe ent <flags> getResults <test run ID in OpenText Enterprise Performance Engineering> <script folder path>

    注: LinuxまたはmacOSでは、%DEVWEB_PATH%\ScalUP.exeの代わりに$DEVWEB_PATH/ScalUPを使用します。

  2. タスクを実行します。進行状況ペインには、負荷テストがまだ実行中であるかどうかが示され、終了した場合はサマリーレポートが表示されます。
  3. テストがまだ実行中の場合は、後で戻ってgetResultsタスクを再度実行できます。

先頭に戻る

YAMLファイルの構成

プライマリ構成ファイルent_uploader.yml (ScalUP実行可能ファイルと同じディレクトリにあります) の設定は、OpenText Enterprise Performance Engineeringで実行するすべてのスクリプトに適用されます。

ローカル構成の場合、ent_uploader.ymlファイルを特定のスクリプトディレクトリにコピーし、その特定のスクリプトで使用するためにファイル設定をカスタマイズできます。スクリプトの実行中に、ローカルent_uploader.ymlファイルの設定が元の (プライマリ) ファイルの設定を上書きします。

ent_uploader.ymlファイルには、スクリプト実行のカスタマイズ可能な標準設定値と、各パラメーターの説明が含まれています。これらの設定は次のとおりです。

environment

これらは、OpenText Enterprise Performance Engineeringマシンとの通信に必要な値です。これらの設定は、ent_uploader.ymlファイルまたはコマンドラインフラグで定義できます。(詳細については、IDEからパフォーマンステストを実行するを参照してください。)

  • authenticationModeキーを使用すると、マシンへの接続に使用する認証タイプを定義できます。basic、またはSSO認証の場合はaccessKeyです。

  • basicが定義されている場合は、basicセクションにユーザー名とパスワードを入力します。

    Passwordキーはファイルから削除でき、代わりに実行時に入力できます。

  • accessKeyが定義されている場合は、accessKeyセクションにクライアントIDとクライアントシークレットを入力します。

注: パスワードやクライアントシークレットなどの機密情報をプレーンテキストで追加しないことをお勧めします。詳細については、データのマスクと暗号化を参照してください。
workspace

パフォーマンステスト用に使用するフォルダー構造を定義します。これを行うには、次のパラメーターの名前を定義します。testPlan、testSetFolder、testSet。

名前が定義されていない場合は、標準設定の名前AutoTestが実行時に使用されます (例: AutoTestPlan)。
hosts/controller テストに使用するLoad GeneratorとControllerマシンを定義します。詳細については、テスト用のホストとControllerの定義を参照してください。
trend report

テスト実行データをOpenText Enterprise Performance Engineeringのトレンドレポートに追加するために使用します。定義する名前は、既存のトレンドレポートに追加するか、新しいトレンドレポートに追加するかを示します。

  • 新しいトレンドレポートを作成するには、一意の名前を定義します。

  • テスト実行データがそのレポートに追加されるように、既存のトレンドレポートの名前を定義します。

必要に応じて、テスト実行内で開始点と終了点を定義して、これらの点の間からトレンドデータが収集されるようにすることができます。

テスト実行データがトレンドレポートに確実に追加されるようにするには、次のいずれかを実行する必要があります。

  • テストが完了するまでScalUPでタスクを開いたままにします (waitForRunTimeoutを-1に設定します)。

  • テストが完了したら、getResultsタスクを実行します。テスト実行結果の取得を参照してください。
encryption 暗号化されたデータの場合、キーの場所を定義します。詳細については、データのマスクと暗号化を参照してください。
Scenario and general settings これらには、実行する仮想ユーザーの数、ランプアップ時間、期間、およびロギングのパラメーターが含まれます。
waitForRunTimeout

テスト実行のステータスを確認しながらOpenText Performance Engineering for Developersが待機する秒数を定義します。時間が経過すると、プログラムは終了しますが、テストはOpenText Enterprise Performance Engineeringで引き続き実行されます。

標準設定は10秒です。-1を使用して、実行が完了するまで継続的に待機できます。

後でステータスを再度確認できます。詳細については、テスト実行結果の取得を参照してください。
Script exclude これは、OpenText Enterprise Performance Engineeringにアップロードするときにスクリプトから除外するファイルを定義する正規表現のリストです。

先頭に戻る

テスト用のホストとControllerの定義

ent_uploader.ymlファイルを構成して、パフォーマンステストに使用するLoad Generatorホスト (オンプレミスまたはクラウドベース) のOpenText Enterprise Performance Engineeringを指示できます。テストに使用する特定のControllerマシンを定義することもできます。

ent_uploader.ymlでホストやControllerマシンを定義しないことを選択した場合、OpenText Enterprise Performance Engineeringで次のルールを使用してパフォーマンステストが実行されます。

  • 新しいテストの場合、テストを実行するためにControllerマシンと1つのLoad Generatorが自動的に選択されます。

  • OpenText Enterprise Performance Engineeringにすでに存在するテストの場合、テストの既存のLoad Generator設定は何も変更されません。

テスト用のLoad GeneratorとControllerを定義するには:

  1. テスト実行を定義するときに使用できるLoad Generatorホストとホスト属性をリストしたテーブルを取得するには、DEVWEB_PATHから関連するコマンドを実行します。

    オンプレミスホストの一覧表示 ScalUP.exe ent info hosts
    クラウドベースのホストテンプレートの一覧表示 ScalUP.exe ent info cloudTemplates
    ホスト属性の一覧表示 ScalUP.exe ent info attributes

    注: リストされたホストの1つがテスト実行時に使用できない場合 (別のテストがスケジュールされているため)、テストはそのLoad Generatorで実行されません。

  2. ent_uploader.ymlファイル (プライマリファイル、またはスクリプトのローカルバージョン) を開きます。

  3. hostsセクションで、各type領域のコメントを外して更新し、テストを実行するLoad Generatorを定義します。任意の組み合わせで、複数のタイプを定義できます。

    パラメーター 説明
    type: specific

    特定のオンプレミスホストを追加します。

    options: nameプロパティでホストの名前を定義し、オンプレミスホストテーブルからコピーします。type: specificパラメーターを繰り返して、ホストを追加します。

    例:

    type: automatch

    実行のためにオンプレミスのホストを自動的に選択するようにOpenText Enterprise Performance Engineeringに指示します。

    • options: amount: 選択するホストの数を定義します。たとえば、amount:10です。

      利用可能なホストの上限まで、自動適合の量と、具体的に指定されたホストまたはクラウドホストの両方を定義できます。

    • options: attributes: 属性リストから項目を含めるオプションがあり、自動適合によって、それらの属性が割り当てられているホストが選択されます。たとえば、ホストのメモリ:高。
    type: cloud

    クラウドベースのLoad GeneratorをプロビジョニングするためにOpenText Enterprise Performance Engineeringによって使用されるホストテンプレートを追加します。

    クラウドテンプレートテーブルから有効なテンプレートをコピーして、options: nameプロパティでテンプレートの名前を定義します。type: cloudパラメーターを繰り返して、テンプレートを追加します。

    注: クラウドベースのホストの使用は、OpenText Performance Engineering for DevelopersおよびOpenText Enterprise Performance Engineeringでサポートされています。

  4. テストを実行するために特定のControllerを定義する場合は、controllerセクションのコメントを解除し、マシン名を指定します。

  5. ファイルを保存します。

    パフォーマンステストを実行すると、OpenText Enterprise Performance Engineering内でテスト用に定義されたホスト/Controllerは、ent_uploader.ymlの定義によって上書きされます。

先頭に戻る

テストのスケーリングに関するよくある質問

パフォーマンステストを実行する前に、よく寄せられる質問を確認してください。

統合からのパフォーマンステストの実行は、OpenText Enterprise Performance Engineering UIからのテスト実行と同じですか?

はい。ScalUPツールを使用して統合のパフォーマンステストを実行すると、他のOpenText Enterprise Performance Engineeringテストと同じように実行されます。

初めてテストを実行するときに、OpenText Enterprise Performance Engineeringでパフォーマンステストはどのように作成されますか?

テストを実行すると、スクリプトがent_uploader.ymlで定義されたフォルダーにアップロードされます。フォルダーが定義されていない場合は、AutoTestPlanフォルダーにアップロードされます。また、ラベル<スクリプト名>_PerformanceTestを使用してパフォーマンステストを作成します。

OpenText Enterprise Performance Engineeringでテストを変更するとどうなりますか?

OpenText Enterprise Performance Engineering UIでテストの構成を変更できます。OpenText Performance Engineering for Developersから再度テストを実行すると、設定項目の一部が上書きされる場合があります。

スクリプトのスケジュール設定を変更するにはどうすればよいですか?

ent_uploader.yml構成ファイルのシナリオセクションで、仮想ユーザーの数や期間などのスケジュール設定を変更できます。テストを実行すると、これらの設定によってOpenText Enterprise Performance Engineering UIの設定が上書きされます。

パフォーマンステストにグループを追加するにはどうすればよいですか?

OpenText Performance Engineering for Developersからテストを実行すると、アップロードされたグループのみがテストに使用されます。複数のグループを実行することはできません。

パフォーマンステスト用に特定のLoad Generatorを構成するにはどうすればよいですか?

ent_uploader.ymlファイルのhostsセクションでLoad Generatorを構成できます。詳細については、テスト用のホストとControllerの定義を参照してください。

先頭に戻る

関連項目: