nodetool ring

Provides node status and information about the ring.


nodetool <options> ring ( -r | --resolve-ip ) -- <keyspace>

Tarball and Installer No-Services path:

Connection options
Short Long Description



Hostname or IP address.



Port number.



Password file path.






Remote JMX agent username.



Provide node names instead of IP addresses.


Name of keyspace.


Separates an option from an argument that could be mistaken for an option.


Displays node status and information about the ring as determined by the node being queried. This information can give you an idea of the load balance and if any nodes are down. If your cluster is not properly configured, different nodes may show a different ring. Check that the node appears the same way in the ring. If you use virtual nodes (vnodes), use nodetool status for succinct output.


The node’s URL.

DC (datacenter)

The datacenter containing the node.


The rack or, in the case of Amazon EC2, the availability zone of the node.

Status - Up or Down

Indicates whether the node is functioning or not.

State - N (normal), L (leaving), J (joining), M (moving)

The state of the node in relation to the cluster.

Load - updates every 90 seconds

The amount of file system data under the cassandra data directory after excluding all content in the snapshots subdirectories. Because all SSTable data files are included, any data that is not cleaned up, such as TTL-expired cell or tombstoned data, is counted.


The end of the token range up to and including the value listed. For an explanation of token ranges, see Data distribution overview.


The percentage of the data owned by the node per datacenter times the replication factor. For example, a node can own 33% of the ring, but show 100% if the replication factor is 3.

Host ID

The network ID of the node.

Was this helpful?

Give Feedback

How can we improve the documentation?

© 2024 DataStax | Privacy policy | Terms of use

Apache, Apache Cassandra, Cassandra, Apache Tomcat, Tomcat, Apache Lucene, Apache Solr, Apache Hadoop, Hadoop, Apache Pulsar, Pulsar, Apache Spark, Spark, Apache TinkerPop, TinkerPop, Apache Kafka and Kafka are either registered trademarks or trademarks of the Apache Software Foundation or its subsidiaries in Canada, the United States and/or other countries. Kubernetes is the registered trademark of the Linux Foundation.

General Inquiries: +1 (650) 389-6000,