Fluentd
Search…
1.0
Config: Common Parameters
Some common parameters are available for all or some of the Fluentd plugins. This page describes these parameters.
Parameters for all the Plugins
@type
@typeThe
@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
@idThe
@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.@log_level
@log_levelThis 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.
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.
Last modified 7mo ago