Versions | v0.14 (td-agent3) | v0.12 (td-agent2) | v0.10 (td-agent1)

This page is for v0.14, not the latest stable version which is v0.12. For the latest stable version of this article, click here.

file Output Plugin

The out_file Output plugin writes events to files. By default, it creates files on a daily basis (around 00:10). This means that when you first import records using the plugin, no file is created immediately. The file will be created when the timekey condition has been met. To change the output frequency, please modify the timekey value.

Table of Contents

Example Configuration

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

<match pattern>
  @type file
  path /var/log/fluent/myapp
  compress gzip
    timekey 1d
    timekey_use_utc true
    timekey_wait 10m
Please see the Config File article for the basic structure and syntax of the configuration file.


@type (required)

The value must be file.

path (required)

The Path of the file. The actual path is path + time + “.log” by default.
The path parameter supports placeholders, so you can embed time, tag and record fields in the path. Here is an example:

path /path/to/${tag}/${key1}/file.%Y%m%d.log
<buffer tag,time,key1>
  # buffer parameters

See Buffer section configurations for more detail.

The path parameter is used as buffer_path in this plugin.

Initially, you may see a file which looks like "/path/to/file.20140101.log.b4eea2c8166b147a0". This is an intermediate buffer file ("b4eea2c8166b147a0" identifies the buffer). Once the content of the buffer has been completely flushed, you will see the output file without the trailing identifier.


The flushed chunk is appended to existence file or not. The default is false. By default, out_file flushes each chunk to different path.

# append false

This makes parallel file processing easy. But if you want to disable this behaviour, you can disable it by setting append true.

# append true

<format> directive

The format of the file content. The default is out_file.

Here is json example:

  @type json

See formatter article for more detail.


Deprecated parameter. Use <format> instead.


Deprecated parameter. Use timekey_use_utc in <buffer> instead.


Compresses flushed files using gzip. No compression is performed by default.


Execute compression again even when buffer chunk is already compressed. Default is false


Create symlink to temporary buffered file when buffer_type is file. No symlink is created by default. This is useful for tailing file content to check logs.

This is disabled on Windows.

@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.

Common Buffer / Output parameters

See Buffer Plugin Overview and Output Plugin Overview

Last updated: 2017-08-23 06:18:52 +0000

Versions | v0.14 (td-agent3) | v0.12 (td-agent2) | v0.10 (td-agent1)

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.

Interested in the Fluentd Newsletters?