Skip to main content
GET
Query node telemetry history
CLI equivalent: ornn machines metrics <machine> --start <time> --end <time> --max-points 240 --format json.

Authorizations

Authorization
string
header
required

Create an organization API key in Account Settings > Developer. Do not send this key to the Kubernetes API server.

Path Parameters

node_id
string<uuid>
required

A physical node ID from List reserved GPU nodes.

Query Parameters

start
string<date-time>
required

Range start, RFC 3339.

end
string<date-time>
required

Range end, RFC 3339. An end at or before start returns no data.

max_points
integer
default:240

Target number of points per metric, from 1 to 500. Defaults to 240.

Required range: 1 <= x <= 500
metrics
string

Comma-separated metric names. Omit for every customer metric. Accepted names are cpu_utilization, cpu_temperature, gpu_utilization, gpu_temperature, gpu_power_w, gpu_fan_speed_percent, component_temperature_max, memory_utilization, gpu_memory_utilization, storage_utilization, and ethernet_latency_ms; other names are ignored.

gpu_uuid
string

One GPU's UUID from the gpus reading. The range must span 24 hours or less.

Response

Metric windows for the range.

tier
enum<string>

full returns raw samples, where start equals end. Other tiers summarize each window.

Available options:
full,
hour,
day,
month
windows
object[]
gpu_uuid
string