uip tm perf-scenario load-groups

「uip tm perf-scenario load-groups」の構文とオプション。テスト ケースをパフォーマンス シナリオにバインドし、そのロード プロファイルを調整します。

uip tm perf-scenario load-groups は、パフォーマンス シナリオにバインドされた負荷グループを管理します。負荷グループとは、ロード プロファイル (仮想ユーザー、ランプ アップ/ピーク/ランプ ダウンのタイミング、SLO のしきい値、ロボットの種類) を持つシナリオにバインドされた 1 つのテスト ケースのことです。

このページは uip tm perf-scenario コマンド グループの一部です。シナリオ ライフサイクル動詞 (create、 get、 list、 execute、 stop、 list-dry-run-reports) および共通の概念については、該当のページをご覧ください。

概要

uip tm perf-scenario load-groups add --scenario-key <key> [--project-key <key>] (--test-case-key <key> | --test-case-id <uuid>) --folder-key <uuid> --package-name <name> [--package-version <version>] [--virtual-users <n>] [--ramp-up-minutes <n>] [--peak-minutes <n>] [--ramp-down-minutes <n>] [--delay-minutes <n>] [--max-response-time-ms <ms>] [--max-error-rate <rate>] [--robot-type <type>]
uip tm perf-scenario load-groups update --load-group-id <uuid> --project-key <key> [--virtual-users <n>] [--ramp-up-minutes <n>] [--peak-minutes <n>] [--ramp-down-minutes <n>] [--delay-minutes <n>] [--max-response-time-ms <ms>] [--max-error-rate <rate>] [--multiplexing-factor <n>] [--robot-type <type>] [--enabled <bool>]
uip tm perf-scenario load-groups remove --load-group-id <uuid> --project-key <key>
uip tm perf-scenario load-groups list --project-key <key> --execution-id <uuid> [--query <expr>]

すべての動詞は、 グローバル オプション と標準の 終了コードを尊重します。すべての動詞は --log-level <level> を受け入れます (既定は Information)。

注:

--project-key は、add では任意ですが (省略する場合は --scenario-key プレフィックスから派生)、update、remove、および listでは必須の.requiredOption()です。これらは派生可能なプロジェクト プレフィックスのない裸の UUID によってターゲットを識別するためです。

uip tm perf-scenario load-groups add

テスト ケースを新しい負荷グループとしてシナリオにバインドする負荷プロファイルのドライランのデフォルトを設定します。ドライランが終了したら、後で update でダイヤルインします。

オプション

フラグ	説明
--scenario-key <key>	必須。シナリオ オブジェクト キー (例: SP1:7)。
--project-key <key>	所有するプロジェクト。任意 — 省略する場合は --scenario-key のプレフィックスから派生します。
--test-case-key <key>	バインドするテスト ケース オブジェクトのキーです (例: SP1:602)。API 経由でその UUID に解決されます。または --test-case-idを指定します。
--test-case-id <uuid>	テスト ケースの UUID を直接バインドします。キーの検索はスキップします。または --test-case-keyを指定します。
--folder-key <uuid>	必須。Orchestrator のフォルダー キー (GUID である必要があります)。
--package-name <name>	必須。オートメーションを含む Orchestrator パッケージ名です。
--package-version <version>	Orchestrator パッケージのバージョンです。省略すると、パッケージの最新のパブリッシュ済みバージョンが既定で使用されます (Orchestrator の検索で解決されます)。
--virtual-users <n>	仮想ユーザー数。既定値は 1です。
--ramp-up-minutes <n>	ランプ アップの期間 (分)。既定値は 0です。
--peak-minutes <n>	ピーク期間 (分)。既定値は 1です。
--ramp-down-minutes <n>	ランプ ダウンの期間 (分)。既定値は 0です。
--delay-minutes <n>	開始前の遅延 (分単位)。既定値は 0です。
--max-response-time-ms <ms>	最大応答時間 SLO(ミリ秒)。サーバーには、少なくとも 100が必要です。既定値は 100です。
--max-error-rate <rate>	最大エラー率 SLO (分数、たとえば 1% の場合は 0.01 )。サーバーには、少なくとも 0.0001が必要です。既定値は 0.0001です。
--robot-type <type>	ロボットの種類: standard、template、elasticRobotPool、cloudRobotVm、serverless既定値は standardです。

例

# bind by test case key
uip tm perf-scenario load-groups add \
  --scenario-key SP1:7 \
  --test-case-key SP1:602 \
  --folder-key 94821c49-ab85-49cb-94e1-f82c6d8973be \
  --package-name Checkout_Tests \
  --robot-type serverless

# bind by test case id directly (skips the key lookup)
uip tm perf-scenario load-groups add \
  --scenario-key SP1:7 \
  --test-case-id f0b7f77f-482b-0400-a9c4-0b49497eb136 \
  --folder-key 94821c49-ab85-49cb-94e1-f82c6d8973be \
  --package-name Checkout_Tests \
  --package-version 1.0.2

データシェイプ

{
  "Code": "LoadGroupAdd",
  "Data": {
    "ScenarioKey": "SP1:7",
    "TestCaseKey": "SP1:602",
    "LoadGroupId": "8e322581-0a25-0000-738b-0b49fd936ca1",
    "PackageName": "Checkout_Tests",
    "PackageVersion": "1.0.2",
    "VirtualUsers": 1,
    "Result": "Added"
  }
}

UIP TM のパフォーマンス シナリオの負荷グループの更新

1 つの負荷グループの負荷プロファイルを適切に更新します (仮想ユーザー、ランプ/ピーク/ランプ ダウンの時間 (分)、SLO のしきい値、ロボットの種類、有効ステート)。渡したフラグのみが変更され、それ以外はすべて保持されます。これは、合格ドライ ランとフル performanceTesting ランの間に使用して、実際の負荷プロファイルをダイヤルインします。

オプション

フラグ	説明
--load-group-id <uuid>	必須。シナリオの負荷グループの UUID (上の perf-scenario get、execute、または上記の add の LoadGroupId フィールドです。下記 list の実行ごとの ID ではありません)。
--project-key <key>	必須。所有するプロジェクト。
--virtual-users <n>	新しい仮想ユーザー数。
--ramp-up-minutes <n>	新しいランプ アップの期間 (分)。
--peak-minutes <n>	新しいピーク期間 (分)。
--ramp-down-minutes <n>	新しいランプ ダウン期間 (分)。
--delay-minutes <n>	開始前の新しい待機時間 (分)。
--max-response-time-ms <ms>	新しい最大応答時間 SLO (ミリ秒単位) (サーバーには 100以上が必要です)。
--max-error-rate <rate>	新しい最大エラー率 SLO (サーバーには少なくとも 0.0001が必要です)。
--multiplexing-factor <n>	多重化係数 — 推奨値はドライ ランの最後に出力されます (list-dry-run-reports → RecommendedMultiplexingFactor)。
--robot-type <type>	新しいロボットの種類: standard、 template、 elasticRobotPool、 cloudRobotVm、 serverless。
--enabled <bool>	この負荷グループを有効化 (true) か無効化 (false) します。

例

uip tm perf-scenario load-groups update \
  --load-group-id 8e322581-0a25-0000-738b-0b49fd936ca1 \
  --project-key SP1 \
  --virtual-users 50 \
  --ramp-up-minutes 2 \
  --peak-minutes 10

データシェイプ

{
  "Code": "LoadGroupUpdate",
  "Data": {
    "LoadGroupId": "8e322581-0a25-0000-738b-0b49fd936ca1",
    "VirtualUsers": 50,
    "RampUpMinutes": 2,
    "PeakMinutes": 10,
    "RampDownMinutes": 0,
    "DelayMinutes": 0,
    "MaxResponseTimeMs": 100,
    "MaxErrorRate": 0.0001,
    "MultiplexingFactor": null,
    "Enabled": true,
    "RobotType": "standard",
    "Result": "Updated"
  }
}

渡さなかったフィールドは、省略されずに現在の (変更されていない) 値でエコーバックされます。応答には、差分だけでなく、結合された完全な負荷グループが反映されます。

uip tm perf-scenario load-groups remove

シナリオから負荷グループを削除するテスト ケースとそのロード プロファイルをデタッチします。テスト ケース自体と過去の実行データは変更されません。

オプション

フラグ	説明
--load-group-id <uuid>	必須。シナリオの負荷グループの UUID (上記の perf-scenario get または add のLoadGroupId フィールド)。
--project-key <key>	必須。所有するプロジェクト。

例

uip tm perf-scenario load-groups remove \
  --load-group-id 8e322581-0a25-0000-738b-0b49fd936ca1 \
  --project-key SP1

データシェイプ

{
  "Code": "LoadGroupRemove",
  "Data": {
    "LoadGroupId": "8e322581-0a25-0000-738b-0b49fd936ca1",
    "Result": "Removed"
  }
}

これは、確認フラグのないハード削除です。CLI は -y/--yesの背後でゲートしません。

uip tm のパフォーマンス シナリオの負荷グループのリスト

1 つの実行の負荷グループ (テスト ケース、SUT、仮想ユーザー、しきい値、ステータス) を一覧表示します。これは、シナリオ自体の負荷グループのリストとは異なります。シナリオ自体に設定されている負荷グループを確認するには、 perf-scenario get を使用します。

オプション

フラグ	説明
--project-key <key>	必須。所有するプロジェクト。
--execution-id <uuid>	必須。シナリオ実行 ID (perf-scenario executeのExecutionId)。
--query <expr>	出力データに適用される JQ スタイルのフィルターです。

例

uip tm perf-scenario load-groups list \
  --project-key DEMO \
  --execution-id 80694766-5a44-0000-0985-0b49fd93832d

データシェイプ

{
  "Code": "PerfLoadGroupsList",
  "Data": {
    "Data": [
      {
        "Id": "082486b0-8d51-0000-b54a-0b4a1388f850",
        "Status": "Finished"
      }
    ]
  }
}

この応答は、専用の行図形ではなく、基になる SDK ペイロードのシン パスカル ケース パススルーであるため、正確なフィールド セット (テスト ケース、SUT、仮想ユーザー、しきい値) は、ここに示されているよりも豊富になる可能性があります。実際の応答を調べるか、 --query を使用して構成します。ここでのIdフィールドは、実行データのhttp-errors listとautomation-errors listが として予期する実行ごとの負荷グループ ID です--load-group-id。

関連

• UIP TM のパフォーマンス シナリオ — シナリオのライフサイクルと共通の概念です。
• 実行データ — 完了した実行または進行中の実行を調べます。
• レポート — 実行または比較用に作成されたレポートを表示します。
• テスト ケース — link-automationテスト ケースに、addとperf-scenario list-dry-run-reportsが依存するautomationIdを与えるものです。
• UI またはフォルダー リスト — addで使用される--folder-keyのソースです。

参照

• Test Manager の概要