Skip to content

AxonOps — AI-Native Control Plane for Open Source Data Platforms

Cassandra MBeans Reference

This section provides detailed documentation for all major MBeans exposed by Apache Cassandra. Each MBean includes attributes, operations, and practical examples.

MBeanDomainPurpose
StorageServiceMBeano.a.c.dbCore cluster operations
StorageProxyMBeano.a.c.dbRequest coordination
CompactionManagerMBeano.a.c.dbCompaction control
ColumnFamilyStoreMBeano.a.c.dbTable operations
GossiperMBeano.a.c.gmsGossip protocol
StreamManagerMBeano.a.c.streamingData streaming
CacheServiceMBeano.a.c.dbCache management
CommitLogMBeano.a.c.dbCommit log
HintedHandoffManagerMBeano.a.c.dbHint delivery
MessagingServiceMBeano.a.c.netInter-node messaging
EndpointSnitchMBeano.a.c.locatorTopology
FailureDetectorMBeano.a.c.gmsNode detection

ObjectName: org.apache.cassandra.db:type=StorageService

The primary MBean for cluster-level operations. Controls node lifecycle, topology changes, and cluster-wide operations.

AttributeTypeDescription
LiveNodesListIP addresses of live nodes
UnreachableNodesListIP addresses of unreachable nodes
JoiningNodesListNodes currently joining
LeavingNodesListNodes currently leaving
MovingNodesListNodes currently moving
OperationModeStringSTARTING, NORMAL, JOINING, LEAVING, etc.
ClusterNameStringCluster name
LocalHostIdStringUUID of this node
TokensListTokens owned by this node
ReleaseVersionStringCassandra version
SchemaVersionUUIDCurrent schema version
KeyspacesListAll keyspace names
NativeTransportRunningbooleanCQL port status
GossipRunningbooleanGossip status
InitializedbooleanNode initialized
OperationParametersDescription
forceKeyspaceFlushkeyspaceFlush memtables to disk
forceKeyspaceCompactionkeyspaceTrigger major compaction
takeSnapshottag, keyspacesCreate snapshot
clearSnapshottag, keyspacesRemove snapshot
repairkeyspace, optionsStart repair
decommission-Remove node from cluster
movenewTokenMove node to new token
removeNodehostIdForce remove dead node
assassinateaddressRemove via gossip
drain-Flush and stop accepting writes
truncatekeyspace, tableTruncate table
refreshSizeEstimates-Update size estimates
nodetool CommandJMX Operation
nodetool statusgetLiveNodes(), getUnreachableNodes()
nodetool flushforceKeyspaceFlush()
nodetool compactforceKeyspaceCompaction()
nodetool snapshottakeSnapshot()
nodetool repairrepair()
nodetool decommissiondecommission()
nodetool draindrain()
nodetool infoVarious attributes
ObjectName ssBean = new ObjectName("org.apache.cassandra.db:type=StorageService");
// Get live nodes
List<String> liveNodes = (List<String>) mbsc.getAttribute(ssBean, "LiveNodes");
System.out.println("Live nodes: " + liveNodes);
// Get operation mode
String mode = (String) mbsc.getAttribute(ssBean, "OperationMode");
System.out.println("Mode: " + mode);
// Get cluster name
String cluster = (String) mbsc.getAttribute(ssBean, "ClusterName");
System.out.println("Cluster: " + cluster);

ObjectName: org.apache.cassandra.db:type=StorageProxy

Controls request coordination settings including timeouts and consistency behavior.

AttributeTypeDescription
TotalHintslongTotal hints stored
HintsInProgressintHints currently being delivered
ReadRepairAttemptedlongRead repair attempts
ReadRepairRepairedBlockinglongBlocking read repairs
ReadRepairRepairedBackgroundlongBackground read repairs
SchemaVersionsMapSchema versions per node
AttributeTypeDefaultDescription
RpcTimeoutlong10000msGeneral RPC timeout
ReadRpcTimeoutlong5000msRead timeout
WriteRpcTimeoutlong2000msWrite timeout
RangeRpcTimeoutlong10000msRange query timeout
CounterWriteRpcTimeoutlong5000msCounter write timeout
TruncateRpcTimeoutlong60000msTruncate timeout
OperationDescription
setRpcTimeoutSet general timeout
setReadRpcTimeoutSet read timeout
setWriteRpcTimeoutSet write timeout
reloadTriggerClassesReload trigger classes

ObjectName: org.apache.cassandra.db:type=CompactionManager

Controls compaction operations and provides compaction statistics.

AttributeTypeDescription
PendingTasksintPending compaction tasks
CompletedTaskslongCompleted compactions
CompactionsListCurrently running compactions
PendingTasksByTableNameMapPending tasks per table
OperationParametersDescription
forceUserDefinedCompactionks, table, filesCompact specific SSTables
stopCompactiontypeStop compaction by type
stopCompactionByIdcompactionIdStop specific compaction
setConcurrentCompactorsvalueSet parallel compactors
getConcurrentCompactors-Get parallel compactor count
setCompactionThroughputmbPerSecSet throughput limit
getCompactionThroughput-Get throughput limit
nodetool CommandJMX Operation
nodetool compactionstatsgetCompactions(), getPendingTasks()
nodetool setcompactionthroughputsetCompactionThroughput()
nodetool stop COMPACTIONstopCompaction()
ObjectName cmBean = new ObjectName("org.apache.cassandra.db:type=CompactionManager");
// Get pending compactions
int pending = (int) mbsc.getAttribute(cmBean, "PendingTasks");
System.out.println("Pending compactions: " + pending);
// Get active compactions
List<Map<String, String>> compactions =
(List<Map<String, String>>) mbsc.getAttribute(cmBean, "Compactions");
for (Map<String, String> c : compactions) {
System.out.println("Compacting: " + c.get("keyspace") + "." + c.get("columnfamily"));
System.out.println(" Progress: " + c.get("progress") + "%");
}

ObjectName: org.apache.cassandra.db:type=ColumnFamilies,keyspace={ks},columnfamily={table}

Per-table operations and statistics.

AttributeTypeDescription
LiveSSTableCountintNumber of live SSTables
LiveDiskSpaceUsedlongDisk space used (bytes)
TotalDiskSpaceUsedlongTotal disk space
MemtableColumnsCountlongColumns in memtable
MemtableSwitchCountintMemtable flush count
MemtableLiveDataSizelongMemtable data size
BloomFilterFalsePositiveslongBloom filter false positives
BloomFilterFalseRatiodoubleFalse positive ratio
MeanPartitionSizelongAverage partition size
MaxPartitionSizelongMaximum partition size
CompressionRatiodoubleCompression ratio
SSTablesPerReadHistogramlong[]SSTables accessed per read
OperationDescription
forceFlushFlush memtable
forceCompactionForTokenRangeCompact token range
estimateKeysEstimate key count
loadNewSSTablesLoad new SSTables from disk
setCompactionStrategyClassChange compaction strategy
setCompactionThresholdsSet min/max thresholds

ObjectName: org.apache.cassandra.gms:type=Gossiper

Gossip protocol management.

AttributeTypeDescription
EndpointStatesMapState of all known endpoints
DownEndpointsSetDown endpoints
OperationDescription
assassinateEndpointRemove endpoint via gossip
unsafeAssassinateEndpointForce assassinate
getCurrentGenerationNumberGet gossip generation
getEndpointDowntimeGet endpoint downtime

ObjectName: org.apache.cassandra.net:type=MessagingService

Inter-node messaging statistics.

AttributeTypeDescription
DroppedMessagesMapDropped messages by type
RecentlyDroppedMessagesMapRecently dropped messages
TimeoutsPerHostMapTimeouts per remote host
TypeDescription
MUTATIONWrite requests
READRead requests
READ_REPAIRRead repair requests
REQUEST_RESPONSEResponses
RANGE_SLICERange query requests
PAGED_RANGEPaged range requests
COUNTER_MUTATIONCounter writes
HINTHint delivery
ObjectName msBean = new ObjectName("org.apache.cassandra.net:type=MessagingService");
Map<String, Integer> dropped =
(Map<String, Integer>) mbsc.getAttribute(msBean, "DroppedMessages");
for (Map.Entry<String, Integer> entry : dropped.entrySet()) {
if (entry.getValue() > 0) {
System.out.println("WARNING: " + entry.getValue() +
" dropped " + entry.getKey() + " messages");
}
}

ObjectName: org.apache.cassandra.db:type=Caches

Cache management and statistics.

AttributeTypeDescription
KeyCacheCapacityInByteslongKey cache size
KeyCacheSizelongKeys in cache
KeyCacheHitslongCache hits
KeyCacheMisseslongCache misses
KeyCacheRecentHitRatedoubleRecent hit rate
RowCacheCapacityInByteslongRow cache size
RowCacheSizelongRows in cache
RowCacheHitslongCache hits
RowCacheMisseslongCache misses
RowCacheRecentHitRatedoubleRecent hit rate
OperationDescription
invalidateKeyCacheClear key cache
invalidateRowCacheClear row cache
setKeyCacheCapacitySet key cache size
setRowCacheCapacitySet row cache size
saveCachesPersist caches to disk

ObjectName: org.apache.cassandra.db:type=Commitlog

AttributeDescription
CompletedTasksCompleted commit log tasks
PendingTasksPending tasks
TotalCommitLogSizeTotal commit log size
ActiveSegmentCountActive segments

ObjectName: org.apache.cassandra.db:type=HintedHandoffManager

AttributeDescription
StoredHintsTotal stored hints
EndpointsWithPendingHintsEndpoints waiting for hints

ObjectName: org.apache.cassandra.streaming:type=StreamManager

AttributeDescription
CurrentStreamsActive streams

ObjectName: org.apache.cassandra.locator:type=EndpointSnitchInfo

AttributeDescription
SnitchNameActive snitch class
DatacenterLocal datacenter
RackLocal rack

ObjectName: org.apache.cassandra.gms:type=FailureDetector

Monitors node availability using the Phi Accrual failure detector algorithm.

AttributeDescription
AllEndpointStatesState information for all known endpoints
SimpleStatesSimplified UP/DOWN status for endpoints
PhiValuesCurrent phi values for each endpoint
OperationDescription
getEndpointState(String)Get gossip state for specific endpoint
forceConviction(String)Force mark endpoint as down