Plugin Common Parameters

最新推荐文章于 2022-04-16 22:25:18 发布

转载最新推荐文章于 2022-04-16 22:25:18 发布 · 220 阅读

elk 专栏收录该内容

23 篇文章

订阅专栏

本文介绍了Fluentd中常用插件参数的详细说明，包括所有插件可用的通用参数如类型、ID、日志级别等，以及仅适用于事件生成插件的标签参数。这些参数帮助用户更好地管理和调试配置。

Some common parameters are available for all (or a part of) Fluentd plugins. This page describes the list of these parameters.

Parameters for all plugins

@type

The parameter @type is to specify the type of plugin for the section.

<source>
  @type my_plugin_type
</source>

<filter>
  @type my_filter
</filter>

@id

The @id parameter is used to add the unique name of plugin configuration, which is used for paths of buffer/storage, logging and other purposes.

<match>
  @type file
  @id   service_www_accesslog
  path  /path/to/my/access.log
  # ...
</match>

This parameter should be specified for all plugins to enable root_dir and workers feature globally.

@log_level

This parameter is to specify plugin-specific logging level. The default log level is info. Global log level can be specified by log_level in <system>, or -v/-q command line options. The @log_levelparameter overwrites logging level only for specified plugin instance.

<system>
  log_level info
</system>

<source>
  # ...
  @log_level debug  # show debug log only for this plugin
</source>

The main purposes of this parameter are:

Suppress too many logs only for that plugin
Show debug logs while debugging that plugin

Please see the logging article for further details.

Parameters for plugins which emit events

@label

The @label parameter is to route input events to <label> sections, the set of <filter> and <match>sections.

<source>
  @type  ...
  @label @access_logs
  # ...
</source>

<source>
  @type  ...
  @label @system_metrics
  # ...
</source>

<label @access_log>
  <match **>
    @type file
    path  ...
  </match>
</label>

<label @system_metrics>
  <match **>
    @type file
    path  ...
  </match>
</label>

The values of @label parameter MUST start with @ character.

Specifying @label is strongly recommended to route events to any plugins, without modifying tags. It can make the whole configurations simple.

Last updated: 2018-05-16 10:09:28 +0000

Versions | v1.0 (td-agent3)

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.