nodetool getinterdcstreamthroughput
Displays the inter-datacenter stream throughput limit.
Synopsis
Section titled “Synopsis”nodetool [connection_options] getinterdcstreamthroughput [options]See connection options for connection options.
Options
Section titled “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 inter-DC throughput |
Description
Section titled “Description”nodetool getinterdcstreamthroughput shows the maximum throughput for streaming operations between datacenters. By default, the output is in megabits per second (Mb/s), not megabytes. This separate limit allows controlling bandwidth usage across potentially slower or more expensive WAN links.
Examples
Section titled “Examples”Basic Usage
Section titled “Basic Usage”nodetool getinterdcstreamthroughputSample Output
Section titled “Sample Output”Current inter-datacenter stream throughput: 100 Mb/sA value of unlimited indicates that the configured value is 0 or negative (no throttling).
Display in MiB/s
Section titled “Display in MiB/s”nodetool getinterdcstreamthroughput --mibConfiguration
Section titled “Configuration”The cassandra.yaml parameter name varies by version:
| Cassandra Version | Parameter Name | Example | Unit |
|---|---|---|---|
| Pre-4.1 | inter_dc_stream_throughput_outbound_megabits_per_sec | 100 | Megabits/s |
| 4.1+ | inter_dc_stream_throughput | 100Mb/s or 12MiB/s | Various |
# cassandra.yaml (4.1+)inter_dc_stream_throughput: 100Mb/s
# cassandra.yaml (Pre-4.1)# inter_dc_stream_throughput_outbound_megabits_per_sec: 100Use Cases
Section titled “Use Cases”Verify WAN Bandwidth Settings
Section titled “Verify WAN Bandwidth Settings”nodetool getinterdcstreamthroughputMulti-DC Operations
Section titled “Multi-DC Operations”# Check before cross-DC rebuildnodetool getinterdcstreamthroughputRelated Commands
Section titled “Related Commands”| Command | Relationship |
|---|---|
| setinterdcstreamthroughput | Modify throughput |
| getstreamthroughput | Intra-DC throughput |
| netstats | Monitor streaming |