a log shipping tool
Switch branches/tags
Nothing to show
Clone or download
Latest commit 8831e6e Oct 7, 2015



Logjam is a log forwarder designed to listen on a local port, receive log entries over UDP, and forward these messages on to a log collection server (such as logstash).

The motivation for logjam was a move to containerising our applications, and a need to get logs from these applications out of the containers. We configure logjam to listen on the docker0 ( interface which is accessible to applications running within docker.

Logjam supports collecting logs using the following methods:

  • UDP Socket
  • File

Logjam will pipe all entries as a JSON object terminated with "\n" to a remote server.


Config File

  "bind": "",         // interface on host to bind ( for all)
  "port": 1470,                // port to listen on locally
  "server": "",  // logstash server to forward to
  "buffer": "/tmp/buffer.log", // file to use for on-disk buffer
  "buffer_size": 1024,         // entries to keep in memory buffer
  "truncate": 3600             // clean out disk buffer every x seconds


$ logjam --config config.json


logjam pipeline