list_server_metrics

List a load run's persisted server-telemetry samples.

List the persisted server-telemetry samples captured for one load run — the data behind the Load view's Server metrics section. While a load run executes, an installed telemetry agent samples the target server(s) (CPU / memory / sessions + any custom gauges) and TestVibe stores them against the run. Unlike get_live_servers, these survive long after the run finishes.

Request

GET /api/v1/ops/projects/{project}/telemetry/runs/{runId}/server-metrics

Parameter	In	Type	Required	Description
project	path	string	yes	The project's public id.
runId	path	integer	yes	A load run id (from list_runs or run_load_test).

cURL

curl -H "Authorization: Bearer $TESTVIBE_API_KEY" \
  "$TESTVIBE_SERVER/api/v1/ops/projects/$PROJECT/telemetry/runs/215/server-metrics"

CLI

testvibe telemetry metrics 215

MCP

Tool list_server_metrics — { "runId": "215" }.

Response

[
  {
    "ts": "2026-07-06T15:04:11Z",
    "source": "testvibe-web-prod",
    "cpuPercent": 42.7,
    "memoryMb": 812.0,
    "sessions": 40,
    "memPerSessionMb": 20.3,
    "extra": { "custom": { "GC heap (MB)": 120.0 }, "meta": { "machine": "web-1", "cores": 4 } }
  }
]

extra is the agent envelope — custom gauges plus server-identity meta (legacy agents may store the bare gauges object).

Errors

HTTP	When
400 invalid_request	runId is not a number.
404 not_found	No such project, or no such run in this project.