Skip to content

cmds: document why QPS/Burst defaults are intentionally huge#83

Merged
tamalsaha merged 1 commit into
masterfrom
docs/qps-burst-comment
Jun 6, 2026
Merged

cmds: document why QPS/Burst defaults are intentionally huge#83
tamalsaha merged 1 commit into
masterfrom
docs/qps-burst-comment

Conversation

@tamalsaha

Copy link
Copy Markdown
Contributor

Summary

`QPS=1e6 / Burst=1e6` looks like an accident on first read. It isn't — reads go through the cache, so the rate limit only ever applies to writes (status patches, finalizer updates), and throttling those just adds cold-start / leader-handoff latency. Add a comment so the next reader doesn't "fix" them.

Test plan

  • `go build ./...`

QPS=1e6 / Burst=1e6 look like an accident. They are not — reads go
through the controller-runtime cache, so the practical rate limit only
applies to writes (status patches, finalizer updates), and throttling
those just adds cold-start / leader-handoff latency. Spell that out in
a comment so the next reader doesn't "fix" them.

Signed-off-by: Tamal Saha <tamal@appscode.com>
@tamalsaha tamalsaha merged commit aadc023 into master Jun 6, 2026
4 checks passed
@tamalsaha tamalsaha deleted the docs/qps-burst-comment branch June 6, 2026 15:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant