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 some fields, this column indicates that a result will always be returned for this column.
Table last updated: Mar 25, 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.
consideredAliveUntildatetimeyes 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.
clusterInfoAgeSecondsfloatyes Long-Termtext
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.
isBeingEvictedbooleanyes 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.
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.
timeSinceBootedlongyes Long-TermThe time since the last boot.
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-Termtext