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

These tags have image version postfix. This updates many places so we need feedback for improve/fix the images.

Current images use fluentd v1 series.

• v1.16.5-1.0, v1.16-2, edge (v1.16/alpine/Dockerfile)
• v1.16.5-debian-1.0, v1.16-debian-2, edge-debian (multiarch image for arm64(AArch64) and amd64(x86_64))
• v1.16.5-debian-amd64-1.0, v1.16-debian-amd64-2, edge-debian-amd64 (v1.16/debian/Dockerfile)
• v1.16.5-debian-arm64-1.0, v1.16-debian-arm64-2, edge-debian-arm64 (v1.16/arm64/debian/Dockerfile)
• v1.16.5-debian-armhf-1.0, v1.16-debian-armhf-2, edge-debian-armhf (v1.16/armhf/debian/Dockerfile)
• v1.16.5-windows-ltsc2019-1.0, v1.16-windows-ltsc2019-1 (v1.16/windows-ltsc2019/Dockerfile)
• v1.16.5-windows-ltsc2022-1.0, v1.16-windows-ltsc2022-1 (v1.16/windows-ltsc2022/Dockerfile)

This is for backward compatibility. Use "Current images" instead.

• v1.4.2-2.0, v1.4-2 (v1.4/alpine/Dockerfile)
• v1.4.2-onbuild-2.0, v1.4-onbuild-2 (v1.4/alpine-onbuild/Dockerfile)
• v1.4.2-debian-2.0, v1.4-debian-2 (v1.4/debian/Dockerfile)
• v1.4.2-debian-onbuild-2.0, v1.4-debian-onbuild-2, edge-debian-onbuild (v1.4/debian-onbuild/Dockerfile)
• v1.4.2-windows-2.0, v1.4-windows-2 (v1.4/windows/Dockerfile)

Support of fluentd v0.12 has ended in 2019. We don't recommend v0.12 for new deployment.

• v0.12.43-2.0, v0.12-2 (v0.12/alpine/Dockerfile)
• v0.12.43-onbuild-2.0, v0.12-onbuild-2 (v0.12/alpine-onbuild/Dockerfile)
• v0.12.43-debian-2.0, v0.12-debian-2 (v0.12/debian/Dockerfile)
• v0.12.43-debian-onbuild-2.0, v0.12-debian-onbuild-2 (v0.12/debian-onbuild/Dockerfile)

You can use older versions via tag. See tag page on Docker Hub.

We recommend to use debian version for production because it uses jemalloc to mitigate memory fragmentation issue.

Check fluentd-kubernetes-daemonset images.

This image is based on the popular Alpine Linux project, available in the alpine official image, and Debian images.

Latest released version of Fluentd.

Latest version of vX.Y Fluentd branch.

A will be incremented when image has major changes.

When fluentd version is updated, A is reset to 1.

Concrete vX.Y.Z version of Fluentd. This tag is recommeded for the production environment.

A will be incremented when image has major changes. B will be incremented when image has small changes, e.g. library update or bug fixes.

When fluentd version is updated, A.B is reset to 1.0.

The image based on Debian Linux image. You may use this image when you require plugins which cannot be installed on Alpine (like fluent-plugin-systemd).

The armhf images use ARM base images for use on devices such as Raspberry Pis.

Furthermore, the base images enable support for cross-platform builds using the cross-build tools from resin.io.

In order to build these images natively on ARM devices, the CROSS_BUILD_START and CROSS_BUILD_END Docker build arguments must be set to the shell no-op (:), for example:

docker build --build-arg CROSS_BUILD_START=":" --build-arg CROSS_BUILD_END=":" -t fluent/fluentd:v1.3-onbuild-1 v1.3/armhf/alpine-onbuild

(assuming the command is run from the root of this repository).

These images/tags are kept for backward compatibility. No update anymore and don't use for new deployment. Use "current images" instead.

These tags are obsolete, already removed to avoid confusing. Use edge, vX.Y-A or vX.Y.Z-A.B images instead.

Latest version of vX.Y Fluentd branch.

Concrete vX.Y.Z version of Fluentd.

onbuild images are deprecated. Use non-onbuild images instead to build your image. New images, v1.5 or later, don't provide onbuild version.

Same as current images.

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

docker run -d -p 24224:24224 -p 24224:24224/udp -v /data:/fluentd/log fluent/fluentd:v1.3-debian-1

Default configurations are to:

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

fluentd arguments can be appended to the docker run line

For example, to provide a bespoke config and make fluentd verbose, then:

docker run -ti --rm -v /path/to/dir:/fluentd/etc fluent/fluentd -c /fluentd/etc/<conf> -v

The first -v tells Docker to share '/path/to/dir' as a volume and mount it at /fluentd/etc The -c after the container name (fluentd) tells fluentd where to find the config file The second -v is passed to fluentd to tell it to be verbose

Use -u option with docker run.

docker run -p 24224:24224 -u foo -v ...

You can build a customized image based on Fluentd's image. Customized image can include plugins and fluent.conf file.

We will use this directory to build a Docker image. Type following commands on a terminal to prepare a minimal project first:

# Create project directory.
mkdir custom-fluentd
cd custom-fluentd

# Download default fluent.conf and entrypoint.sh. This file will be copied to the new image.
# VERSION is v1.7 like fluentd version and OS is alpine or debian.
# Full example is https://raw.githubusercontent.com/fluent/fluentd-docker-image/master/v1.10/debian/fluent.conf

curl https://raw.githubusercontent.com/fluent/fluentd-docker-image/master/VERSION/OS/fluent.conf > fluent.conf

curl https://raw.githubusercontent.com/fluent/fluentd-docker-image/master/VERSION/OS/entrypoint.sh > entrypoint.sh
chmod +x entrypoint.sh

# Create plugins directory. plugins scripts put here will be copied to the new image.
mkdir plugins

curl https://raw.githubusercontent.com/fluent/fluentd-docker-image/master/Dockerfile.sample > Dockerfile

Documentation of fluent.conf is available at docs.fluentd.org.

You can install Fluentd plugins using Dockerfile. Sample Dockerfile installs fluent-plugin-elasticsearch. To add plugins, edit Dockerfile as following:

FROM fluent/fluentd:v1.16-1

# Use root account to use apk
USER root

# below RUN includes plugin as examples elasticsearch is not required
# you may customize including plugins as you wish
RUN apk add --no-cache --update --virtual .build-deps \
        sudo build-base ruby-dev \
 && sudo gem install fluent-plugin-elasticsearch \
 && sudo gem sources --clear-all \
 && apk del .build-deps \
 && rm -rf /tmp/* /var/tmp/* /usr/lib/ruby/gems/*/cache/*.gem

COPY fluent.conf /fluentd/etc/
COPY entrypoint.sh /bin/

USER fluent

FROM fluent/fluentd:v1.16-debian-1

# Use root account to use apt
USER root

# below RUN includes plugin as examples elasticsearch is not required
# you may customize including plugins as you wish
RUN buildDeps="sudo make gcc g++ libc-dev" \
 && apt-get update \
 && apt-get install -y --no-install-recommends $buildDeps \
 && sudo gem install fluent-plugin-elasticsearch \
 && sudo gem sources --clear-all \
 && SUDO_FORCE_REMOVE=yes \
    apt-get purge -y --auto-remove \
                  -o APT::AutoRemove::RecommendsImportant=false \
                  $buildDeps \
 && rm -rf /var/lib/apt/lists/* \
 && rm -rf /tmp/* /var/tmp/* /usr/lib/ruby/gems/*/cache/*.gem

COPY fluent.conf /fluentd/etc/
COPY entrypoint.sh /bin/

USER fluent

These example run apk add/apt-get install to be able to install Fluentd plugins which require native extensions (they are removed immediately after plugin installation). If you're sure that plugins don't include native extensions, you can omit it to make image build faster.

This section is for existing users. Don't recommend for new deployment.

FROM fluent/fluentd:v1.3-onbuild-1

# below RUN includes plugin as examples elasticsearch is not required
# you may customize including plugins as you wish

RUN apk add --no-cache --update --virtual .build-deps \
        sudo build-base ruby-dev \
 && sudo gem install \
        fluent-plugin-elasticsearch \
 && sudo gem sources --clear-all \
 && apk del .build-deps \
 && rm -rf /tmp/* /var/tmp/* /usr/lib/ruby/gems/*/cache/*.gem

FROM fluent/fluentd:v1.3-debian-onbuild-1

# below RUN includes plugin as examples elasticsearch is not required
# you may customize including plugins as you wish

RUN buildDeps="sudo make gcc g++ libc-dev ruby-dev" \
 && apt-get update \
 && apt-get install -y --no-install-recommends $buildDeps \
 && sudo gem install \
        fluent-plugin-elasticsearch \
 && sudo gem sources --clear-all \
 && SUDO_FORCE_REMOVE=yes \
    apt-get purge -y --auto-remove \
                  -o APT::AutoRemove::RecommendsImportant=false \
                  $buildDeps \
 && rm -rf /var/lib/apt/lists/* \
 && rm -rf /tmp/* /var/tmp/* /usr/lib/ruby/gems/*/cache/*.gem

Use docker build command to build the image. This example names the image as custom-fluentd:latest:

docker build -t custom-fluentd:latest ./

Once the image is built, it's ready to run. Following commands run Fluentd sharing ./log directory with the host machine:

mkdir -p log
docker run -it --rm --name custom-docker-fluent-logger -v $(pwd)/log:/fluentd/log custom-fluentd:latest

Open another terminal and type following command to inspect IP address. Fluentd is running on this IP address:

docker inspect -f '{{.NetworkSettings.IPAddress}}' custom-docker-fluent-logger

Let's try to use another docker container to send its logs to Fluentd.

docker run --log-driver=fluentd --log-opt tag="docker.{{.ID}}" --log-opt fluentd-address=FLUENTD.ADD.RE.SS:24224 python:alpine echo Hello
# and force flush buffered logs
docker kill -s USR1 custom-docker-fluent-logger

(replace FLUENTD.ADD.RE.SS with actual IP address you inspected at the previous step)

You will see some logs sent to Fluentd.

Docker Logging | fluentd.org

Fluentd logging driver - Docker Docs

We can't notice comments in the DockerHub so don't use them for reporting issue or asking question.

If you have any problems with or questions about this image, please contact us through a GitHub issue.