---
title: "Get agent resource metrics"
method: GET
path: "/agents/{agent_id}/metrics"
tags: ["Agents"]
---

# Get agent resource metrics

`GET /agents/{agent_id}/metrics`

## Request

- Base URL: `https://api-docs.jackhamr.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api-docs.jackhamr.ai/agents/{agent_id}/metrics`
- Auth: none declared

Live CPU, memory, disk, and network metrics for a running agent.

The agent must be running and have a provisioned VMID; otherwise a
422 ``validation_error`` (agent not running / no VMID) is returned.

## Path parameters

- `agent_id` string, required

## Response `200`

Successful Response

- AgentMetrics: Live resource metrics for an agent.
  - `agent_id` string, required
  - `timestamp` string, date-time, required
  - `cpu_usage` number, nullable
  - `cpu_cores_used` number, nullable
  - `memory_used` number, nullable
  - `memory_total` number, nullable
  - `memory_percent` number, nullable
  - `disk_used` number, nullable
  - `disk_total` number, nullable
  - `disk_percent` number, nullable
  - `net_in` number, nullable
  - `net_out` number, nullable
  - `process_count` integer, nullable
  - `uptime` integer, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/jackhamr/apis/jackhamr-api.md) · [All operations](https://skmtc.dev/jackhamr/apis/jackhamr-api/llms.txt) · [OpenAPI document](https://skmtc.dev/jackhamr/apis/jackhamr-api/revisions/f75d221481d8?raw)