This article describes Fluentd's system configuraitons configured via <system> section and command line options.

Overview

System Configuration is one way to set up system-wide configuration such as enabling RPC, multiple workers, to obtain dump.

Parameters

workers

Specify number of workers.

root_dir

Specify root directory.

log_level

Specify log_level. Users can choose trace, debug, info, warn, error, and fatal level.

suppress_repeated_stacktrace

Suppress repeated stacktrace.

emit_error_log_interval

Specify time value of emitting error log interval.

suppress_config_dump

Suppress config dump.

log_event_verbose

Log event verbose.

without_source

Invoke a fluentd without input plugins.

rpc_endpoint

Specify RPC endpoint. In more detail, please refer to RPC document.

enable_get_dump

Enabling to get dump.

process_name

Specify process name.

enable_msgpack_time_support

Allow Time object in buffer's MessagePack serde. This is useful when your log contains multiple time fields.

file_permission

Specify file permission with octal.

dir_permission

Specify directory permission with octal.

strict_config_value

Parse config values strictly. Invalid numerical or boolean values aren't allowed. Fluentd raises configuration error instead of replacing them with 0 or true implicitly.

<log> section

format

Specify logging format. Users can choose text and json format.

time_format

Specify time format.

Fluent::SystemConfig::Mixin methods

.system_config

Returns Fluent::SystemConfig instance.

For code example, please refer to api-plugin-base's .system_config description.

.system_config_override(options = {})

Overwrite system config.

This is for internal use and plugin testing.

For code example, please refer to api-plugin-base's .system_config_override description.

Command Line Options

-s, --setup [DIR=/etc/fluent]

Install sample configuration file to the directory

-c, --config PATH

Config file path (default: /etc/fluent/fluent.conf)

--dry-run

Check fluentd setup is correct or not

--show-plugin-config=PLUGIN (obsoleted)

Use fluent-plugin-config-format command instead.

-p, --plugin DIR

Add plugin directory.

-I PATH

Add library path.

-r NAME

Load library.

-d, --daemon PIDFILE

Daemonize fluent process.

--under-supervisor

Run fluent worker under supervisor (this option is NOT for users).

--no-supervisor

Run fluent worker without supervisor.

--workers NUM

Specify the number of workers under supervisor.

--user USER

Change user.

--group GROUP

Change group.

-o, --log PATH

Log file path.

--log-rotate-age AGE

Generations to keep rotated log files.

--log-rotate-size BYTES

Sets the byte size to rotate log files.

--log-event-verbose

Enable log events during process startup/shutdown.

-i CONFIG_STRING, --inline-config CONFIG_STRING

Inline config which is appended to the config file on-the-fly.

--emit-error-log-interval SECONDS

Suppress interval seconds of emit error logs.

--suppress-repeated-stacktrace [VALUE]

Suppress repeated stacktrace.

--without-source

Invoke a fluentd without input plugins.

--use-v1-config

Use v1 configuration format (default).

--use-v0-config

Use v0 configuration format.

--strict-config-value

Parse config values strictly. Invalid numerical or boolean values aren't allowed. Fluentd raises configuration error instead of replacing them with 0 or true implicitly.

-v, --verbose

Increase verbose level (-v: debug, -vv: trace).

-q, --quiet

Decrease verbose level (-q: warn, -qq: error).

--suppress-config-dump

Suppress config dumping when fluentd starts.

-g, --gemfile GEMFILE

Gemfile path.

-G, --gem-path GEM_INSTALL_PATH

Gemfile install path (default: $(dirname $gemfile)/vendor/bundle).

If this article is incorrect or outdated, or omits critical information, please let us know. Fluentd is a open source project under Cloud Native Computing Foundation (CNCF). All components are available under the Apache 2 License.