From 3c57eebab66dbc681d888dfd540a8c6ce88c9686 Mon Sep 17 00:00:00 2001 From: "promptless[bot]" Date: Mon, 11 May 2026 17:07:12 +0000 Subject: [PATCH] Document Retain_Metadata_In_Forward_Mode field in ForwardOptions Add documentation for the new Retain_Metadata_In_Forward_Mode configuration option introduced in fluent-bit 5.0.4. This field controls whether fluent-bit appends log event metadata when forwarding records, and the operator defaults it to false to maintain compatibility with fluentd. --- .../docs/configuration/crds/v1beta1/fluentbit_types.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/content/docs/configuration/crds/v1beta1/fluentbit_types.md b/content/docs/configuration/crds/v1beta1/fluentbit_types.md index b3db4386bd..1d5f987fb7 100644 --- a/content/docs/configuration/crds/v1beta1/fluentbit_types.md +++ b/content/docs/configuration/crds/v1beta1/fluentbit_types.md @@ -1143,6 +1143,14 @@ ForwardOptions defines custom forward output plugin options, see https://docs.fl ### Require_ack_response (bool, optional) {#forwardoptions-require_ack_response} +### Retain_Metadata_In_Forward_Mode (bool, optional) {#forwardoptions-retain_metadata_in_forward_mode} + +Controls whether fluent-bit appends log event metadata when forwarding records. Available since fluent-bit 5.0.4; defaults to `true` in fluent-bit 5.0.5 and later. + +Fluentd does not understand the fluent-bit metadata format and drops these records as "invalid event". To maintain compatibility with fluentd, the operator defaults this to `false` for Forward mode targets. + +Set to `true` only when forwarding between fluent-bit instances. + ### Retry_Limit (string, optional) {#forwardoptions-retry_limit}