Apache Cassandra™ Monitoring Cheatsheet

Note:
ʒ Depending on how you install Apache Cassandra, binaries may be located in the install directory
(e.g. ~/apache-cassandra-3.9/bin/nodetool) or in your /usr directory (e.g. /usr/bin/nodetool).
For simplicity, the following commands assume that your binaries are in a directory in your $PATH.
ʒ For more info, visit dtdg.co/monitoring-cassandra

Nodetool commands
General monitoring commands Compaction metrics—more info
METRIC DESCRIPTION COMMAND METRIC DESCRIPTION COMMAND
High-level status of cluster nodetool status Compactions in progess, pending compaction tasks nodetool compactionstats
Stats from a specific node nodetool --host <ip_address> info
Stats on all keyspaces and column families nodetool cfstats Thread pool metrics—more info
Stats from a specific keyspace nodetool cfstats <keyspace_name> METRIC DESCRIPTION COMMAND
Stats from a specific column family nodetool cfstats <keyspace_name>.<cf_name> Thread pool statistics, including pending tasks and blocked tasks nodetool tpstats

Garbage collection metrics—more info

METRIC DESCRIPTION COMMAND
Garbage collections (count and elapsed time) nodetool gcstats

JMX metrics via JConsole

Note: The JConsole graphical utility can be found in <jdk_install_dir>/bin. You can open it simply by running jconsole
if that directory is in your $PATH.

Query performance—more info Garbage collections—more info

METRIC DESCRIPTION JMX PATH ATTRIBUTE METRIC DESCRIPTION JMX PATH ATTRIBUTE
Reads per second org.apache.cassandra.metrics: OneMinuteRate ParNew GCs java.lang: CollectionCount
(avg over previous min) type=ClientRequest,scope=Read,name=Latency (count) type=GarbageCollector,name=ParNew
Writes per second org.apache.cassandra.metrics: OneMinuteRate ParNew GCs java.lang: CollectionTime
(avg over previous min) type=ClientRequest,scope=Write,name=Latency (total elapsed time in ms) type=GarbageCollector,name=ParNew
Reads org.apache.cassandra.metrics: Count CMS GCs java.lang: CollectionCount
(total count) type=ClientRequest,scope=Read,name=Latency (count) type=GarbageCollector,name=ConcurrentMarkSweep
Writes org.apache.cassandra.metrics: Count CMS GCs java.lang: CollectionTime
(total count) type=ClientRequest,scope=Write,name=Latency (total elapsed time in ms) type=GarbageCollector,name=ConcurrentMarkSweep
Read latency org.apache.cassandra.metrics: Count
(total elapsed time in μs) type=ClientRequest,scope=Read,name=TotalLatency
Write latency org.apache.cassandra.metrics: Count
Exceptions—more info
(total elapsed time in μs) type=ClientRequest,scope=Write,name=TotalLatency METRIC DESCRIPTION JMX PATH ATTRIBUTE
Key cache org.apache.cassandra.metrics: Count Total exceptions org.apache.cassandra.metrics: Count
(hits) type=Cache,scope=KeyCache,name=Hits type=Storage,name=Exceptions
Key cache org.apache.cassandra.metrics: Count Timeouts (reads) org.apache.cassandra.metrics: Count
(total requests) type=Cache,scope=KeyCache,name=Requests type=ClientRequest,scope=Read,name=Timeouts

Timeouts (writes) org.apache.cassandra.metrics: Count

type=ClientRequest,scope=Write,name=Timeouts
Disk usage—more info
METRIC DESCRIPTION JMX PATH ATTRIBUTE Unavailable exceptions org.apache.cassandra.metrics: Count
(reads) type=ClientRequest,scope=Read,name=Unavailables
Disk used on a node (bytes) org.apache.cassandra.metrics: Count
type=Storage,name=Load Unavailable exceptions org.apache.cassandra.metrics: Count
(writes) type=ClientRequest,scope=Write,name=Unavailables
Disk used by a column family org.apache.cassandra.metrics: Count
(bytes) type=ColumnFamily,keyspace=<keyspace_name>,
scope=<cf_name>,name=TotalDiskSpaceUsed
Completed compaction tasks org.apache.cassandra.metrics: Value
Default directories
type=Compaction,name=CompletedTasks PACKAGE INSTALL TARBALL INSTALL
Pending compaction tasks org.apache.cassandra.metrics: Value Configuration files /etc/cassandra <install_dir>/conf
type=Compaction,name=PendingTasks
cassandra.in.sh /usr/share/cassandra <install_dir>/bin
(sets environment variables)
Logs /var/log/cassandra <install_dir>/logs
Data and commit log /var/lib/cassandra <install_dir>/data