Guides
Configuration
The settings that most affect behavior, throughput, and operational cost.
Most applications only need to think about a handful of settings.
The important knobs
| Setting | What it changes |
|---|---|
window_size_seconds | how much recent history is considered |
rate_group_size_ms | precision versus overhead inside the sliding window |
hard_limit_factor | how much burst headroom suppressed mode allows |
suppression_factor_cache_ms | how often suppression is recomputed |
sync_interval_ms | hybrid-only Redis sync cadence |
Recommended way to tune
- Pick the provider based on deployment shape.
- Pick the strategy based on failure behavior.
- Start with defaults or near-defaults.
- Tune only the setting tied to the pain you are seeing.
Common adjustments
- Increase
window_size_secondswhen the policy should smooth over a longer horizon. - Reduce
rate_group_size_mswhen you need finer timing or sharper retry hints. - Raise
hard_limit_factorwhen suppressed mode is becoming too aggressive too early. - Lower
sync_interval_mswhen hybrid lag is too visible.
What not to do
- Do not let cooperating Redis-backed instances use different limiter settings for the same namespace.
- Do not tune every knob at once; it becomes hard to understand what improved or regressed.