Versions | v1.0 (td-agent3) | v0.12 (td-agent2)

relabel Output Plugin

The relabel output plugin re-labels events.

Table of Contents

Example Configuration

out_relabel is included in Fluentd’s core. No additional installation process is required.

<match pattern>
  @type relabel
  @label @foo

<label @foo>
  <match pattern>

The above example puts a label @foo to matched events, and the label directive can take care of these events.

FYI: All of input and output plugins also have @label parameter provided by Fluentd core. The relabel plugin is a plugin which actually does nothing, but supports only @label parameter.

Supported modes

Plugin helpers


Common Parameters


The value must be relabel.


The label.

type default version
string required parameter 0.14.0
Last updated: 2018-03-20 13:11:23 +0000

Versions | v1.0 (td-agent3) | v0.12 (td-agent2)

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.