docs(relay): honest tail wording for BUFFERED_LINES_LIMIT sizing comment

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 <tlongwell@block.xyz>
Signed-off-by: Tyler Longwell <tlongwell@block.xyz>
This commit is contained in:
npub1qyvc0c5kl4gqv2fd97fsk46tu378sqgy35vc83rvgfwne90sel7s0ed67d
2026-07-27 23:05:10 -04:00
co-authored by Tyler Longwell
parent e1a8103715
commit 1ef6064e5d
+6 -4
View File
@@ -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.
///