This article describes the Fluentd's system configurations for <system> section and command-line options.

Overview

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

Parameters

workers

Specifies the number of workers.

root_dir

Specifies the root directory.

log_level

Specifies the log level e.g. trace, debug, info, warn, error, or fatal.

suppress_repeated_stacktrace

Suppresses the repeated stacktrace.

emit_error_log_interval

Specifies the time value of the emitting of error log interval.

ignore_repeated_log_interval

Specify interval to ignore repeated log/stacktrace messages.

See also Logging article.

ignore_same_log_interval

Specify interval to ignore same log/stacktrace messages.

See also Logging article.

suppress_config_dump

Suppresses the configuration dump.

log_event_verbose

Logs event verbosely.

without_source

Invokes fluentd without input plugins.

rpc_endpoint

Specifies an RPC endpoint. Refer to the RPC article for more detail.

enable_get_dump

Enables to get dump.

process_name

Specifies the process name.

enable_msgpack_time_support

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

file_permission

Specifies the file permission in the octal format.

dir_permission

Specifies the directory permission in the octal format.

strict_config_value

Parses config values strictly. Invalid numerical or boolean values are not allowed. Fluentd raises configuration error instead of replacing them with 0 or true implicitly.

disable_shared_socket

Force disable the shared socket which is for listening a same port across multiple worker processes. When the shared socket is enabled (it's the default behavior), a socket is always created to enable workers to communicate with the supervisor. On Windows, it consumes a dynamic (a.k.a ephemeral) TCP port. If you don't prefer it, set this option as true. When it's disabled, you may not use plugins that listen a port such as in_forward, in_http and in_syslog.

<log> section

format

Specifies the logging format e.g. text or json.

time_format

Specifies time format.

rotate_age

Specifies daily, weekly, monthly or integer which indicates age of log rotation.

rotate_size

Specifies log file size limitation.

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 = {})

Overwrites the system configuration.

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]: Installs sample configuration file to the directory.

• -c, --config PATH: Specifies the configuration file path. (Default: /etc/fluent/fluent.conf)

• --dry-run: Verifies the fluentd setup without launching.

• --show-plugin-config=PLUGIN (obsolete): Use fluent-plugin-config-format command instead.

• -p, --plugin DIR: Specifies the plugins' directory.

• -I PATH: Specifies the library path.

• -r NAME: Loads the library.

• -d, --daemon PIDFILE: Daemonizes the fluentd process.

• --under-supervisor: Runs the fluent worker under supervisor (this option is NOT for users).

• --no-supervisor: Runs the fluent worker without supervisor.

• --workers NUM: Specifies the number of workers under supervisor.

• --user USER: Changes user.

• --group GROUP: Changes group.

• -o, --log PATH: Specifies the log file path.

• --log-rotate-age AGE: Specifies the generations to keep rotated log files.

• --log-rotate-size BYTES: Sets the byte size to rotate log files.

• --log-event-verbose: Enables the events logging during startup/shutdown.

• -i CONFIG_STRING, --inline-config CONFIG_STRING: Specifies the inlined configuration which is appended to the config file on-the-fly.

• --emit-error-log-interval SECONDS: Suppresses the interval (seconds) to emit error logs.

• --suppress-repeated-stacktrace [VALUE]: Suppress the repeated stacktrace.

• --without-source: Invokes fluentd without input plugins.

• --use-v1-config: Uses v1 configuration format (default).

• --use-v0-config: Uses v0 configuration format.

• --strict-config-value: Parses the configuration values strictly. Invalid numerical or boolean values are rejected. Fluentd raises configuration error exceptions instead of replacing them with 0 or true implicitly.

• -v, --verbose: Increases the verbosity level (-v: debug, -vv: trace).

• -q, --quiet: Decreases the verbosity level (-q: warn, -qq: error).

• --suppress-config-dump: Suppresses the configuration dumping on start.

• -g, --gemfile GEMFILE: Specifies the Gemfile path.

• -G, --gem-path GEM_INSTALL_PATH: Specifies the 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 an open-source project under Cloud Native Computing Foundation (CNCF). All components are available under the Apache 2 License.