A Riemann client and command line tool
Project description
A Riemann client library and command line tool for Python.
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
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
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
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
riemann-client was written by Sam Clements, while working at DataSift.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file riemann-client-3.0.2.tar.gz.
File metadata
- Download URL: riemann-client-3.0.2.tar.gz
- Upload date:
- Size: 7.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 7b23bca406bf401b416910ba311169292e406133b9fae9df6d8555a73ea13f79 |
|
| MD5 | d00889d18bf14a64acd93e85cdb5d030 |
|
| BLAKE2b-256 | 658db3654617f1c6f590e05a4ac1a679889b0545dec7afd7fe7960a3f73238fd |
File details
Details for the file riemann_client-3.0.2-py27-none-any.whl.
File metadata
- Download URL: riemann_client-3.0.2-py27-none-any.whl
- Upload date:
- Size: 11.6 kB
- Tags: Python 2.7
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | d1b470cd0ea4a05122570584fc0b6c4d4617d84a4c9bd3bceb1e36ff33d1df96 |
|
| MD5 | e86befc4094e376daebb3cc0212a59ae |
|
| BLAKE2b-256 | 4faa24d0939a6368657103be7bd13fe3eb5e77b0c5737c6f50b15374e0f3b1e4 |
