nodetool setbatchlogreplaythrottle¶
Sets the batchlog replay throttle in KB/s.
Synopsis¶
nodetool [connection_options] setbatchlogreplaythrottle <throttle_in_kb>
Description¶
nodetool setbatchlogreplaythrottle modifies the throttle rate for batchlog replay operations at runtime.
Arguments¶
| Argument | Description |
|---|---|
batchlog_replay_throttle |
Replay throttle in KiB/s. Set to 0 to disable throttling. |
Throttle Behavior
- Setting the value to 0 disables throttling entirely
- The effective throttle is proportionally reduced based on cluster size to prevent overwhelming recovered nodes during replay
cassandra.yaml Parameter
The corresponding cassandra.yaml parameter changed in 4.1:
| Cassandra Version | Parameter Name | Example |
|---|---|---|
| Pre-4.1 | batchlog_replay_throttle_in_kb |
1024 |
| 4.1+ | batchlog_replay_throttle |
1024KiB |
Examples¶
Set Throttle¶
nodetool setbatchlogreplaythrottle 2048
Increase for Faster Replay¶
nodetool setbatchlogreplaythrottle 4096
When to Use¶
Speed Up Batch Replay¶
# Increase for faster catchup
nodetool setbatchlogreplaythrottle 4096
nodetool replaybatchlog
Reduce Impact¶
# During high load
nodetool setbatchlogreplaythrottle 512
Disable Throttling¶
# Remove throttle limit (use with caution)
nodetool setbatchlogreplaythrottle 0
Related Commands¶
| Command | Relationship |
|---|---|
| getbatchlogreplaythrottle | View current throttle |
| replaybatchlog | Force replay |