Devbox
Devbox-ObservabilityTools

Get resource usage for a Devbox.

Changed on

Get resource usage metrics for a specific Devbox. Returns CPU, memory, and disk consumption calculated from the Devbox's lifecycle, excluding any suspended periods for CPU and memory. Disk usage includes the full elapsed time since storage is consumed even when suspended.

get/v1/devboxes/{id}/usage

Request

  • Base URL: https://api.runloop.ai
  • URL: https://api.runloop.ai/v1/devboxes/{id}/usage
  • Auth: HTTP bearer

Path parameters

idstring required

The Devbox ID.

Response

OK

idstring required

The devbox ID.

total_active_secondsinteger required

Total time in seconds the devbox was actively running (excludes time spent suspended).

total_elapsed_secondsinteger required

Total elapsed time in seconds from devbox creation to now (or end time if terminated). Includes all time regardless of devbox state.

vcpu_secondsinteger required

vCPU usage in vCPU-seconds (total_active_seconds multiplied by the number of vCPUs).

memory_gb_secondsinteger required

Memory usage in GB-seconds (total_active_seconds multiplied by memory in GB).

disk_gb_secondsinteger required

Disk usage in GB-seconds (total_elapsed_seconds multiplied by disk size in GB). Disk is billed for elapsed time since storage is consumed even when suspended.

start_time_msinteger required

The devbox creation time in milliseconds since epoch.

end_time_msinteger nullable

The devbox end time in milliseconds since epoch, or null if still running.

statusstring required

The current status of the devbox.

Changes