Skip to content

refactor(zingod-grpc): one adaptive work limit governs load - #21

Open
elicbarbieri wants to merge 5 commits into
mainfrom
feat/admission-overload
Open

elicbarbieri wants to merge 5 commits into
mainfrom
feat/admission-overload

Conversation

@elicbarbieri

@elicbarbieri elicbarbieri commented Nov 12, 2026 •

Copy link
Copy Markdown
Collaborator

one load authority: the adaptive work-stream limit; every fixed cap & signal that duplicated it is gone.

What it does

  • overload
    • latch = work refused at the adaptive limit (>= 10% at >= 1/s for 5 min in, < 2% for 5 min out), no other signal
    • cpu / io saturation reach it as latency → lower limit, so the linux psi readers go
    • /readyz message Overloaded: refusing work; metric zingod_grpc_overloaded
  • removed
    • pressure.rs, OverloadCause, OverloadLimits, [grpc.overload], zingod overload & its markers
    • [grpc] adaptive_work_streams: gradient2 always on, max_work_streams = its ceiling
    • read lanes (read_lanes.rs, max_point/range/scan_reads, disk_read_wait_seconds): one routes::blocking, reads bounded by the work limit they run in
    • subscription pool (Class, max_subscriptions, its metrics): GetMempoolStream takes no slot, connection caps bound it
    • silence timeout (silent_timeout_secs): deadline.rs = client grpc-timeout only
  • serving log
    • Serving = rps, conns, refused, failed; first failure per minute = Request failed; summary.rs 202 → 80 lines
  • docs
    • new operators page dos-protection.md: every limit in the order a request meets it, the adaptive limit, overload, what to watch, the shared-pool gap (one address can fill the work pool, rate-limit per ip at the edge)
    • origin policy & open files move there from network.md; overload out of maintenance.md
    • operators order: network exposure → dos protection → monitoring → maintenance
  • changeset (minor, as 1.1.0's config breaks): every removed key, command & metric listed

stacked on #19 (book); retarget once it lands.

🤖 Generated with Claude Code

@elicbarbieri elicbarbieri changed the title refactor(zingod-grpc): overload = admission refusing work, one dos protection page refactor(zingod-grpc): one adaptive work limit governs load Nov 12, 2026
@elicbarbieri
elicbarbieri added this pull request to stack #20 November 12, 2026 22:43
@elicbarbieri
elicbarbieri force-pushed the feat/admission-overload branch from 251be59 to 3c7eac5 Compare November 12, 2026 22:45
Base automatically changed from docs/book to main November 12, 2026 22:51
elicbarbieri and others added 5 commits November 12, 2026 14:51
…imit always on

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…imeout; slim serving log

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…eside admit

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@elicbarbieri
elicbarbieri force-pushed the feat/admission-overload branch from 3c7eac5 to 72ed60c Compare November 12, 2026 22:51

This branch has not been deployed

No deployments
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