Fetching contributors…
Cannot retrieve contributors at this time
70 lines (43 sloc) 1.86 KB


python daemon that munches on logs and sends their contents to logstash


  • Python 2.6+
  • Optional zeromq support: install libzmq (brew install zmq or apt-get install libzmq-dev) and pyzmq (pip install pyzmq==2.1.11)


Using PIP:

From Github:

pip install git+git://

From PyPI:

pip install beaver==36.2.1


Full documentation is available online at

You can also build the docs locally:

# get sphinx installed
pip install sphinx

# retrieve the repository
git clone git://

# build the html output
cd beaver/docs
make html

HTML docs will be available in beaver/docs/_build/html.


When contributing to Beaver, please review the full guidelines here: If you would like, you can open an issue to let others know about your work in progress. Documentation must be included and tests must pass on Python 2.6 and 2.7 for pull requests to be accepted.


Based on work from Giampaolo and Lusis:

Real time log files watcher supporting log rotation.

Original Author: Giampaolo Rodola' <g.rodola [AT] gmail [DOT] com>

License: MIT

Other hacks (ZMQ, JSON, optparse, ...): lusis