Monitoring

Live and historical resource usage for servers, apps and databases, and the switch that turns history on.

A *Metrics query returns a fresh live sample; its *MetricsHistory counterpart returns the short rolling buffer the Monitoring charts seed from. setSaveMetrics is the instance-wide switch: off, no history accumulates anywhere.

Servers

`serverMetrics`

Needs view_metrics. Returns ServerMetrics.

A fresh live metrics snapshot for one server.

Argument	Type	Description
`serverId`	`String!`

query {
  serverMetrics(serverId: "srv_9f1c2ab7d3e4f5a6") {
    cpu
    memPct
    diskPct
    online
  }
}

`serverMetricsHistory`

Needs view_metrics. Returns [ServerMetrics!].

The metrics history buffered on the control plane for one server (oldest first) - what the Monitoring charts seed from on load. Empty when saving is off or the control plane restarted recently.

Argument	Type	Description
`serverId`	`String!`

query {
  serverMetricsHistory(serverId: "srv_9f1c2ab7d3e4f5a6") {
    cpu
    memPct
    diskPct
    online
  }
}

`fleetMetrics`

Needs view_metrics. Returns [FleetServerMetrics!].

Every server's newest reading plus a thinned trace, for the Monitoring page's fleet list. Reads the control plane's buffers only - no agent is dialled, so watching N hosts costs what watching one does.

query {
  fleetMetrics {
    serverId
    online
    cpu
    memPct
    diskPct
  }
}

Apps and databases

`appMetrics`

Needs view_metrics. Returns ContainerMetrics.

A fresh live per-container metrics snapshot for one app.

Argument	Type	Description
`appId`	`String!`

query {
  appMetrics(appId: "prj_9f1c2ab7d3e4f5a6") {
    cpu
    memUsed
    memLimit
    netRx
    netTx
  }
}

`appMetricsHistory`

Needs view_metrics. Returns [ContainerMetricsSample!].

The metrics history buffered for one app (oldest first) - what the app's Monitoring charts seed from. Empty when the owning server's telemetry stream has not delivered a frame for it yet.

Argument	Type	Description
`appId`	`String!`

query {
  appMetricsHistory(appId: "prj_9f1c2ab7d3e4f5a6") {
    ts
    cpu
    memUsed
  }
}

`databaseMetrics`

Needs view_metrics. Returns ContainerMetrics.

A fresh live per-container metrics snapshot for one database.

Argument	Type	Description
`databaseId`	`String!`

query {
  databaseMetrics(databaseId: "db_9f1c2ab7d3e4f5a6") {
    cpu
    memUsed
    memLimit
    netRx
    netTx
  }
}

`databaseMetricsHistory`

Needs view_metrics. Returns [ContainerMetricsSample!].

The metrics history buffered for one database (oldest first). Empty when the owning server's telemetry stream has not delivered a frame for it yet.

Argument	Type	Description
`databaseId`	`String!`

query {
  databaseMetricsHistory(databaseId: "db_9f1c2ab7d3e4f5a6") {
    ts
    cpu
    memUsed
  }
}

Settings

`monitoringSettings`

Any signed-in principal. Returns MonitoringSettings.

The instance-wide monitoring settings.

query {
  monitoringSettings {
    saveMetrics
  }
}

`setSaveMetrics`

Needs manage_monitoring. Returns MonitoringSettings.

Turn saving server metrics on the control plane on or off. Turning it off also drops the buffered history.

Argument	Type	Description
`enabled`	`Boolean!`

mutation {
  setSaveMetrics(enabled: true) {
    saveMetrics
  }
}