Service
The service
section defines global properties of the service. The available configuration keys are:
flush
Sets the flush time in seconds.nanoseconds
. The engine loop uses a flush timeout to determine when to flush records ingested by input plugins to output plugins.
1
grace
Sets the grace time in seconds
as an integer value. The engine loop uses a grace timeout to define the wait time before exiting.
5
daemon
Boolean. Specifies whether Fluent Bit should run as a daemon (background process). Allowed values are: yes
, no
, on
, and off
. Do not 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
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.
none
streams_file
Path for the Stream Processor configuration file. This file defines the rules and operations for stream processing within Fluent Bit. The streams_file
key is optional, as Stream Processor configurations can be defined directly in the streams
section of the YAML schema. This flexibility allows for easier and more centralized configuration. Learn more about Stream Processing configuration.
none
http_server
Enables the built-in HTTP Server.
off
http_listen
Sets the listening interface for the HTTP Server when it's enabled.
0.0.0.0
http_port
Sets the TCP port for the HTTP Server.
2020
coro_stack_size
Sets the coroutine stack size in bytes. The value must be greater than the page size of the running system. Setting the value too small (4096
) can cause coroutine threads to overrun the stack buffer. The default value of this parameter should not be changed.
24576
scheduler.cap
Sets a maximum retry time in seconds. Supported in v1.8.7 and greater.
2000
scheduler.base
Sets the base of exponential backoff. Supported in v1.8.7 and greater.
5
json.convert_nan_to_null
If enabled, NaN
is converted to null
when Fluent Bit converts msgpack
to json
.
false
sp.convert_from_str_to_num
If enabled, the Stream Processor converts strings that represent numbers to a numeric type.
true
Configuration Example
Below is a simple configuration example that defines a service
section and a pipeline with a random
input and stdout
output:
Last updated