What is Fluentd?

Fluentd is an open source data collector, which lets you unify the data collection and consumption for a better use and understanding of data.

www.fluentd.org

How to use this image

To create endpoint that collects logs on your host just run:

docker run -d -p 24224:24224 -v /data:/var/log/fluentd bandsintown/fluentd

Default configurations are to:

listen port 24224 for Fluentd forward protocol
store logs with tag docker.** into /var/log/fluentd/docker.*.log (and symlink docker.log)
store all other logs into /var/log/fluentd/log/data.*.log (and symlink data.log)

Environment Variables

Environment variable below are configurable to control how to execute fluentd process:

`FLUENTD_CONF`

This variable allows you to specify configuration file name that will be used in -c Fluentd command line option.

If you want to use your own configuration file (without any optional plugins), you can do it with this environment variable and Docker volumes (-v option of docker run).

Write configuration file with filename yours.conf.
Execute docker run with -v /path/to/dir:/fluentd/etc to share /path/to/dir/yours.conf in container, and -e FLUENTD_CONF=yours.conf to read it.

`FLUENTD_OPT`

Use this variable to specify other Fluentd command line options, like -v or -q.

Build

This project is configured as an automated build in Dockerhub.

License

All the code contained in this repository, unless explicitly stated, is licensed under ISC license.

A copy of the license can be found inside the LICENSE file.