---
title: "Get instance resource utilization stats"
method: GET
path: "/instances/{id}/stats"
---

# Get instance resource utilization stats

`GET /instances/{id}/stats`

Returns real-time resource utilization statistics for a running VM instance.
Metrics are collected from /proc/<pid>/stat and /proc/<pid>/statm for CPU and memory,
and from TAP interface statistics for network I/O.

## Path parameters

- `id` string, required

## Response `200`

Instance utilization statistics

- InstanceStats — Real-time resource utilization statistics for a VM instance
  - `instance_id` string, required — Instance identifier
  - `instance_name` string, required — Instance name
  - `cpu_seconds` number, double, required — Total CPU time consumed by the VM hypervisor process in seconds
  - `memory_rss_bytes` integer, required — Resident Set Size - actual physical memory used by the VM in bytes
  - `memory_vms_bytes` integer, required — Virtual Memory Size - total virtual memory allocated in bytes
  - `network_rx_bytes` integer, required — Total network bytes received by the VM (from TAP interface)
  - `network_tx_bytes` integer, required — Total network bytes transmitted by the VM (from TAP interface)
  - `allocated_vcpus` integer, required — Number of vCPUs allocated to the VM
  - `allocated_memory_bytes` integer, required — Total memory allocated to the VM (Size + HotplugSize) in bytes
  - `memory_utilization_ratio` number, double, nullable — Memory utilization ratio (RSS / allocated memory). Only present when allocated_memory_bytes > 0.

## Other responses

- `404` — Instance not found
- `500` — Internal server error

---

[API](https://skmtc.net/kernel/apis/hypeman-api.md) · [All operations](https://skmtc.net/kernel/apis/hypeman-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kernel/hypeman-api/versions/b4642bb950dc/schema)