Skip to Content
SeyloDocs
API referenceMetrics

Get usage of every node

GET
/api/v1/metrics.nodes

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.

Authorization

cookieseylo_session<token>

Query Parameters

range?||||
Default"1h"

Response Body

Success.

application/json
  1. response
range*string|string|string|string|string
stepSeconds*integer
Range1 <= value
nodes*array<>
Example Request
curl -X GET 'https://example.com/api/v1/metrics.nodes'
Example Response
{  "range": "live",  "stepSeconds": 1,  "nodes": [    {      "nodeId": "string",      "name": "string",      "online": true,      "latest": {        "at": "2019-08-24T14:15:22Z",        "cpuPercent": 0,        "memoryUsedBytes": 0,        "memoryTotalBytes": 0,        "diskUsedBytes": 0,        "diskTotalBytes": 0,        "networkRxBytesPerSec": 0,        "networkTxBytesPerSec": 0,        "load1": 0      },      "points": [        {          "t": 0,          "cpuPercent": 0,          "memoryUsedBytes": 0,          "memoryTotalBytes": 0,          "diskUsedBytes": 0,          "networkRxBytesPerSec": 0,          "networkTxBytesPerSec": 0        }      ]    }  ]}

Get usage of one node GET

Returns one node's CPU, memory, disk and network series over a range and its latest sample. Needs `nodes.view`, which owners and admins hold. Available to MCP clients and the assistant.

Get usage of a service GET

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.