You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Yann Esposito 40aaa5196e added screenshot to README 6 years ago
bin rename Riemann::Dash -> Riemann::Dash::App + move sinatra app to app.rb 10 years ago
example use standard riemann-dash port 6 years ago
img added screenshot 6 years ago
lib/riemann minor css fix 8 years ago
sh readme for tests 10 years ago
test Extra happy tests for merge_workspace 8 years ago
.gitignore moving config back to previous location for backward compatibility 10 years ago
Gemfile moving config back to previous location for backward compatibility 10 years ago
Gemfile.lock Add support for multiple backends to store config (S3 and File for now) 9 years ago
LICENSE Initial commit: version 0.0.3 11 years ago
README.markdown added screenshot to README 6 years ago
Rakefile.rb rake test task 10 years ago added screenshot 6 years ago
riemann-dash.gemspec use webrick by default, document thin/puma installation 8 years ago




Remark: the riemann config is the file riemann.config. It contains alert rules.

Riemann-Dash is a javascript, websockets-powered dashboard for Riemann.

Get started

    $ gem install riemann-dash
    $ riemann-dash

Then open http://localhost:4567 in a browser. Riemann-dash will connect to the local host (relative to your browser) by default, and show you a small manual. Change the IP address in the top right field to point to your Riemann server's websocket port.


Riemann-dash takes an optional config file, which you can specify as the first command-line argument. If none is given, it looks for a file in the local directory: config.rb. That file can override any configuration options on the Dash class, and hence, all Sinatra configuration. You'll find a few usage examples in "example/config.rb".

set :port, 6000      # HTTP server on port 6000
set :bind, "" # Bind to a different interface
config[:ws_config] = 'custom/config.json' # Specify custom workspace config

Putting in production

If you expect more than a couple of simultaneous users, you should consider running Riemann-dash in a proper application server. The easiest way is to install thin or puma. Riemann-dash will automatically use one of them if they are present. You'll need the C/C++ compiler, as well as the ruby and openssl libraries and headers installed.

    $ gem install riemann-dash thin
    $ riemann-dash

Riemann-dash can also run in a web server supporting the Rack interface. An example rackup app is found in "example/".


$ git clone git://
$ cd riemann-dash
$ bundle


# run tests
$ sh/test


$ rake build
$ rake release


$ sh/c
> irb :001 > Riemann::Dash::VERSION
> => "0.2.2"