Skip to main content

types.NodeStatus

types.NodeStatus API schema defining 11 fields, including connected since, connection state, created at, and 8 more.

connected_sincestring

ConnectedSince is when the node connected in the current session

connection_statetypes.NodeConnectionState

ConnectionState is the current connection state of the node

Possible values: [disconnected, connecting, connected, lost, deleted]

created_atstring

CreatedAt is when the node was first registered

disconnected_sincestring

DisconnectedSince is when the node last disconnected

last_heartbeatstring

LastHeartbeat is when the last heartbeat was received

messagestring

Message provides additional context about the current state

resource_usage object

ResourceUsage contains the current resource usage metrics (updated with each heartbeat)

cpu_percentnumber

CPUPercent is the CPU usage percentage (0-100)

disk_capacity_bytesinteger

DiskCapacityBytes is the total disk capacity in bytes

disk_percentnumber

DiskPercent is the disk usage percentage (0-100)

disk_used_bytesinteger

DiskUsedBytes is the disk space used in bytes

memory_capacity_bytesinteger

MemoryCapacityBytes is the total available memory in bytes

memory_percentnumber

MemoryPercent is the memory usage percentage (0-100)

memory_used_bytesinteger

MemoryUsedBytes is the memory currently in use in bytes

revisioninteger

Revision is incremented on each update for optimistic concurrency control

schedulingtypes.NodeSchedulingEligibility

Scheduling is whether the scheduler may place new work on the node. Draining a node stops new placements while it stays connected and its in-flight executions keep running (a scheduling-layer control, orthogonal to the identity lifecycle). The empty zero value is treated as eligible, so nodes persisted before this field existed schedule normally.

Possible values: [eligible, drained]

session_idstring

SessionID uniquely identifies the current connection session

updated_atstring

UpdatedAt is when the node was last updated

types.NodeStatus
{
  "connected_since": "string",
  "connection_state": "disconnected",
  "created_at": "string",
  "disconnected_since": "string",
  "last_heartbeat": "string",
  "message": "string",
  "resource_usage": {
    "cpu_percent": 0,
    "disk_capacity_bytes": 0,
    "disk_percent": 0,
    "disk_used_bytes": 0,
    "memory_capacity_bytes": 0,
    "memory_percent": 0,
    "memory_used_bytes": 0
  },
  "revision": 0,
  "scheduling": "eligible",
  "session_id": "string",
  "updated_at": "string"
}