riemann_client

Crates.ioriemann_client
lib.rsriemann_client
version0.9.0
sourcesrc
created_at2015-03-14 20:45:12.259551
updated_at2021-02-22 11:09:57.898408
descriptionA Riemann client library
homepage
repositoryhttps://github.com/borntyping/rust-riemann_client
max_upload_size
id1577
size117,320
Sam Clements (borntyping)

documentation

README

riemann_client

A Riemann client library and command line interface.

Usage

$ riemann-cli send --service riemann_cli --state ok --metric-d 11
--> { state: "ok" service: "riemann_cli" metric_d: 11 }
<-- { ok: true }
$ riemann-cli query 'service = "riemann_cli"'
HOSTNAME   TIME       SERVICE              METRIC     STATE
           1432128319 riemann_cli          11         ok

Run riemann-cli --help for a list of options availible for the command line interface.

See the examples directory for examples of querying and sending events with the library.

Development

To build the library alone, without the command line interface and it's dependencies, run cargo build --lib --no-default-features.

The protocol buffer defintion can be updated by replacing src/proto/mod.proto with the latest defintion from the Riemann source and running make. You will need to have protoc and protoc-gen-rust installed. protoc is provided by the protobuf-compiler package on Debian based systems. Instructions for installing protoc-gen-rust this are availible in the README for rust-protobuf.

Licence

riemann_client is licenced under the MIT Licence.

It was also directly inspired by the Python riemann-client by the same author.

Authors

Written by Sam Clements.

Commit count: 61

cargo fmt