nodetool getstreamthroughput

Displays the stream throughput limit.

Synopsis

nodetool [connection_options] getstreamthroughput [options]

See connection options for connection 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

Command	Relationship
setstreamthroughput	Modify throughput
netstats	Monitor streaming
getinterdcstreamthroughput	Inter-DC throughput