feat: Add json_encoding option to service configuration

This commit adds the `json_encoding` option to the service configuration for both classic and YAML modes. This option allows users to control the encoding of raw UTF-8 strings when serializing MessagePack records to JSON.

Author: owan

administration/configuring-fluent-bit/classic-mode/configuration-file.md

@@ -35,6 +35,7 @@ The `Service` section defines global properties of the service. The following ke
 | `scheduler.cap`   | Set a maximum retry time in seconds. Supported in v1.8.7 and greater. | `2000` |
 | `scheduler.base`  | Set a base of exponential backoff. Supported in v1.8.7 and greater. | `5` |
 | `json.convert_nan_to_null` | If enabled, `NaN` converts to `null` when Fluent Bit converts `msgpack` to `json`. | `false` |
+| `json_encoding` | When Fluent Bit is serializing a MessagePack record into JSON, this option allows to specify the encoding of raw UTF-8 strings. The available options are `escaped` and `raw`. `escaped` is the default and it will escape the UTF-8 characters. `raw` will not escape the UTF-8 characters. | `escaped` |
 | `sp.convert_from_str_to_num` | If enabled, Stream processor converts from number string to number type. | `true` |
 | `windows.maxstdio` | If specified, the limit of stdio is adjusted. Only provided for Windows. From 512 to 2048 is allowed. | `512` |
 

administration/configuring-fluent-bit/yaml/configuration-file.md

@@ -81,6 +81,7 @@ The `service` section defines the global properties of the service. The Service
 | `scheduler.cap`   | Set a maximum retry time in seconds. Supported from v1.8.7. | `2000` |
 | `scheduler.base`  | Sets the base of exponential backoff. Supported from v1.8.7. | `5` |
 | `json.convert_nan_to_null` | If enabled, NaN is converted to null when Fluent Bit converts `msgpack` to JSON. | `false` |
+| `json_encoding` | When Fluent Bit is serializing a MessagePack record into JSON, this option allows to specify the encoding of raw UTF-8 strings. The available options are `escaped` and `raw`. `escaped` is the default and it will escape the UTF-8 characters. `raw` will not escape the UTF-8 characters. | `escaped` |
 | `sp.convert_from_str_to_num` | If enabled, Stream processor converts from number string to number type. | `true` |
 | `windows.maxstdio` | If specified, the limit of stdio is adjusted. Only provided for Windows. From 512 to 2048 is allowed. | `512` |
 

administration/configuring-fluent-bit/yaml/service-section.md

@@ -9,6 +9,7 @@ The `service` section defines global properties of the service. The available co
 | `daemon` | Boolean. Specifies whether Fluent Bit should run as a daemon (background process). Allowed values are: `yes`, `no`, `on`, and `off`. Don't enable when using a Systemd-based unit, such as the one provided in Fluent Bit packages.                                                                                                                                                                                                                  | `off` |
 | `dns.mode` | Sets the primary transport layer protocol used by the asynchronous DNS resolver. Can be overridden on a per-plugin basis.                                                                                                                                                                                                                                                                                                                            | `UDP` |
 | `log_file` | Absolute path for an optional log file. By default, all logs are redirected to the standard error interface (stderr).                                                                                                                                                                                                                                                                                                                                | _none_ |
+| `json_encoding` | When Fluent Bit is serializing a MessagePack record into JSON, this option allows to specify the encoding of raw UTF-8 strings. The available options are `escaped` and `raw`. `escaped` is the default and it will escape the UTF-8 characters. `raw` will not escape the UTF-8 characters. | `escaped` |
 | `log_level` | Sets the logging verbosity level. Allowed values are: `off`, `error`, `warn`, `info`, `debug`, and `trace`. Values are cumulative. If `debug` is set, it will include `error`, `warn`, `info`, and `debug`. Trace mode is only available if Fluent Bit was built with the _`WITH_TRACE`_ option enabled.                                                                                                                                             | `info` |
 | `parsers_file` | Path for a `parsers` configuration file. Multiple `parsers_file` entries can be defined within the section. However, with the new YAML configuration schema, defining parsers using this key is now optional. Parsers can be declared directly in the `parsers` section of your YAML configuration, offering a more streamlined and integrated approach.                                                                                             | _none_ |
 | `plugins_file` | Path for a `plugins` configuration file. This file specifies the paths to external plugins (.so files) that Fluent Bit can load at runtime. With the new YAML schema, the `plugins_file` key is optional. External plugins can now be referenced directly within the `plugins` section, simplifying the plugin management process. [See an example](https://github.com/fluent/fluent-bit/blob/master/conf/plugins.conf).                             | _none_ |