Skip to content

Document the storage.backlog.flush_on_shutdown Fluent Bit buffer option - #344

Merged
csatib02 merged 1 commit into
kube-logging:masterfrom
Promptless:promptless/fluentbit-storage-backlog-flush-on-shutdown
Sep 7, 2026
Merged

csatib02 merged 1 commit into
kube-logging:masterfrom
Promptless:promptless/fluentbit-storage-backlog-flush-on-shutdown

Conversation

@promptless-for-oss

Copy link
Copy Markdown
Contributor

Open this suggestion in Promptless to view citations and reasoning process

Fluent Bit can now flush filesystem-backlog chunks to their destination during a graceful shutdown through the new opt-in storage.backlog.flush_on_shutdown field on the BufferStorage spec. Without it, buffered records are lost when a node is drained or a spot instance is reclaimed.

This adds a "Flush the filesystem buffer on shutdown" subsection to the Buffering section of the Fluent Bit log collector page (content/docs/logging-infrastructure/fluentbit.md). It explains the option, its On/Off values and Off default, the filesystem-buffering prerequisite, and a FluentbitAgent example, and cross-references terminationGracePeriodSeconds so the pod has time to finish flushing. The generated CRD reference page picks up the field automatically on the next upstream sync, so it is intentionally left untouched here.

Trigger Events

Add a Buffering subsection covering the new opt-in BufferStorage option
that flushes filesystem-backlog chunks on graceful shutdown, avoiding
buffered-record loss on node drain or spot reclaim (logging-operator #2282).
@csatib02
csatib02 requested a review from fekete-robert July 31, 2026 18:45
@csatib02
csatib02 marked this pull request as ready for review July 31, 2026 18:45
@promptless-for-oss

Copy link
Copy Markdown
Contributor Author

Just a reminder: I review PR comments by default. If you want me to ignore a specific comment, start it with aside or /aside.

@csatib02
csatib02 merged commit 9c06ccd into kube-logging:master Sep 7, 2026
2 checks passed
@promptless-for-oss
promptless-for-oss deleted the promptless/fluentbit-storage-backlog-flush-on-shutdown branch September 7, 2026 08:28
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.

2 participants