From dc70f1aba5e400e7406d28050ab7ff1b703830a3 Mon Sep 17 00:00:00 2001 From: Lynette Miles Date: Tue, 7 Oct 2025 09:33:12 -0700 Subject: [PATCH 1/4] Config: classic mode: adding index page Signed-off-by: Lynette Miles --- .../configuring-fluent-bit/classic-mode.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) create mode 100644 administration/configuring-fluent-bit/classic-mode.md diff --git a/administration/configuring-fluent-bit/classic-mode.md b/administration/configuring-fluent-bit/classic-mode.md new file mode 100644 index 000000000..c24d6ce27 --- /dev/null +++ b/administration/configuring-fluent-bit/classic-mode.md @@ -0,0 +1,16 @@ +# Configure Fluent Bit using classic mode + +Fluent Bit classic mode configuration will be deprecated at the end of 2026. + +Classic mode is a custom configuration model for Fluent Bit. It's more limited than +the [YAML configuration mode](../configuring-fluent-bit/yaml.md), and doesn't have +the more extensive feature support the YAML configuration has. Classic mode basic design only supports grouping sections with key-value pairs and lacks the ability to handle sub-sections or complex data structures like lists. + +Learn more about classic mode: + +- [Format and schema](./classic-mode/format-schema.md) +- [Variables](./classic-mode/variables.md) +- [Configuration file](./classic-mode/configuration-file.md) +- [Commands](./classic-mode/commands.md) +- [Upstream servers](./classic-mode/upstream-servers.md) +- [Record accessor syntax](./classic-mode/record-accessor.md) From 29698651aaa8962c2f671537a2b1bc8e53193e04 Mon Sep 17 00:00:00 2001 From: Lynette Miles Date: Tue, 7 Oct 2025 09:41:52 -0700 Subject: [PATCH 2/4] Config: yaml: rearranging the wording Signed-off-by: Lynette Miles --- SUMMARY.md | 2 +- administration/configuring-fluent-bit/yaml.md | 6 ++++-- 2 files changed, 5 insertions(+), 3 deletions(-) diff --git a/SUMMARY.md b/SUMMARY.md index ac8b71a45..b6cdeb1bf 100644 --- a/SUMMARY.md +++ b/SUMMARY.md @@ -53,7 +53,7 @@ * [Upstream servers](administration/configuring-fluent-bit/yaml/upstream-servers-section.md) * [Environment variables](administration/configuring-fluent-bit/yaml/environment-variables-section.md) * [Includes](administration/configuring-fluent-bit/yaml/includes-section.md) - * [Classic mode](administration/configuring-fluent-bit/classic-mode/README.md) + * [Classic mode](administration/configuring-fluent-bit/classic-mode.md) * [Format and schema](administration/configuring-fluent-bit/classic-mode/format-schema.md) * [Configuration file](administration/configuring-fluent-bit/classic-mode/configuration-file.md) * [Variables](administration/configuring-fluent-bit/classic-mode/variables.md) diff --git a/administration/configuring-fluent-bit/yaml.md b/administration/configuring-fluent-bit/yaml.md index 649bf092f..8c87887ef 100644 --- a/administration/configuring-fluent-bit/yaml.md +++ b/administration/configuring-fluent-bit/yaml.md @@ -4,9 +4,11 @@ ## Before you get started +YAML has become essential in a cloud ecosystem. To minimize friction and provide a more intuitive experience for creating data pipelines, users are encouraged to transition to YAML. + Fluent Bit traditionally offered a `classic` configuration mode, a custom configuration format that's phasing out. While `classic` mode has served well for many years, it has several limitations. Its basic design only supports grouping sections with key-value pairs and lacks the ability to handle sub-sections or complex data structures like lists. -YAML has become essential in a cloud ecosystem. To minimize friction and provide a more intuitive experience for creating data pipelines, users are encouraged to transition to YAML. The YAML format enables features, such as processors, that aren't possible to configure in `classic` mode. +The YAML format enables features, such as processors, that aren't possible to configure in `classic` mode. As of Fluent Bit v3.2, you can configure everything in YAML. @@ -43,4 +45,4 @@ To access detailed configuration guides for each section, use the following link - [Environment Variables Section documentation](./yaml/environment-variables-section.md) - Information on setting environment variables and their scope within Fluent Bit. - [Includes Section documentation](./yaml/includes-section.md) - - Description on how to include external YAML files. \ No newline at end of file + - Description on how to include external YAML files. From be4a872130b4ebd60d086b03dbf4026e9c416a1b Mon Sep 17 00:00:00 2001 From: Lynette Miles Date: Tue, 7 Oct 2025 09:53:10 -0700 Subject: [PATCH 3/4] Config: yaml: rearranging the wording Signed-off-by: Lynette Miles --- administration/configuring-fluent-bit/classic-mode.md | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/administration/configuring-fluent-bit/classic-mode.md b/administration/configuring-fluent-bit/classic-mode.md index c24d6ce27..5447d8e75 100644 --- a/administration/configuring-fluent-bit/classic-mode.md +++ b/administration/configuring-fluent-bit/classic-mode.md @@ -2,9 +2,7 @@ Fluent Bit classic mode configuration will be deprecated at the end of 2026. -Classic mode is a custom configuration model for Fluent Bit. It's more limited than -the [YAML configuration mode](../configuring-fluent-bit/yaml.md), and doesn't have -the more extensive feature support the YAML configuration has. Classic mode basic design only supports grouping sections with key-value pairs and lacks the ability to handle sub-sections or complex data structures like lists. +Classic mode is a custom configuration model for Fluent Bit. It's more limited than the [YAML configuration mode](../configuring-fluent-bit/yaml.md), and doesn't have the more extensive feature support the YAML configuration has. Classic mode basic design only supports grouping sections with key-value pairs and lacks the ability to handle sub-sections or complex data structures like lists. Learn more about classic mode: From 963e7848557c7976cfd01be1f158f29aa214154c Mon Sep 17 00:00:00 2001 From: Lynette Miles <6818907+esmerel@users.noreply.github.com> Date: Tue, 7 Oct 2025 11:54:53 -0700 Subject: [PATCH 4/4] Update administration/configuring-fluent-bit/classic-mode.md Co-authored-by: Alexa Kreizinger Signed-off-by: Lynette Miles <6818907+esmerel@users.noreply.github.com> --- administration/configuring-fluent-bit/classic-mode.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/administration/configuring-fluent-bit/classic-mode.md b/administration/configuring-fluent-bit/classic-mode.md index 5447d8e75..83b124a0f 100644 --- a/administration/configuring-fluent-bit/classic-mode.md +++ b/administration/configuring-fluent-bit/classic-mode.md @@ -1,6 +1,8 @@ # Configure Fluent Bit using classic mode +{% hint style="info" %} Fluent Bit classic mode configuration will be deprecated at the end of 2026. +{% endhint %} Classic mode is a custom configuration model for Fluent Bit. It's more limited than the [YAML configuration mode](../configuring-fluent-bit/yaml.md), and doesn't have the more extensive feature support the YAML configuration has. Classic mode basic design only supports grouping sections with key-value pairs and lacks the ability to handle sub-sections or complex data structures like lists.