Skip to main content

A Riemann client and command line tool

Project description

https://pypip.in/v/riemann-client/badge.png https://travis-ci.org/borntyping/python-riemann-client.png?branch=master

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

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.

https://0.gravatar.com/avatar/8dd5661684a7385fe723b7e7588e91ee?d=https%3A%2F%2Fidenticons.github.com%2Fe83ef7586374403a328e175927b98cac.png&r=x&s=40 https://1.gravatar.com/avatar/a3a6d949b43b6b880ffb3e277a65f49d?d=https%3A%2F%2Fidenticons.github.com%2F065affbc170e2511eeacb3bd0e975ec1.png&r=x&s=40

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

riemann-client-3.0.1.tar.gz (7.2 kB view details)

Uploaded Source

File details

Details for the file riemann-client-3.0.1.tar.gz.

File metadata

File hashes

Hashes for riemann-client-3.0.1.tar.gz
Algorithm Hash digest
SHA256 81c3e0d9dd3179a3e4e390818c8de80d431d194d0425c882f49f66f4bf49e745
MD5 287e15f0385a496e3b086f87ac28e783
BLAKE2b-256 f1f5a45b9ad6a9e23419d22a11533b05c156ea36bcf189158912aa9b5e48b5c8

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page