Cluster Overview Page

The Cluster Overview page of the Admin UI provides details of the cluster nodes and their liveness status, replication status, uptime, and key hardware metrics. Enterprise users can enable and switch to the Node Map view.

Cluster Overview Panel

CockroachDB Admin UI

The Cluster Overview panel provides the following metrics:

MetricDescription
Capacity Usage
- Used capacity: The storage capacity used by CockroachDB (represented as a percentage of total storage capacity allocated across all nodes).
- Usable capacity: The space available for CockroachDB data storage (i.e., the storage capacity of the machine excluding the capacity used by the Cockroach binary, operating system, and other system files).
Node Status
- The number of live nodes in the cluster.
- The number of suspect nodes in the cluster. A node is considered suspect if its liveness status is unavailable or the node is in the process of decommissioning.
- The number of dead nodes in the cluster.
Replication Status
- The total number of ranges in the cluster.
- The number of under-replicated ranges in the cluster. A non-zero number indicates an unstable cluster.
- The number of unavailable ranges in the cluster. A non-zero number indicates an unstable cluster.

Node List

The Node List is the default view on the Overview page.CockroachDB Admin UI

Live Nodes

Live nodes are nodes that are online and responding. They are marked with a green dot. If a node is removed or dies, the dot turns yellow to indicate that it is not responding. If the node remains unresponsive for a certain amount of time (5 minutes by default), the node turns red and is moved to the Dead Nodes section, indicating that it is no longer expected to come back.

The following details are shown for each live node:

ColumnDescription
IDThe ID of the node.
AddressThe address of the node. You can click on the address to view further details about the node.
UptimeHow long the node has been running.
ReplicasThe number of replicas on the node.
CPUsThe number of CPU cores on the machine.
Capacity UsageThe storage capacity used by CockroachDB as a percentage of the total usable capacity on the node. The value is represented numerically and as a bar graph.
Mem UsageThe memory used by CockroachDB as a percentage of the total memory on the node. The value is represented numerically and as a bar graph.
VersionThe build tag of the CockroachDB version installed on the node.
LogsClick Logs to see detailed logs for the node.

Dead Nodes

Nodes are considered dead once they have not responded for a certain amount of time (5 minutes by default). At this point, the automated repair process starts, wherein CockroachDB automatically rebalances replicas from the dead node, using the unaffected replicas as sources. See Stop a Node for more information.

The following details are shown for each dead node:

ColumnDescription
IDThe ID of the node.
AddressThe address of the node. You can click on the address to view further details about the node.
Down SinceHow long the node has been down.

Decommissioned Nodes

Nodes that have been decommissioned for permanent removal from the cluster are listed in the Decommissioned Nodes table.

When you decommission a node, CockroachDB lets the node finish in-flight requests, rejects any new requests, and transfers all range replicas and range leases off the node so that it can be safely shut down. See Remove Nodes for more information.

Node Map (Enterprise)

The Node Map is an enterprise-only feature that gives you a visual representation of the geographical configuration of your cluster.

CockroachDB Admin UI Summary Panel

The Node Map consists of the following components:

Region component

CockroachDB Admin UI Summary Panel

Note:

For multi-core systems, the user CPU percent can be greater than 100%. Full utilization of one core is considered as 100% CPU usage. If you have n cores, then the user CPU percent can range from 0% (indicating an idle system) to (n*100)% (indicating full utilization).

Node component

CockroachDB Admin UI Summary Panel

Note:

For multi-core systems, the user CPU percent can be greater than 100%. Full utilization of one core is considered as 100% CPU usage. If you have n cores, then the user CPU percent can range from 0% (indicating an idle system) to (n*100)% (indicating full utilization).

For guidance on enabling and using the node map, see Enable Node Map.

See also

Was this page helpful?
YesNo