docs: administration: backpressure: document flush requests in flight limit

[eschabell]

• Document the flush requests in flight limit and its platform defaults
• Document that tasks over the limit are deferred to the next flush cycle
• Document the debug message and that the limit isn't configurable

Signed-off-by: Eric D. Schabell eric@schabell.org

Summary by CodeRabbit

• Documentation
  • Documented the limit on concurrent in-flight flush requests in Fluent Bit 5.1.3 and later.
  • Clarified that excess tasks remain queued for a later flush cycle, with a debug message when they are deferred. On Linux, startup may lower the limit based on engine channel capacity.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

• Configuration used: defaults
• Review profile: CHILL
• Plan: Advanced
• Run ID: 4095f651-a203-4dcd-97d1-3880627602d8

📥 Commits

Reviewing files that changed from the base of the PR and between e586da8 and 6cc02f3.

📒 Files selected for processing (1)

• administration/backpressure.md

Included review availability: This review used your included allowance. Your plan provides up to 2 included reviews per hour; 0 remain after this review.

---

📝 Walkthrough

Walkthrough

The documentation describes in-flight flush request limits for Fluent Bit 5.1.3 and later. It covers platform-specific defaults, deferred queued tasks, the debug message, and a possible Linux startup adjustment.

Changes

Flush Backpressure

Layer / File(s)	Summary
Document flush request limits administration/backpressure.md	Documents the platform-specific in-flight request limits. When a limit is reached, queued tasks wait for the next flush cycle rather than being dropped. The documentation also notes the debug message, that the limit is not configurable, and that Linux startup may lower it when engine channel capacity is small.

Priority: ⬇️ Low

Estimated code review effort: 1 (Trivial) | ~4 minutes

Change: Other

Merge Risk: ⚪ Minimal · up to 6cc02

This documentation-only change matches the implementation on the documented defaults and the deferral behavior. It is low risk to merge. The remaining wording nuances are optional.

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly describes the main change: documenting the limit on in-flight flush requests.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Analyzed 0 functions across 0…
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create a new PR

• Autopilot · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[eschabell]

@coderabbitai review

[coderabbitai]

✅ Action performed

Review finished.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

[eschabell]

@patrick-stephens ready for review!