copy Output Plugin

The copy output plugin copies events to multiple outputs.

Table of Contents

Example Configuration

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

<match pattern>
  type copy
  <store>
    type file
    path /var/log/fluent/myapp1
    ...
  </store>
  <store>
    ...
  </store>
  <store>
    ...
  </store>
</match>
Please see the Config File article for the basic structure and syntax of the configuration file.

Here is an example set up to send events to both a local file under /var/log/fluent/myapp and the collection fluentd.test in a local MongoDB instance (Please see the out_file and out_mongo articles for more details about the respective plugins.)

<match myevent.file_and_mongo>
  type copy
  <store>
    type file
    path /var/log/fluent/myapp
    time_slice_format %Y%m%d
    time_slice_wait 10m
    time_format %Y%m%dT%H%M%S%z
    compress gzip
    utc
  </store>
  <store>
    type mongo
    host fluentd
    port 27017
    database fluentd
    collection test
  </store>
</match>

Parameters

type (required)

The value must be copy.

deep_copy

out_copy shares a record between store plugins by default.

When deep_copy is true, out_copy passes different record to each store plugin.

<store> (at least one required)

Specifies the storage destinations. The format is the same as the <match> directive.

log_level option

The log_level option allows the user to set different levels of logging for each plugin. The supported log levels are: fatal, error, warn, info, debug, and trace.

Please see the logging article for further details.

Last updated: 2016-06-06 04:47:13 UTC


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.