pipeline: inputs: systemd: document FLUENT_BIT_PARSER per-unit parser

[nourdouf]

Summary

Documents the new in_systemd capability to select a parser at runtime, per journal entry, via the FLUENT_BIT_PARSER field. This can be advertised from a systemd unit with:

[Service]
LogExtraFields=FLUENT_BIT_PARSER=logfmt

When present, the plugin applies the named parser to the entry's MESSAGE field and emits structured fields instead of the raw message. The doc covers behavior (metadata field stripped, MESSAGE-only parsing, graceful fallback when the parser is missing or parsing fails, per-entry resolution) and includes a logfmt example.

Related

Documentation for code PR fluent/fluent-bit#11353 (adds FLUENT_BIT_PARSER support to the systemd input).

---

Fluent Bit is licensed under Apache 2.0.

Summary by CodeRabbit

• Documentation
  • Added guidance for selecting parsers per Systemd journal entry at runtime.
  • Documented configuration examples for YAML and classic conf formats.
  • Clarified parser behavior, including fallback handling, metadata processing, and per-entry resolution.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 7eb4aa7b-1cd4-4cc3-80f3-424874f7d35e

📥 Commits

Reviewing files that changed from the base of the PR and between 52b504e and 0c302db.

📒 Files selected for processing (1)

• pipeline/inputs/systemd.md

Included review availability: Your plan provides up to 2 included reviews per hour; 1 remains after this review.

---

📝 Walkthrough

Walkthrough

The Systemd input documentation adds per-entry parser selection through the FLUENT_BIT_PARSER journal field. It documents metadata handling, fallback behavior, per-entry resolution, and YAML and conf configuration examples.

Changes

Systemd parser documentation

Layer / File(s)	Summary
Document per-unit parser selection pipeline/inputs/systemd.md	Adds behavior notes and configuration examples for selecting parsers with FLUENT_BIT_PARSER and LogExtraFields.

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

Merge Risk: ⚪ Minimal · up to 0c302

This documentation-only change explains per-unit parser selection for systemd input behavior; no actionable merge-blocking risk remains after normal checks and review.

Suggested reviewers: eschabell, patrick-stephens

🚥 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 identifies the documentation update for the Systemd input and the FLUENT_BIT_PARSER per-unit parser capability.
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.

Full details: Docstring Coverage

Explanation

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 files. (1 skipped: 1 unsupported.)

✨ 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.}