Need help with dusk?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

obfuscurity
195 Stars 17 Forks MIT License 88 Commits 5 Opened issues

Description

Hotspot dashboard for Graphite

Services available

!
?

Need anything else?

Contributors list

# 43,558
Ruby
Shell
sensu
graphit...
83 commits
# 24,638
coffees...
serverl...
aws-sam
lambda
1 commit
# 126,148
Scala
playfra...
HTML
finagle
1 commit

Dusk

Overview

Dusk is a dashboard app based on cubism.js. The primary case for Dusk is finding hotspots across a range of values in the same metric domain, e.g. viewing disk latency across an array of disks or fleet of servers.

This project should still be considered beta software. There are known performance and usability issues to address before anyone should rely on this in production.

Usage

Dusk is designed to be simple and purpose-driven. Any string passed to the

/metrics/
endpoint (including wildcards) will be used as the search context. All metrics found by the Graphite server will be returned and rendered live.

For example, loading

/metrics/collectd.*.load.load.shortterm
will render the
shortterm
metric for all servers in your Graphite instance. Adding the
index
param to your URL defines which (zero-indexed) node should be used as the metric alias.

usage

Deployment

The only required environment variable is

GRAPHITE_URL
. This should be set to the base URL of your Graphite composer (e.g.
https://graphite.yourdomain.com
). If your server requires Basic Auth, include the credentials in your
GRAPHITE_URL
(e.g.
https://user:[email protected]
).

Local

The following instructions assume a working Ruby installation with the

bundler
gem already installed on your system.
$ git clone https://github.com/obfuscurity/dusk.git
$ cd dusk
$ bundle install
$ export GRAPHITE_URL=...
$ foreman start
$ open http://127.0.0.1:5000

Heroku

$ heroku create
$ heroku config:add GRAPHITE_URL=...
$ git push heroku master
$ heroku scale web=1
$ heroku open

Chef Cookbook

Will Maier of Simple has kindly contributed a Dusk cookbook for Chef users.

GitHub Authentication

To authenticate against a GitHub organization, set the following environment variables:

$ export GITHUB_CLIENT_ID=
$ export GITHUB_CLIENT_SECRET=
$ export GITHUB_AUTH_ORGANIZATION=

To register an OAuth application, go here: https://github.com/settings/applications

License

Dusk is distributed under the MIT license.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.