Fluentd
Search…
1.0
Introduction
Overview
Installation
Configuration
Deployment
System Configuration
Logging
Signals
RPC
High Availability Config
Performance Tuning
Multi Process Workers
Failure Scenarios
Plugin Management
Trouble Shooting
Fluentd UI
Linux Capability
Command Line Option
Container Deployment
Monitoring Fluentd
Input Plugins
Output Plugins
Filter Plugins
Parser Plugins
Formatter Plugins
Buffer Plugins
Storage Plugins
Service Discovery Plugins
Metrics Plugins
How-to Guides
Language Bindings
Plugin Development
Plugin Helper API
Troubleshooting Guide
Powered By GitBook
System Configuration
This article describes Fluentd's system configurations for the <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

type
default
version
integer
1
0.14.12
Specifies the number of workers.

root_dir

type
default
version
string
nil
0.14.11
Specifies the root directory.

log_level

type
default
version
enum
"info"
0.14.0
Specifies the log level e.g. trace, debug, info, warn, error, or fatal.

suppress_repeated_stacktrace

type
default
version
bool
nil
0.14.0
Suppresses the repeated stacktrace.

emit_error_log_interval

type
default
version
time
nil
0.14.0
Specifies the time value of the emitting of error log interval.

ignore_repeated_log_interval

type
default
version
time
nil
1.10.2
Specify interval to ignore repeated log/stacktrace messages.
See also Logging article.

ignore_same_log_interval

type
default
version
time
nil
1.11.3
Specify interval to ignore same log/stacktrace messages.
See also Logging article.

suppress_config_dump

type
default
version
bool
nil
0.14.0
Suppresses the configuration dump.

log_event_verbose

type
default
version
bool
nil
0.14.12
Logs event verbosely.

without_source

type
default
version
bool
nil
0.14.0
Invokes fluentd without input plugins.

rpc_endpoint

type
default
version
string
nil
0.14.0
Specifies an RPC endpoint. Refer to the RPC article for more detail.

enable_get_dump

type
default
version
bool
nil
0.14.0
Enables to get dump.

process_name

type
default
version
string
nil
0.14.0
Specifies the process name.

enable_msgpack_time_support

type
default
version
bool
false
1.9.0
Allows Time object in buffer's MessagePack serde. This is useful when the log contains multiple time fields.

file_permission

type
default
version
string
nil
0.14.0
Specifies the file permission in the octal format.

dir_permission

type
default
version
string
nil
0.14.0
Specifies the directory permission in the octal format.

strict_config_value

type
default
version
bool
nil
1.8.0
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

type
default
version
bool
nil
1.12.1
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

type
default
version
enum
text
0.14.20
Specifies the logging format e.g. text or json.

time_format

type
default
version
string
%Y-%m-%d %H:%M:%S %z
0.14.20
Specifies time format.

rotate_age

type
default
version
enum or integer
5
1.13.0
Specifies daily, weekly, monthly or integer which indicates age of log rotation.

rotate_size

type
default
version
size
1048576
1.13.0
Specifies log file size limitation.

enable_input_metrics

type
default
version
bool
nil
1.14.0
Specifies whether measuring input metrics should be enabled or not.

enable_size_metrics

type
default
version
bool
nil
1.14.0
Specifies whether measuring record size metrics should be enabled or not. It can be useful for calculating flow rate on Fluentd instances.

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.
  • --umask UMASK: Specifies umask to use, in octal form. Defaults to 0.
  • -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.
Previous
Deployment
Next
Logging
Last modified 2mo ago
Copy link
Contents
Overview
Parameters
workers
root_dir
log_level
suppress_repeated_stacktrace
emit_error_log_interval
ignore_repeated_log_interval
ignore_same_log_interval
suppress_config_dump
log_event_verbose
without_source
rpc_endpoint
enable_get_dump
process_name
enable_msgpack_time_support
file_permission
dir_permission
strict_config_value
disable_shared_socket
<log> section
Fluent::SystemConfig::Mixin Methods
Command-Line Options