riemann-client 3.0.1

A Riemann client and command line tool

A Riemann client and command line tool.

Usage

As a command line tool:

riemann-client [--host HOST] [--port PORT] send [-s SERVICE] [-S STATE] [-m METRIC] [...]
riemann-client [--host HOST] [--port PORT] query '<query>'

The host and port used by the command line tool can also be set with the RIEMANN_HOST and RIEMANN_PORT environment variables. By default, localhost:5555 will be used.

As a library:

import riemann_client.client

with riemann_client.client.Client() as client:
        client.event(service='riemann-client', state='awesome')
        client.query("service = 'riemann-client'")

Installation

python-riemann-client requires Python 2.6 or 2.7, and can be installed with pip install riemann-client. Python 3 is not supported due to the dependency on the Google protobuf package.

Requirements

• argparse

• protobuf

Changelog

Version numbers use the semver specification. A new major version indicates breaking changes.

Version 3.0.0

• Renamed module from riemann to riemann_client

• Command line interface was rewritten, and is now the only part of the library that respects the RIEMANN_HOST and RIEMANN_PORT environment variables

• Support for querying the Riemann index was added

• Internally, transports now define send instead of write, and TCPTransport.send returns Riemann’s response message

Licence

python-riemann-client is licensed under the MIT Licence. The protocol buffer definition is sourced from the Riemann Java client, which is licensed under the Apache Licence.

Authors

python-riemann-client was written by Sam Clements, while working at DataSift.