ekristen / docker-plugin-multilogger

A docker multilogger as a plugin. Implements jsonlog + splunk loggers.

multilogger - a logger docker plugin

Consider this currently as a work in progress, alpha/beta plugin. While it current works, I haven't riggerously tested it, so there could be performance or other edge cases that have not been addressed yet.

This implements a logger as a docker plugin that allows for logging to splunk and a json file that is internal to the plugin. The benefit to this is all the logs end up in splunk, but the command docker logs still works.

Credits

Thanks to cpuguy83 for the basis of this plugin, without him this would not exist. Thanks to docker for creating docker plugins!

Installation

docker plugin install ekristen/multilogger

Usage

After installation you can reference ekristen/multilogger as your logging driver, from there, all the jsonfile logger options and the splunk logger options are all valid and accepted. The only required options are splunk-url and splunk-token everything else is optional.

Example Usage

docker run -d --name "example-logger" \
  --log-driver ekristen/multilogger
  --log-opt max-file=2 \
  --log-opt max-size=10m \
  --log-opt splunk-url=https://localhost:8088 \
  --log-opt splunk-token=00000000-0000-0000-0000-000000000000 \
  --log-opt splunk-insecureskipverify=true \
  --log-opt splunk-source=my-source \
  --log-opt splunk-sourcetype=testing \
  --log-opt splunk-format=raw \
  --log-opt tag="" \
  ubuntu bash -c 'while true; do echo "{\"msg\": \"something\", \"time\": \"`date +%s`\"}"; sleep 2; done;'

Supported Drivers

• json-file
• splunk

JSON File Logging Driver

Documentation: https://docs.docker.com/engine/admin/logging/json-file/#options

Splunk Logging Driver

Documentation: https://docs.docker.com/engine/admin/logging/splunk/#splunk-options

Building

This plugin is using govendor to manage all it's dependencies along with multi-stage docker builds. You'll need docker 17.05-ce or later to support the build process.

bash build.sh

License

Apache License