README.md

# Fluentd

**Fluentd** is a streaming data collector for unified logging layer hosted by CNCF.  Fluentd lets you unify the data collection and consumption for a better use and understanding of data.

For more information, check [official site](https://www.fluentd.org/) and [documentation site](https://docs.fluentd.org/).

# Supported tags
- 10.0.0

# Quick reference
- **Where to get help**: [the Docker Community Forums](https://forums.docker.com/), [the Docker Community Slack](http://dockr.ly/slack), [Stack Overflow](https://stackoverflow.com/search?tab=newest&q=docker), or [Repo1    DCCSCR Issues](https://repo1.dsop.io/dsop/dccscr/issues).
- **Where to file issues**: [Repo1 DCCSCR Issues](https://repo1.dsop.io/dsop/dccscr/issues)
- **Application maintained by**: [Fluentd](https://github.com/fluent/fluentd-docker-image)
- **Container maintained by**: [Platform One](https://software.af.mil/dsop/services/)
- **Image Location**: [Iron Bank Maven](https://dcar.dsop.io/repomap/opensource/fluentd/fluentd)

# How to run images 
```
$ docker run -d -p 24224:24224 -p 24224:24224/udp -v /data:/fluentd/log localhost/opensource/fluentd/fluentd:1.11.0
```
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`)

### Providing your own configuration file and additional options
`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 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

# Enabling Encryption
- **How to enable TLS encryption**: https://docs.fluentd.org/input/forward#how-to-enable-tls-encryption
- **TLS mutual authentication**: https://docs.fluentd.org/input/forward#how-to-enable-tls-mutual-authentication


# Notes
This Dockerfile is based on the opensource version on [github](https://github.com/fluent/fluentd-docker-image/blob/master/v1.10/debian/Dockerfile).