https://github.com/ekristen/docker-plugin-multilogger
A docker multilogger as a plugin. Implements jsonlog + splunk loggers.
https://github.com/ekristen/docker-plugin-multilogger
docker docker-logs docker-plugin splunk splunk-hec
Last synced: 3 months ago
JSON representation
A docker multilogger as a plugin. Implements jsonlog + splunk loggers.
- Host: GitHub
- URL: https://github.com/ekristen/docker-plugin-multilogger
- Owner: ekristen
- License: apache-2.0
- Created: 2017-07-27T02:41:33.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2017-10-10T15:23:08.000Z (over 7 years ago)
- Last Synced: 2025-01-11T21:42:44.114Z (5 months ago)
- Topics: docker, docker-logs, docker-plugin, splunk, splunk-hec
- Language: Go
- Homepage:
- Size: 1.01 MB
- Stars: 2
- Watchers: 4
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# 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](http://github.com/cpuguy83/) for the basis of this plugin, without him this would not exist. Thanks to [docker](https://github.com/docker/) for creating docker plugins!
## Installation
```bash
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
```bash
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
bash build.sh
```
## License
[Apache License](LICENSE.md)