ClusterNode is a datatype for a node in the a LogScale Cluster.

Table: ClusterNode

ParameterTypeRequiredDefaultStabilityDescription
Some arguments may be required, as indicated in the Required column. For return datatypes, this indicates that you must specify which fields you want returned in the results.
Table last updated: Aug 19, 2025
assignedTasks[NodeTaskEnum]yes Short-TermThe datatype for this is an enumerated list of values. See NodeTaskEnum.
bootedAtdatetimeyes Long-TermThe date and time, in the ISO-8601 instant format (e.g., 2022-12-03T10:15:30.00Z), whem the host was booted.
canBeSafelyUnregisteredbooleanyes Long-TermWhether the node can be safely unregistered.
clusterInfoAgeSecondsfloatyes Long-TermThe age of the cluster information in seconds.
consideredAliveUntildatetime  Short-TermThe date and time, in the ISO-8601 instant format (e.g., 2022-12-03T10:15:30.00Z), for when the node is to be considered alive or active.
currentSizefloatyes Long-TermThe size in gigabytes of data currently on this node.
evictionStatusEvictionStatusyes Long-TermThe data describing the status of eviction. See EvictionStatus.
freeOnPrimaryfloatyes Long-TermThe size in gigabytes of the free space on this node of the primary storage location.
freeOnSecondaryfloatyes Long-TermThe size in gigabytes of the free space on this node of the secondary storage location. Zero if no secondary is configured.
hasDigestRolebooleanyes Long-TermWhether the node can process Kafka partitions.
hasStorageRolebooleanyes Long-TermWhether the node has local segment storage.
humioVersionstringyes Long-TermThe version of LogScale used by the cluster node.
idintegeryes Long-TermThe unique identifier of the cluster node.
inboundSegmentSizefloatyes Long-TermThe size in gigabytes of data this node needs to receive.
isAvailablebooleanyes Long-TermWhether the node is considered up or down by the cluster coordinated. This is based on the lastHeartbeat field.
isBeingEvictedboolean  Long-TermWhether the node is marked for eviction. The Falcon LogScale cluster will start to move segments, digesters and queries it contains.
lastHeartbeatdatetimeyes Long-TermThe last time, in the ISO-8601 instant format (e.g., 2022-12-03T10:15:30.00Z), a heartbeat was received from the node.
namestringyes Long-TermThe name of the cluster node.
outboundSegmentSizefloatyes Short-TermThe size in gigabytes of data this node has that others need.
primarySizefloatyes Long-TermThe size in gigabytes of the data currently on this node that are in the primary storage location.
reasonsNodeCannotBeSafelyUnregisteredReasonsNodeCannotBeSafelyUnregisteredyes Long-TermThe reasons the node cannot be safely unregistered. See ReasonsNodeCannotBeSafelyUnregistered.
secondarySizefloatyes Long-TermThe size in gigabytes of the data currently on this node that are in the secondary storage location. Zero (i.e., 0) if no secondary is configured.
solitarySegmentSizefloatyes Long-TermThe size in gigabytes of data that only exists on this node - i.e. only one replica exists in the cluster.
supportedTasks[NodeTaskEnum]yes Short-TermA list of supported tasks. See NodeTaskEnum.
targetSizefloatyes Long-TermThe size in gigabytes of data once the node has received the data allocated to it.
timeSinceBootedlongyes Long-TermThe time since the last boot.
timeSinceLastHeartbeatlongyes Long-TermThe time since a heartbeat was received from the node.
totalSizeOfPrimaryfloatyes Long-TermThe total size in gigabytes of the primary storage location on this node.
totalSizeOfSecondaryfloatyes Long-TermThe total size in gigabytes of the secondary storage location on this node. Zero if no secondary is configured.
unassignedTasks[NodeTaskEnum]yes Short-TermA list of unassigned tasks. See NodeTaskEnum.
uristringyes Long-TermThe URI (Uniform Resource Identifier) of the cluster node.
uuidstringyes Long-TermThe UUID (Universally Unique 128-bit Identifier) of the cluster node.
wipSizefloatyes Long-TermThe size in gigabytes of work-in-progress data files.
zonestring  Long-TermThe zone of the cluster node.