# uip tm perf-scenario execution data

> Syntax and options for the `uip tm perf-scenario` verbs that inspect a scenario execution — executions list, results get, http-errors, automation-errors, and transaction-metrics.

These `uip tm perf-scenario` verbs inspect data produced by a scenario execution: the execution list itself, the full results bundle, HTTP errors, automation-step failures, and per-transaction metrics.

This page is part of the [`uip tm perf-scenario`](./uip-test-manager-perf-scenario.md) command group — see that page for scenario lifecycle verbs (`create`, `get`, `list`, `execute`, `stop`, `list-dry-run-reports`) and shared concepts.

## Synopsis

```text
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>]
```

All verbs honor the [global options](./global-options.md) and the standard [exit codes](./exit-codes.md). Every verb accepts `--log-level <level>` (default `Information`).

:::note
None of these verbs take `--project-key` — they call the Performance Service directly rather than resolving a Test Manager project. `--load-group-id` here is the **per-execution** load group id from [`load-groups list`](./uip-test-manager-perf-scenario-load-groups.md#uip-tm-perf-scenario-load-groups-list), not the scenario's `LoadGroupId` from `perf-scenario get`.
:::

## uip tm perf-scenario executions list

List scenario executions, optionally filtered to one scenario and/or one execution type (dry run vs. full).

### Options

| Flag | Description |
|---|---|
| `--project-key <key>` | **Required.** Owning project. |
| `--scenario-id <uuid>` | Filter to one scenario (UUID, not the `SP1:7` key). |
| `--execution-type <type>` | Filter by execution type: `dryRun` or `performanceTesting`. |
| `--limit <n>` | Max results to return. Defaults to the service's own page size when omitted. |
| `--offset <n>` | Results to skip, for paging. Defaults to `0`. |
| `--query <expr>` | jq-style filter applied to the output data. |

### Example

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

### Data shape

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

## uip tm perf-scenario results get

Get the full execution data bundle for a run: per-load-group time series, CPU/RAM, and application logs. This is the same underlying payload [`perf-scenario execute --wait`](./uip-test-manager-perf-scenario.md#uip-tm-perf-scenario-execute) prints once the run finishes.

### Options

| Flag | Description |
|---|---|
| `--execution-id <uuid>` | **Required.** Scenario execution id. |
| `--completed <bool>` | `true` reads the finished run from the database; `false` reads a live, still-running execution from Redis. Defaults to `true`. |
| `--query <expr>` | jq-style filter applied to the output data. |

### Example

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

### Data shape

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

This is the raw pass-through shape from the Performance Service. `execute --wait` post-processes the same underlying data into the friendlier `LoadGroups`/`ApplicationLogs` shape documented on the [`perf-scenario execute`](./uip-test-manager-perf-scenario.md#uip-tm-perf-scenario-execute) page — call `results get --completed false` directly only when you need the live/in-progress view mid-run.

## uip tm perf-scenario http-errors list

List HTTP errors recorded for one load group's execution, grouped by request, over a time window.

### Options

| Flag | Description |
|---|---|
| `--execution-id <uuid>` | **Required.** Scenario execution id. |
| `--load-group-id <uuid>` | **Required.** Load group execution id (from [`load-groups list`](./uip-test-manager-perf-scenario-load-groups.md#uip-tm-perf-scenario-load-groups-list), not the scenario's `LoadGroupId`). |
| `--start-time-ms <n>` | **Required.** Window start, in ms from run start. Use `0` for the whole run. |
| `--end-time-ms <n>` | **Required.** Window end, in ms from run start. Use the run duration for the whole run. |
| `--query <expr>` | jq-style filter applied to the output data. |

### Example

```bash
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
```

### Data shape

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

## uip tm perf-scenario automation-errors list

List automation-step failures for one load group's execution, over a time window.

### Options

| Flag | Description |
|---|---|
| `--execution-id <uuid>` | **Required.** Scenario execution id. |
| `--load-group-id <uuid>` | **Required.** Load group execution id (from `load-groups list`). |
| `--start-time-ms <n>` | **Required.** Window start, in ms from run start. Use `0` for the whole run. |
| `--end-time-ms <n>` | **Required.** Window end, in ms from run start. |
| `--query <expr>` | jq-style filter applied to the output data. |

### Example

```bash
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
```

### Data shape

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

## uip tm perf-scenario transaction-metrics list

List per-transaction response-time and throughput metrics (average, P50, P95, P99) for a load group, over a time window. **API SUTs only** — this data isn't collected for browser-driven (web) scenarios.

### Options

| Flag | Description |
|---|---|
| `--load-group-id <uuid>` | **Required.** Load group execution id (from `load-groups list`). |
| `--start-time-ms <n>` | **Required.** Window start, in ms from run start. Use `0` for the whole run. |
| `--end-time-ms <n>` | **Required.** Window end, in ms from run start. |
| `--query <expr>` | jq-style filter applied to the output data. |

### Example

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

### Data shape

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

Note this verb takes no `--execution-id` — only `--load-group-id`, unlike `http-errors list` and `automation-errors list`.

## Related

- [uip tm perf-scenario](./uip-test-manager-perf-scenario.md) — scenario lifecycle and shared concepts.
- [Load groups](./uip-test-manager-perf-scenario-load-groups.md) — source of the `--load-group-id` used on this page.
- [Reports](./uip-test-manager-perf-scenario-report.md) — render authored reports for an execution or a comparison.

## See also

- [Test Manager overview](./uip-test-manager.md)