Skip to Content
SeyloDocs
API referenceMetrics

Get usage of a service

GET
/api/v1/metrics.service

Returns a service's CPU, memory (without page cache) and network series over a range, summed over its replicas and nodes, with the current value per node and the peak memory in the range.

Needs metrics.view on the service (a grant on its project covers it). Available to MCP clients and the assistant.

Authorization

cookieseylo_session<token>

Query Parameters

serviceId*string

Panel-issued id.

Match^[a-z0-9]{16}$
range?||||
Default"1h"

Response Body

Success.

application/json
  1. response
range*string|string|string|string|string
stepSeconds*integer
Range1 <= value
current*array<>
peakMemoryBytes*integer
Range0 <= value
points*array<>
Example Request
curl -X GET 'https://example.com/api/v1/metrics.service?serviceId=string'
Example Response
{  "range": "live",  "stepSeconds": 1,  "current": [    {      "nodeId": "string",      "at": "2019-08-24T14:15:22Z",      "cpuPercent": 0,      "memoryBytes": 0,      "memoryLimitBytes": 0,      "networkRxBytesPerSec": 0,      "networkTxBytesPerSec": 0    }  ],  "peakMemoryBytes": 0,  "points": [    {      "t": 0,      "cpuPercent": 0,      "cpuPercentMax": 0,      "memoryBytes": 0,      "memoryBytesMax": 0,      "networkRxBytesPerSec": 0,      "networkTxBytesPerSec": 0    }  ]}

Get usage of every node GET

Returns CPU, memory and network series for every node over a range, for the dashboard graphs, plus each node's latest sample. Needs `nodes.view`, which owners and admins hold. Available to MCP clients and the assistant.

Get current usage of every service GET

Returns the latest CPU and memory of every running service the caller can see, for usage columns in lists ("4% - 182 MB"). Any signed-in caller. Available to MCP clients and the assistant.