Config: Common Parameters

Search…

Some common parameters are available for all or some of the Fluentd plugins. This page describes these parameters.
Parameters for all the Plugins
@type
The @type parameter specifies the type of the plugin.
1
<source>
2
  @type my_plugin_type
3
</source>
4
​
5
<filter>
6
  @type my_filter
7
</filter>
Copied!
@id
The @id parameter specifies a unique name for the configuration. It is used as paths for buffer, storage, logging and for other purposes.
1
<match>
2
  @type file
3
  @id service_www_accesslog
4
  path /path/to/my/access.log
5
  # ...
6
</match>
Copied!
This parameter should be specified for all the plugins to enable root_dir and workers feature globally.
See also: System Configuration​
@log_level
This parameter specifies the plugin-specific logging level. The default log level is info. Global log level can be specified by setting log_level in <system> section or with -v/-q command line arguments. The @log_level parameter overrides the logging level only for the specified plugin instance.
1
<system>
2
  log_level info
3
</system>
4
​
5
<source>
6
  # ...
7
  @log_level debug # shows debug log only for this plugin
8
</source>
Copied!
The main purposes of this parameter are:
1.
to suppress too many logs for that plugin; and,
2.
to show the debug logs to help in the debugging process.
Please see the logging article for further details.
Plugin Parameters that Emit Events
@label
The @label parameter is to route the input events to <label> sections, the set of the <filter> and <match> subsections under <label>.
1
<source>
2
  @type ...
3
  @label @access_logs
4
  # ...
5
</source>
6
​
7
<source>
8
  @type ...
9
  @label @system_metrics
10
  # ...
11
</source>
12
​
13
<label @access_log>
14
  <match **>
15
    @type file
16
    path ...
17
  </match>
18
</label>
19
​
20
<label @system_metrics>
21
  <match **>
22
    @type file
23
    path ...
24
  </match>
25
</label>
Copied!
NOTE: The values for the @label parameter MUST start with @ character.
Specifying @label is strongly recommended to route events to any plugin without modifying the tags. It helps make the complex configuration modular and simple.
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.

Routing Examples

Config: Parse Section

Last modified 4mo ago

Copy link

Contents

Parameters for all the Plugins

@type

@id

@log_level

Plugin Parameters that Emit Events

@label

Parameters for all the Plugins

`@type`

`@id`

`@log_level`

Plugin Parameters that Emit Events

@label