UIP TM のパフォーマンス シナリオ実行データ

シナリオの実行を検査する「uip tm perf-scenario」動詞の構文とオプション (executions list、results get、http-errors、automation-errors、transaction-metrics)。

これらの uip tm perf-scenario 動詞は、シナリオの実行によって生成されたデータ (実行リスト自体、完全な結果バンドル、HTTP エラー、オートメーション ステップの失敗、トランザクションごとのメトリック) を検査します。

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

概要

uip tm perf-scenario executions list --project-key <key> [--scenario-id <uuid>] [--execution-type <type>] [--limit <n>] [--offset <n>] [--query <expr>]
uip tm perf-scenario results get --execution-id <uuid> [--completed <true|false>] [--query <expr>]
uip tm perf-scenario http-errors list --execution-id <uuid> --load-group-id <uuid> --start-time-ms <n> --end-time-ms <n> [--query <expr>]
uip tm perf-scenario automation-errors list --execution-id <uuid> --load-group-id <uuid> --start-time-ms <n> --end-time-ms <n> [--query <expr>]
uip tm perf-scenario transaction-metrics list --load-group-id <uuid> --start-time-ms <n> --end-time-ms <n> [--query <expr>]

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

注:

これらの動詞はどれも --project-key を必要としません。Test Manager プロジェクトを解決するのではなく、パフォーマンス サービスを直接呼び出します。--load-group-idここで シナリオのload-groups list ではなく、LoadGroupId の 実行ごとの 負荷グループ IDperf-scenario get です。

UIP TM のパフォーマンス シナリオの実行のリスト

シナリオの実行のリストを表示します。必要に応じて、1 つのシナリオまたは 1 つの実行の種類 (ドライ ランと完全) にフィルター処理します。

オプション

フラグ	説明
--project-key <key>	必須。所有するプロジェクト。
--scenario-id <uuid>	フィルターを適用し、1 つのシナリオ ( SP1:7 キーではなく UUID) に絞り込む。
--execution-type <type>	実行の種類 ( dryRun または performanceTesting) でフィルター処理します。
--limit <n>	返される結果の最大数。省略すると、既定でサービス独自のページ サイズが使用されます。
--offset <n>	ページングの場合はスキップする結果既定値は 0です。
--query <expr>	出力データに適用される JQ スタイルのフィルターです。

例

uip tm perf-scenario executions list \
  --project-key DEMO \
  --scenario-id 756e8ebf-c227-0000-8a9f-0b49fd934bef \
  --execution-type performanceTesting

データシェイプ

{
  "Code": "PerfExecutionsList",
  "Data": {
    "Data": [
      {
        "Id": "80694766-5a44-0000-0985-0b49fd93832d",
        "ExecutionType": "performanceTesting",
        "Status": "Finished"
      }
    ]
  }
}

uip tm のパフォーマンス シナリオの結果 get

実行の完全な実行データ バンドル (負荷グループごとの時系列、CPU/RAM、アプリケーション ログ) を入手します。これは、実行完了後に出力される perf-scenario execute --wait 基になるペイロードと同じです。

オプション

フラグ	説明
--execution-id <uuid>	必須。シナリオの実行 ID
--completed <bool>	true 完了した実行をデータベースから読み取ります。 false は、Redis からまだ実行中のライブ実行を読み取ります。既定値は trueです。
--query <expr>	出力データに適用される JQ スタイルのフィルターです。

例

uip tm perf-scenario results get --execution-id 80694766-5a44-0000-0985-0b49fd93832d

データシェイプ

{
  "Code": "PerfExecutionResults",
  "Data": {
    "ExecutionsData": {},
    "ApplicationLogs": []
  }
}

これは、パフォーマンスサービスからの生のパススルー形状です。execute --wait、基になる同じデータを後処理して、[perf-scenario execute] ページに記載されているより使いやすいLoadGroups/ApplicationLogs図形にします。実行の途中で本稼働/進行中のビューが必要な場合にのみ、results get --completed false を直接呼び出してください。

uip tm perf-scenario http-errors リスト

1 つの負荷グループの実行に対して記録された HTTP エラーを、一定時間枠で要求別にグループ化してリストします。

オプション

フラグ	説明
--execution-id <uuid>	必須。シナリオの実行 ID
--load-group-id <uuid>	必須。負荷グループの実行 ID です (シナリオの LoadGroupIdではなく load-groups listから)。
--start-time-ms <n>	必須。ウィンドウの開始 (実行開始からのミリ秒単位)。実行全体で 0 を使用します。
--end-time-ms <n>	必須。ウィンドウの終了 (実行開始からのミリ秒単位)。実行時間は、実行全体に対して使用します。
--query <expr>	出力データに適用される JQ スタイルのフィルターです。

例

uip tm perf-scenario http-errors list \
  --execution-id 80694766-5a44-0000-0985-0b49fd93832d \
  --load-group-id 082486b0-8d51-0000-b54a-0b4a1388f850 \
  --start-time-ms 0 \
  --end-time-ms 240000

データシェイプ

{
  "Code": "PerfHttpErrorsList",
  "Data": { "Errors": [] }
}

uip tm のパフォーマンス シナリオ automation-errors リスト

1 つの負荷グループの実行で、一定期間にわたるオートメーション ステップの失敗のリストを作成します。

オプション

フラグ	説明
--execution-id <uuid>	必須。シナリオの実行 ID
--load-group-id <uuid>	必須。負荷グループの実行 ID ( load-groups listから)。
--start-time-ms <n>	必須。ウィンドウの開始 (実行開始からのミリ秒単位)。実行全体で 0 を使用します。
--end-time-ms <n>	必須。ウィンドウの終了 (実行開始からのミリ秒単位)。
--query <expr>	出力データに適用される JQ スタイルのフィルターです。

例

uip tm perf-scenario automation-errors list \
  --execution-id 80694766-5a44-0000-0985-0b49fd93832d \
  --load-group-id 082486b0-8d51-0000-b54a-0b4a1388f850 \
  --start-time-ms 0 \
  --end-time-ms 240000

データシェイプ

{
  "Code": "PerfAutomationErrorsList",
  "Data": { "Errors": [] }
}

uip tm のパフォーマンス シナリオ transaction-metrics リスト

一定時間枠における負荷グループのトランザクションごとの応答時間とスループット メトリック (平均、P50、P95、P99) のリストを作成します。API SUT のみ — このデータは、ブラウザー駆動型 (Web) のシナリオでは収集されません。

オプション

フラグ	説明
--load-group-id <uuid>	必須。負荷グループの実行 ID ( load-groups listから)。
--start-time-ms <n>	必須。ウィンドウの開始 (実行開始からのミリ秒単位)。実行全体で 0 を使用します。
--end-time-ms <n>	必須。ウィンドウの終了 (実行開始からのミリ秒単位)。
--query <expr>	出力データに適用される JQ スタイルのフィルターです。

例

uip tm perf-scenario transaction-metrics list \
  --load-group-id 082486b0-8d51-0000-b54a-0b4a1388f850 \
  --start-time-ms 0 \
  --end-time-ms 240000

データシェイプ

{
  "Code": "PerfTransactionMetricsList",
  "Data": { "Metrics": [] }
}

この動詞は http-errors list や automation-errors listとは異なり、--execution-id を取らず、 のみ--load-group-idを使用することに注意してください。

関連

• UIP TM のパフォーマンス シナリオ — シナリオのライフサイクルと共通の概念です。
• 負荷グループ — このページで使用されている --load-group-id のソースです。
• レポート — 実行または比較用に作成されたレポートを表示します。

参照

• Test Manager の概要