# REST: Monitor Workloads

> REST: Monitor Workloads - Statistics, events, history, and aggregated Workload stats.

This Markdown file sits beside the HTML page at the same path (with a `.md` suffix). It summarizes the topic and lists links for tools and LLM context.

Companion generated at `2026-06-22T16:50:38.250510+00:00` (UTC).

## Primary page

- [REST: Monitor Workloads](https://docs.datarobot.com/en/docs/workload-api/monitor-workloads/monitoring-rest-endpoints.html.md): Full documentation for this topic (Markdown sidecar).

## Sections on this page

- [Statistics](https://docs.datarobot.com/en/docs/workload-api/monitor-workloads/monitoring-rest-endpoints.html.md#statistics): In-page section heading.
- [Events and history](https://docs.datarobot.com/en/docs/workload-api/monitor-workloads/monitoring-rest-endpoints.html.md#events-and-history): In-page section heading.

## Related documentation

- [Workload API](https://docs.datarobot.com/en/docs/workload-api/index.html.md): Linked from this page.
- [Monitor telemetry and health](https://docs.datarobot.com/en/docs/workload-api/monitor-workloads/index.html.md): Linked from this page.
- [Monitor deployed Workloads](https://docs.datarobot.com/en/docs/workload-api/monitor-workloads/monitoring-ui/index.html.md): Linked from this page.
- [View deployed Workload activity](https://docs.datarobot.com/en/docs/workload-api/monitor-workloads/activity-logs-ui/index.html.md): Linked from this page.
- [Monitoring concepts](https://docs.datarobot.com/en/docs/workload-api/monitor-workloads/monitoring-concepts.html.md): Linked from this page.

## Documentation content

This page indexes the REST endpoints the Workload API exposes for monitoring a Workload: statistics, lifecycle events, and replacement history. Application OpenTelemetry telemetry (traces, logs, metrics emitted by your container) is exposed through a separate observability surface and is not proxied by the Workload API; for the Console views, see [Monitor deployed Workloads](https://docs.datarobot.com/en/docs/workload-api/monitor-workloads/monitoring-ui/index.html.md) and [View deployed Workload activity](https://docs.datarobot.com/en/docs/workload-api/monitor-workloads/activity-logs-ui/index.html.md).

## Statistics

The following endpoints return aggregated and time-series request statistics, with optional reset by proton or time window.

| Verb | Path | Description |
| --- | --- | --- |
| GET | /workloads/stats | Aggregated statistics across all accessible Workloads. Same filters as GET /workloads. |
| GET | /workloads/{workload_id}/stats | Aggregated request statistics for one Workload. Optional protonId, startTime, endTime, responseTimeQuantile (default 0.5), slowRequestsThreshold (default 2000 ms). |
| GET | /workloads/{workload_id}/stats/{metric_name} | Time-series for a single metric. metric_name ∈ totalRequests, requestsOverN, requestsPerMinute, concurrentRequests, responseTime, totalErrorRate. Optional resolution (PT1M, PT5M, PT1H, P1D, P7D, P1M; default P1D). |
| DELETE | /workloads/{workload_id}/stats | Reset Workload statistics. Optional protonId, startTime, endTime for partial windows. |

## Events and history

These endpoints expose the lifecycle event stream and the Workload's replacement history.

| Verb | Path | Description |
| --- | --- | --- |
| GET | /workloads/{workload_id}/events | List lifecycle events (status changes, errors) for a Workload. |
| GET | /workloads/{workload_id}/history | List the Workload's replacement history (ReplacementHistoryListResponse). |

See [Monitoring concepts](https://docs.datarobot.com/en/docs/workload-api/monitor-workloads/monitoring-concepts.html.md) for retention and access semantics.