Skip to main content
GET
Get server resource metrics

Authorizations

api-key
string
header
required

Path Parameters

instance_id
string
required

Server instance ID.

Query Parameters

period
enum<string>
default:1h

Relative time window for metrics (used when start_time is omitted). "5m": last 5 minutes, "15m": last 15 minutes, "1h": last hour, "6h": last 6 hours, "24h": last 24 hours.

Available options:
5m,
15m,
1h,
6h,
24h
step
enum<string>
default:60s

Data point interval. Smaller steps give higher resolution but more data. "15s": every 15 seconds … "1800s": every 30 minutes. Scale it to the window (a wide window needs a coarse step).

Available options:
15s,
30s,
60s,
300s,
600s,
1800s
start_time
string

Absolute window start — ISO 8601 (e.g., "2026-07-12T03:00:00Z") or relative (e.g., "-6h"). When set it OVERRIDES period, so you can inspect a specific interval (pair with end_time).

end_time
string

Absolute window end — ISO 8601. Defaults to now. Use with start_time for a fixed interval (e.g., a past incident window).

Response

Server resource metrics over the requested time window.

Server resource metrics including CPU, memory, network, load, and connections over a configurable time window.

instance_id
string
required

Server instance ID.

machine_id
string
required

Fly.io machine ID providing these metrics.

region
string
required

Fly.io region code (e.g., "ewr", "fra").

compute_size
string | null
required

PlayFlow compute size of the machine (e.g. "small", "large").

vcpus
number | null
required

Number of vCPUs allocated to the machine, derived from compute_size. Threshold the 1-minute load average against this: at/above vcpus is a warning, at/above 2× is an overload likely to freeze the game loop. Null when the size is unknown.

lifecycle
object
required

Restart/stop/OOM markers for the charts.

period
object
required

Time window and resolution for the returned metrics.

cpu
object
required

CPU usage metrics, broken down to surface I/O-wait and steal which are typical freeze culprits.

memory
object
required

Memory usage metrics.

network
object
required

Network I/O metrics (bytes, packets, and — for freeze diagnosis — dropped/error rates).

load
object
required

System load average metrics over 1/5/15-minute windows.

connections
object
required

Network connection metrics.