From 1ef6064e5d1a465ad7803d1ec8a6bfb7d85542ce Mon Sep 17 00:00:00 2001 From: npub1qyvc0c5kl4gqv2fd97fsk46tu378sqgy35vc83rvgfwne90sel7s0ed67d <011987e296fd5006292d2f930b574be47c7801048d1983c46c425d3c95f0cffd@buzz.block.builderlab.xyz> Date: Mon, 27 Jul 2026 23:05:10 -0400 Subject: [PATCH] docs(relay): honest tail wording for BUFFERED_LINES_LIMIT sizing comment MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Max's re-review nit: the comment claimed p99=641B, max=641B — but p99 equaling max in a 26k-line sample means the tail was clipped by the query, not observed, and 'worst-case' overstated what the sample proves. Say what was actually measured and that the budget has headroom for a fatter tail. Comment-only change. Co-authored-by: Tyler Longwell Signed-off-by: Tyler Longwell --- crates/buzz-relay/src/logging.rs | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/crates/buzz-relay/src/logging.rs b/crates/buzz-relay/src/logging.rs index 8879cb6a7..3840cacb8 100644 --- a/crates/buzz-relay/src/logging.rs +++ b/crates/buzz-relay/src/logging.rs @@ -27,10 +27,12 @@ use tracing_appender::non_blocking::{ErrorCounter, NonBlocking, NonBlockingBuild /// Bounded queue size, in lines. /// -/// Derived from measured production line sizes (bb-block fleet, 2026-07-28: -/// p50=248B, p99=641B, max=641B across 26k lines): 4096 × 641B ≈ 2.6MB -/// worst-case queue memory against a 2Gi pod limit, several minutes of -/// steady-state log volume. The buffer absorbs bursts; it is not sized to +/// Derived from measured production line sizes (bb-block fleet, 2026-07-28, +/// 26k-line sample: p50=248B, largest observed 641B — p99 equaled max in +/// that sample, so the true tail may be somewhat larger): 4096 × 641B ≈ +/// 2.6MB of queue memory against a 2Gi pod limit, several minutes of +/// steady-state log volume, with ample headroom for a fatter tail. The +/// buffer absorbs bursts; it is not sized to /// ride out a sustained copier outage — once the sink is stalled, preserving /// more backlog has diminishing value. ///