A syslog sender, relay and receiver.

syslog, relay
pip install relogger==1.0.2



A relayer or replicator to send SYSLOG from one or multiple sources to one or multiple destinations. Flexible configuration is also supported to fit personalized scenarios.


  • Not a replacement of Flume, but being complementary
  • Light-weight relay focusing on syslog
  • Flexible configuration from/to sockets and files

Related projects

  • Fluentd: an open source data collector for unified logging layer
  • Apache Flume: service to manage large amount of log data
  • Apache Kafka: distributed publish-subscribe messaging system


$ sudo pip install -U relogger


Relogger work flow

Quick Start

The parser supports both CLI parameters and configuration file. As the role of relogger being a relay of syslog, CLI parameters or the configuration file mainly aim to supply the source and destination description.

Using configuration file

$ relogger -F config_file.txt

The configuration file is consistent with the style of RFC 822, and can be parsed with ConfigParser module in Python 2. The configuration of relogger consists of several [section]s and each section defines a set of rules about sources and destinations. A quick example of config_file.txt is like:

[rule1] = localhost = localhost:666
dst.file = output.dat

[rule2] = =

The section name is user-defined. Options in each section currently support, src.file,, dst.file. In a section, at least one src-dst pair should be configured. For host descriptors, multiple values are separated by commas.

Using command lines

The CLI parameters behaves in a similar way with the configuration file, and obey the rules described above. Here we give some quick examples:

  • Replicate syslog from port 514 to two local ports:

    $ relogger -s localhost:514 -d localhost:30514,localhost:31514
  • Reseive syslog from port 514 and save to a file:

    $ relogger -s localhost:514 -w syslog.txt
  • Replay an offline file to remote server on port 514:

    $ relogger -r syslog.txt -d
  • Replicate syslog from port 514 to remote host and offline file simultaneously:

    $ relogger -s localhost -d -w syslog.txt


Xiaming Chen,