Public | Automated Build

Last pushed: 3 years ago
Short Description
Short description is empty for this repo.
Full Description


A Docker image for shipping log to a logstash server

How It Works

This image uses python-beaver to ship local log files to a central Logstash server.

The image has one mountable volume /app/log that can be used to provided access to the local log folder (such as /var/log). By default this will monitor changes to all .log files in /app/log recursively and ship the events out to standard out.

Configuring the Beaver

There are three configuration parameters:

  1. The /app/log volume for providing local logs to the system
  2. The environment variable $BEAVERCONF_URL. This provides a way to load a new beaver configuration file to the image. For testing you can create a github gist and provide the raw file url. A beaver configuration for sending syslogs out could look like:
    logstash_version: 1
    udp_port: 9000

type: syslog
tags: sys,main

3. The environment variable `$BEAVER_OPTS`.  This is where all beaver options are given besides the configuration file which is already set.  To send out the logs from the configuration listed above the string `'-t udp'` would be supplied.

Running this configuration would then become:

$ docker run -t -d -v /var/log:/app/log \
-e BEAVER_OPTS='-t udp' \
--net host \

*Note:* `--net host` is being used in this example because the Logstash server is at localhost.

Extended Example (run a local Logstash server)
This example will monitor your local system log files, send them to logstash, and let you view them at
the [prebuilt logstash dashboard](
You can do a lot more with [docker-logstash](

$ docker run -d \
-p 9292:9292 \
-p 9200:9200 \
-p 9000:9000 \

$ docker run -t -d -v /var/log:/app/log \
-e BEAVER_OPTS='-t udp' \
--net host \

Docker Pull Command
Source Repository