Skip to content

docs: correct the S3 flush cadence in README (5 minutes → 60s) - #140

Merged
cboettig merged 1 commit into
mainfrom
fix/flush-cadence-doc
Aug 20, 2026
Merged

cboettig merged 1 commit into
mainfrom
fix/flush-cadence-doc

Conversation

@cboettig

Copy link
Copy Markdown
Member

README said logs flush to S3 "every 5 minutes". _FLUSH_INTERVAL defaults to 60 seconds (llm_proxy.py:30) and no manifest overrides it, so 60s is what actually runs in both deployments.

LOGGING.md already said 60s in two places, so the two docs contradicted each other — and the wrong one was in the more-read file.

Why it is worth fixing rather than leaving: the figure sets how stale the freshest S3 data can be, so a 5x overstatement makes a gap look like missing data rather than a buffer that has not flushed yet. That is a live concern for anyone doing the log analysis this repo is built around.

Also names the env var, so the number is traceable instead of another bare literal (same failure mode as the 300s in #138), and records the shutdown flush — lifespan calls _flush_to_s3() on exit, which is what makes a graceful restart safe mid-session.

Docs-only; python test_logging.py exits 0.

README said logs flush to S3 "every 5 minutes". `_FLUSH_INTERVAL` defaults to
60 seconds and no manifest overrides it, so 60s is what actually runs in both
deployments. LOGGING.md already said 60s, so the two docs contradicted each
other and the wrong one was in the more-read file.

The figure matters for log analysis: it sets how stale the freshest S3 data can
be, and a 5x overstatement makes a gap look like missing data rather than a
buffer not yet flushed. Names the env var so the number is traceable rather than
another bare literal, and records the shutdown flush — relevant when deciding
whether a restart is safe mid-session.
@cboettig
cboettig merged commit 0420160 into main Aug 20, 2026
1 check passed
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