Skip to content

Instance metrics timeseries

GET
/api/v1/services/{id}/metrics/timeseries

Bucketed history of instance metrics (tps1m, msptAvg, heapUsedMb, playerCount). Sampled every 15s; rebuilt on controller restart. Empty buckets contain null.

id
required
string

Instance ID

window
string

Window size: 15m, 1h, 6h, or 24h. Default 1h.

buckets
integer format: int32

Bucket count, clamped to [10, 360]. Default 60.

OK

object
windowMs
required
integer format: int64
bucketWidthMs
required
integer format: int64
buckets
required
integer format: int32
startedAtMs
required
integer format: int64
series
object
key
additional properties
Array<number>

Invalid window or buckets parameter

Unauthorized

Forbidden

Instance not found