docs: inputs: tail: document inotify queue overflow reconciliation

[eschabell]

• add "Inotify queue overflow handling" subsection describing automatic file reconciliation on IN_Q_OVERFLOW events, including rotation detection, truncate reset, and watch retry behavior

Note, for code change without corresponding docs PR.

Summary by CodeRabbit

• Documentation
  • Enhanced Tail input documentation with details on inotify queue overflow handling, including file monitoring reconciliation, rotation detection, offset resetting, and watch registration retries that prevent silent log loss during overflow events.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 58da4078-b07e-4c65-a7a5-6e93f8e8e983

📥 Commits

Reviewing files that changed from the base of the PR and between d3d0a7a and c1bf79c.

📒 Files selected for processing (1)

• pipeline/inputs/tail.md

---

📝 Walkthrough

Walkthrough

This PR adds a new documentation subsection to the Tail input guide explaining how Fluent Bit handles Linux inotify queue overflow events. The section details the reconciliation steps Tail performs: detecting file rotations, resetting offsets on truncation, and retrying failed watch registrations.

Changes

Documentation Update

Layer / File(s)	Summary
Inotify queue overflow handling documentation pipeline/inputs/tail.md	New subsection describes Tail's response to inotify IN_Q_OVERFLOW events, including file reconciliation logic (rotation detection via inode/filename, offset reset for truncated files, watch re-registration retry) and guidance to increase kernel limits to prevent overflows.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Suggested labels

5.0.5

Suggested reviewers

• cosmo0920
• alexakreizinger

Poem

🐰 A queue overflows, no logs shall hide,
With inodes checked and offsets tried,
The Tail watches true, recovering bright,
Documenting the overflow's fight! 📖✨

🚥 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 accurately describes the main change: documenting inotify queue overflow reconciliation in the tail input documentation.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
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.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

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 and usage tips.}

[eschabell]

@cosmo0920 can you please review?

[eschabell]

@coderabbitai review

[coderabbitai]

✅ Actions performed

Review triggered.

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.