copy
The copy
output plugin copies events to multiple outputs.
It is included in Fluentd's core.
Example Configuration
Please see the Configuration 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
to an Elasticsearch instance (See out_file
and out_elasticsearch
):
Plugin Helpers
See also: Output Plugin Overview
Parameters
@type
@type
The value must be copy
.
copy_mode
copy_mode
Chooses how to pass the events to <store>
plugins.
Supported modes:
no_copy
(default)Share events between
store
plugins.shallow
Pass shallow copied events to each
store
plugin. This mode uses Ruby'sdup
method. This mode is useful when you do not modify the nested fields afterout_copy
, e.g. remove top-level fields.deep
Pass deep copied events to each
store
plugin. This mode usesmsgpack-ruby
internally. This mode is useful when you modify the nested field afterout_copy
, e.g. Kubernetes related fields.marshal
Pass deep copied events to each
store
plugin. This mode uses Ruby'smarshal
internally. This mode is useful whenmsgpack-ruby
cannot process your events. This mode is very slow.
deep_copy
deep_copy
This parameter is deprecated since v1.8.1. Use copy_mode
instead.
out_copy
shares a record between store
plugins by default.
If true
, out_copy
passes dupped record to each store
plugin. This behavior is similar to copy_mode shallow
.
<store>
Section
<store>
SectionSpecifies the storage destinations. The format is the same as the <match>
directive.
This section is required at least once.
ignore_error
argument
ignore_error
argumentIf one store
raises an error, it affects other <store>
. For example:
If plugin1's emit/format raises an error, plugin2 is not executed. If you want to ignore an error from a less important <store>
, you can specify ignore_error
in <store>
:
ignore_if_prev_success
argument
ignore_if_prev_success
argumentSince Fluentd v1.12.2, you can use ignore_if_prev_success
to define fallback outputs. For example:
Fluentd will make use of plugin2 only if the preceding destinations (plugin1 in this case) fail.
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 updated