Git Product home page Git Product logo

erlang_riemann's Introduction

Riemann

This is a riemann client written in Erlang. It supports sending events, states, and remotely running queries.

Build status

Build Status

Project maturity

This project is still young. While we are using it internally at Aircloak and fixing issues as we find them, you might very well consider it non-production ready, or alpha quality, if you prefer.

The project is likely to undergo some rapid change.

API

The API is all under the riemann module.

% Shortcut method for sending a service metric:
riemann:send("meaning of life", 42).

% If you want to craft a fully custom event,
% use the event method:
Opts = [
    {service, "hyperfluxor"}, 
    {state, "ok"}, 
    {metric, 42}, 
    {tags, ["server-8202", "datacentre-12"]}
],
Event = riemann:event(Opts),
riemann:send(Event).

% Or alternatively the shortform
riemann:send_event(Opts).

% send also accepts lists of events, if you want to 
% send multiple events in batch.

% States are very similar to events
Opts = [
  {service, "pizza oven"},
  {state, "critical"}
],
State = riemann:state(Opts),
riemann:send(State).

Installation

Include the riemann application in your rebar.config file. Then in your *.app file, add riemann as a dependent application:

{application, ...,
 [
  {description, "..."},
  {vsn, "1"},
  {registered, []},
  {applications, [
                  kernel,
                  stdlib,
                  riemann
                 ]},
  {mod, { ..., []}},
  {env, []}
 ]}.

Riemann will default to sending the metrics to localhost on port 5555. You can set the remote riemann host in your config:

[
  ...
  {riemann, [
    {host, "riemann.host.com"},
    {port, 5555}
  ]}
].

Contributions

We welcome contributions as pull requests. Please make a fork of this repository, implement your changes in a feature branch and make a pull request.

License

Apache License 2.0

Thanks

erlang_riemann's People

Contributors

sebastian avatar avasenin avatar timshadel avatar lukyanov avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.