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

IDEからOpenText Core Performance EngineeringでのDevWeb負荷テストを実行できます。これにより、仮想ユーザーの数を増やすことができます。

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

このトピックの内容:

テストの準備

OpenText Core Performance Engineeringで負荷テストを実行したり、利用可能なクラウドの場所とOPLGマシンに関する情報を取得したりするには、有効なライセンスが必要です。

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

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

    ScalUP cor -help

先頭に戻る

IDEから負荷テストを実行する

IDEで、負荷テストを実行するタスクを定義して実行します。

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

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

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

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

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

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

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

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

    -host= http/httpsプロトコルを使用したOpenText Core Performance Engineeringホスト名。
    -user= マシンにログインするためのユーザー名またはクライアントID。
    -password= マシンにログインするためのパスワードまたは秘密鍵。
    -tenantId= ユーザーのテナントID。
    -projectId= テストが実行されるプロジェクトのID。
    -keyLocation= 構成設定ファイル内の暗号化された文字列を復号化するために使用されるキーファイルへのフルパス。
    -report= 結果レポートの場所への相対パスまたはルートパス。パスが指定されていない場合、標準設定でスクリプトフォルダーに保存されます。

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

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

    -report=<report location> -user=KimW

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

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

    これがScalUPを使用したテストの最初の実行である場合、DevWebスクリプトフォルダーがOpenText Core Performance Engineeringにアップロードされ、テストにはラベルAutogenerated_<スクリプト名>が付けられます。同じ名前のテストがすでに存在する場合、スクリプトが更新され、テストの実行に使用されます。

    必要に応じて、結果レポートの電子メールアドレスが追加されます。

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

    テストが実行されると、テストに添付されているSLAはすべて無効になります。(SLAは、現在の実行だけでなく、テストでも無効になっています。)テスト実行には、#184などのID番号が割り当てられます。

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

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

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

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

先頭に戻る

テスト実行結果の取得

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

ヒント:  

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

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

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

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

    目的 Command
    テストのすべてのテスト実行IDを含む表を出力します。 %DEVWEB_PATH%\ScalUP.exe cor <flags> getResults <script folder path>

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

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

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

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

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

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

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

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

先頭に戻る

YAMLファイルの構成

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

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

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

tenant settings

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

  • マシンに接続するためのユーザー名とパスワードを定義します。OAuth認証を使用する場合は、関連するクライアントIDとシークレットキーを定義します。

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

注: パスワードなどの機密情報をプレーンテキストで追加しないことをお勧めします。詳細については、データのマスクと暗号化を参照してください。
sendEmail trueに設定すると、スクリプト実行の結果レポートは、実行の最後にログインしたユーザーに電子メールで送信されます。追加の受信者にメールを送信するには、emailAddressesプロパティに1つ以上のメールアドレスを入力します。
location テストをクラウドの場所 (既定) で実行するか、オンプレミスのLoad Generatorで実行するかを定義します。次に、使用する特定の場所/マシンを定義します。詳細については、テストの分布パラメーターの定義を参照してください。
encryption 暗号化されたデータの場合、キーの場所を定義します。詳細については、データのマスクと暗号化を参照してください。
Scenario and general settings これらには、実行する仮想ユーザーの数、ランプアップ時間、期間、およびロギングのパラメーターが含まれます。
waitForRunTimeout

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

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

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

先頭に戻る

テストの分布パラメーターの定義

負荷テストをクラウドの場所から実行するか、オンプレミスのLoad Generator (OPLG) を使用して実行するかを定義できます。クラウドロケーションの場合、各ロケーションに配布する仮想ユーザーの割合を定義することもできます。この情報は、cor_uploader.ymlファイルで定義します。

テストのクラウドロケーション分布を定義するには:

  1. テストに使用できるクラウドの場所のリストを取得するには、IDEで次の引数を使用してコマンドを実行します。

    Windows: %DEVWEB_PATH%\ScalUP.exe cor info locations <script folder path>
    Linux/macOS: $DEVWEB_PATH/ScalUP cor info locations <script folder path>

    または、Visual Studio Codeを使用している場合は、Run Task > Get distribution list from OpenText Core Performance Engineeringを選択します。

    コマンドを実行すると、場所の表がターミナルウィンドウに表示されます。

  2. 利用可能な場所のリスト (Available列でYesとマークされている) から、テストに使用する場所を特定します。
  3. スクリプトのcor_uploader.ymlファイルで、loadTest > locationパラメーターがcloudとして定義されていることを確認します。

  4. cloudセクションで、次の形式を使用して必要な場所と分布を定義します。

    - name: <location name> 場所の表に記載されている場所の名前。例: aws-us-east-1
    percent: <仮想ユーザーの割合>

    この場所で実行する仮想ユーザーの割合を定義する整数。例: 40

    すべての場所に分配されたパーセント値の合計は100%に等しくなければなりません。

    例:

  5. テストを再度実行すると、OpenText Core Performance Engineering内でテスト用に定義された場所と仮想ユーザー分布は、cor_uploader.yml設定によって上書きされます。

テスト用のOPLGマシンを定義するには:

  1. テストに使用できるOPLGマシンのリストを取得するには、IDEで次の引数を使用してコマンドを実行します。

    Windows: %DEVWEB_PATH%\ScalUP.exe cor info loadGenerators <script folder path>
    Linux/macOS: $DEVWEB_PATH/ScalUP cor info loadGenerators <script folder path>

    または、Visual Studio Codeを使用している場合は、Run Task > Get load generators list from OpenText Core Performance Engineeringを選択します。

    コマンドを実行すると、OPLGマシンのテーブルがターミナルウィンドウに表示されます。

  2. 接続されているマシンまたは実行中のマシンのリストから、テストに使用するマシンを特定します。
  3. スクリプトのcor_uploader.ymlファイルで、loadTest > locationパラメーターがonPremiseとして定義されていることを確認します。

  4. onPremiseセクションで、必要なマシンを定義します (各マシン名は一重引用符で囲み、コンマで区切ります)。

    例:

    注:  

    • 仮想ユーザーの配分はOpenText Core Performance Engineeringの内部アルゴリズムに従っているため、必ずしもすべてのマシンが使用されるわけではありません。

    • マシンが実行時に別のテストに割り当てられている場合、そのマシンはテストに使用されません。

  5. テストを再度実行すると、OpenText Core Performance Engineering内でテスト用に定義されたOPLGマシンは、cor_uploader.yml設定によって上書きされます。

先頭に戻る

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

負荷テストを実行する前に、よく寄せられる質問を確認してください。

統合からの負荷テストの実行は、OpenText Core Performance Engineering UIからのテスト実行と同じですか?

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

初めてテストを実行するときに、OpenText Core Performance Engineeringで負荷テストはどのように作成されますか?

テストを実行すると、スクリプトがアップロードされ、ラベルAutogenerated_<scriptname>を使用して負荷テストが作成されます。

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

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

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

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

負荷テストにアセットを追加するにはどうすればよいですか?

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

負荷テストの分散を変更するにはどうすればよいですか?

cor_uploader.ymlファイルで、テストの場所間の分散を構成できます。詳細については、テストの分布パラメーターの定義を参照してください。

負荷テストのモニターを定義するにはどうすればよいですか?

OpenText Core Performance Engineering UIでテスト用のモニターを設定できます。OpenText Performance Engineering for Developersから再度テストを実行すると、OpenText Core Performance Engineeringの最新の構成が使用されます。

負荷テストの一般設定を変更するにはどうすればよいですか?

OpenText Core Performance Engineering UIを使用して、いくつかの一般設定を変更できます。テストがOpenText Performance Engineering for Developersから実行されるたびに、電子メールレポートアドレスが上書きされることに注意してください。

負荷テストのSLA設定を編集するにはどうすればよいですか?

OpenText Performance Engineering for Developersからテストを実行すると、OpenText Core Performance EngineeringでのテストトランザクションのSLAが無効になります。UIからテストを実行すると、再度有効にできます。

先頭に戻る

関連項目: