Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Python Riemann client.
branch: master

Merge pull request #20 from joelapatatechaude/master

Add example for custom attribute events, and be more explicit on how to ...
latest commit 2d847137af
@banjiewen authored


A simple Python client for Riemann. Usage:

import bernhard

c = bernhard.Client()
c.send({'host': '', 'service': 'myservice', 'metric': 12})
q = c.query('true')

Bernhard supports custom attributes with the syntax:

import bernhard

c = bernhard.Client()

c.send({'host': '', 'attributes': {'sky': 'sunny', 'sea': 'agitated'}})

Querying the index is as easy as:

import bernhard

c = bernhard.Client()
q = c.query('true')
for e in q:
    print "Host:",, "State:", e.state


pip install bernhard

You may encounter issues with the protobuf dependency; if so, just run pip install protobuf manually, then pip install bernhard.

Something went wrong with that request. Please try again.