Skip to content

admission: export bypassed requests as a metric#171657

Open
shreyasganesh0 wants to merge 1 commit into
cockroachdb:masterfrom
shreyasganesh0:admission/export-bypassed-requests-metric
Open

admission: export bypassed requests as a metric#171657
shreyasganesh0 wants to merge 1 commit into
cockroachdb:masterfrom
shreyasganesh0:admission/export-bypassed-requests-metric

Conversation

@shreyasganesh0

Copy link
Copy Markdown

The IO load listener logs the per-interval count of requests that bypass admission control (below-raft writes that were not subject to replication admission control) in its [accounting] log line, but this count was never exported as a metric. Operators investigating overload escalations had to read logs to find it. The existing admission.granter.io_tokens_bypassed.kv counter tracks bypassed tokens, not the request count.

This adds an admission.granter.bypassed_requests.kv counter, incremented every adjustment interval with the same per-interval bypassed-request count that is logged. A growing value indicates replication writes from nodes that do not have replication admission control enabled, which is a useful signal that a version upgrade would relieve the overload.

Open question (carried over from the issue): aggregate request count only, or would you also like the bypassed write/ingest bytes exported alongside? Happy to add that if wanted.

Epic: none
Fixes: #137408

The IO load listener logs the per-interval count of requests that bypass
admission control (below-raft writes that were not subject to replication
admission control) in its [accounting] log line, but this count was never
exported as a metric. Operators investigating overload escalations had to
read logs to find it. The existing admission.granter.io_tokens_bypassed.kv
counter tracks bypassed tokens, not the request count.

Add an admission.granter.bypassed_requests.kv counter, incremented every
adjustment interval with the same per-interval bypassed-request count that
is logged. A growing value indicates replication writes from nodes that do
not have replication admission control enabled, which is a useful signal
that a version upgrade would relieve the overload.

Epic: none
Fixes: cockroachdb#137408
Release note (ops change): Added the admission.granter.bypassed_requests.kv
metric, which counts requests that bypassed admission control (for example,
below-raft writes not subject to replication admission control).
@shreyasganesh0 shreyasganesh0 requested a review from a team as a code owner June 14, 2026 18:47
@blathers-crl

blathers-crl Bot commented Jun 14, 2026

Copy link
Copy Markdown

Thank you for contributing to CockroachDB. Please ensure you have followed the guidelines for creating a PR.

My owl senses detect your PR is good for review. Please keep an eye out for any test failures in CI.

🦉 Hoot! I am a Blathers, a bot for CockroachDB. My owner is dev-inf.

@blathers-crl blathers-crl Bot added the O-community Originated from the community label Jun 14, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

O-community Originated from the community

Projects

None yet

Development

Successfully merging this pull request may close these issues.

admission: export bypassed requests as metric

1 participant