nodetool getstreamthroughput¶
Displays the stream throughput limit.
Synopsis¶
nodetool [connection_options] getstreamthroughput [options]
Options¶
| Option | Description |
|---|---|
-m, --mib |
Display throughput in MiB/s instead of Mb/s |
-d, --precise-mbit |
Display precise Mb/s value as a decimal |
-e, --entire-sstable-throughput |
Show entire SSTable streaming throughput instead of standard streaming throughput |
Description¶
nodetool getstreamthroughput shows the current maximum throughput for streaming operations such as bootstrap, rebuild, and repair. By default, the output is in megabits per second (Mb/s), not megabytes. This limit controls how fast data is transferred between nodes.
Examples¶
Basic Usage¶
nodetool getstreamthroughput
Sample Output¶
Current stream throughput: 200 Mb/s
A value of unlimited indicates that the configured value is 0 or negative (no throttling).
Display in MiB/s¶
nodetool getstreamthroughput --mib
Configuration¶
The cassandra.yaml parameter name varies by version:
| Cassandra Version | Parameter Name | Example | Unit |
|---|---|---|---|
| Pre-4.1 | stream_throughput_outbound_megabits_per_sec |
200 |
Megabits/s |
| 4.1+ | stream_throughput |
200Mb/s or 24MiB/s |
Various |
# cassandra.yaml (4.1+)
stream_throughput: 200Mb/s
# cassandra.yaml (Pre-4.1)
# stream_throughput_outbound_megabits_per_sec: 200
Use Cases¶
Verify Configuration¶
nodetool getstreamthroughput
Before Streaming Operations¶
# Check throughput before bootstrap
nodetool getstreamthroughput
Related Commands¶
| Command | Relationship |
|---|---|
| setstreamthroughput | Modify throughput |
| netstats | Monitor streaming |
| getinterdcstreamthroughput | Inter-DC throughput |