A simple Graphite dashboard built using Twitters Bootstrap.
Adding new dashboards is very easy and individual graphs is described using a small DSL.
See the sample directory for an example dashboard including a screenshot.
This dashboard is a Sinatra application, I suggest deploying it in Passenger or other Sinatra application server.
A sample gdash.yaml-sample is included, you should rename it to gdash.yaml and adjust the url to your Graphite etc in there.
The SinatraApp class take two required arguments:
* Where graphite is installed * The directory that has your _dashboards_ directory full of templates
and additional options:
* The title to show at the top of your Graphite * A prefix to prepend to all URLs in the dashboard * How many columns of graphs to create, 2 by default. * The width of the graphs, 500 by default * The height of the graphs, 250 by default * Where your whisper files are stored - future use
You can have multiple top level categories of dashboard. Just create directories in the templatedir for each top level category.
In each top level category create a sub directory with a short name for each new dashboard.
You need a file called dash.yaml for each dashboard, here is a sample:
:name: Email Metrics :description: Hourly metrics for the email system
Then create descriptions in files like cpu.graph in the same directory, here is a sample:
title "Combined CPU Usage" vtitle "percent" area :stacked description "The combined CPU usage for all Exim Anti Spam servers" field :iowait, :scale => 0.001, :color => "red", :alias => "IO Wait", :data => "sumSeries(derivative(mw*munin.cpu.iowait))" field :system, :scale => 0.001, :color => "orange", :alias => "System", :data => "sumSeries(derivative(mw*.munin.cpu.system))" field :user, :scale => 0.001, :color => "yellow", :alias => "User", :data => "sumSeries(derivative(mw*.munin.cpu.user))"
The dashboard will use the description field to show popup information bubbles when someone hovers over a graph with their mouse for 2 seconds.
The graphs are described using a DSL that has its own project and documented over at https://github.com/ripienaar/graphite-graph-dsl/wiki
At the moment we do not support the Related Items feature of the DSL.
You can reuse your dashboards for big displays against a wall in your NOC or office by using the following url structure:
This will display the email dashboard in 4 columns each graph with a width of 600 and a height of 300
The screen will refresh every minute