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 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

Maximum windows per metric including edge padding, from 1 to 500. Defaults to 240. A response contains at most 10000 windows total.

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>

Storage input tier. Read resolution_ms for the returned aggregation width.

Available options:
full,
hour,
day,
month
resolution_ms
integer

Largest aggregation width in milliseconds; zero means unaggregated samples. Empty reads report the planned width.

Required range: x >= 0
windows
object[]
gpu_uuid
string