docs: pipeline: filters: kubernetes: document internal log enrichment

[eschabell]

Document that the filter enriches records from the fluentbit_logs input with the local Fluent Bit Pod's metadata (namespace from kube_namespace_file, Pod name from HOSTNAME) instead of querying the Kubernetes API server.

Note this update due to code change without matching docs PR.

Summary by CodeRabbit

• Documentation
  • Added guidance for enriching Fluent Bit internal logs with Kubernetes metadata.
  • Clarified how the local Pod namespace and name are detected for attaching metadata to diagnostic logs.

[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: f3f65dd5-3494-4312-9a60-03b270fcfa55

📥 Commits

Reviewing files that changed from the base of the PR and between 8892466 and 82672e4.

📒 Files selected for processing (1)

• pipeline/filters/kubernetes.md

---

📝 Walkthrough

Walkthrough

This PR adds a documentation subsection to the Kubernetes filter page describing how the filter enriches Fluent Bit's own internal logs (from the fluentbit_logs input plugin) using local Pod metadata, without querying the Kubernetes API server.

Changes

Kubernetes filter docs

Layer / File(s)	Summary
Document internal log enrichment behavior pipeline/filters/kubernetes.md	New subsection explains namespace is read from kube_namespace_file and Pod name from HOSTNAME (or system hostname fallback), avoiding Kubernetes API server calls for fluentbit_logs input records.

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

Related Issues

None mentioned.

Related PRs

None mentioned.

Suggested labels: documentation

Suggested reviewers: None identified.

Poem
A rabbit hops through docs so neat,
Explaining logs from Fluent's feet,
No API call, just hostname's trace,
Metadata found in the local place. 🐇📄

🚥 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 matches the docs update about Kubernetes filter internal log enrichment.
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.

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

[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!