rrd-grapher 1.0.0

data/.gitignore

@@ -0,0 +1,9 @@
+gems/
+doc/
+coverage/
+.bundle/
+public/javascripts/generated/*.js
+spec/javascripts/*.js
+.sass-cache/
+.yardoc/
+Gemfile.lock

data/.rvmrc

@@ -0,0 +1 @@
+rvm use 1.9.2-p290

data/Gemfile

@@ -0,0 +1,11 @@
+
+source :rubygems
+
+# underscore.js makes sprockets raise an error wil latest 1.x version..
+#gem 'sprockets', :git => 'git://github.com/matehat/sprockets.git'
+gem 'sprockets', :git => 'git://github.com/salbito/sprockets.git', :branch => '1.0.x'
+# gem 'bacon', :git => 'git://github.com/schmurfy/bacon.git'
+gem 'schmurfy-bacon'
+gem "bindata",       "~> 1.4.2"
+
+gemspec

data/Guardfile

@@ -0,0 +1,123 @@
+# A sample Guardfile
+# More info at https://github.com/guard/guard#readme
+
+require 'sprockets'
+
+guard 'yard' do
+  watch(%r{lib/.+\.rb})
+end
+
+
+# for the grapher
+guard 'coffeescript',
+  :input => 'lib/rrd-grapher/assets/javascripts',
+  :output => 'lib/rrd-grapher/public/javascripts'
+
+guard 'coffeescript',
+  :input => 'spec/javascripts/source',
+  :output => 'spec/javascripts'
+
+guard 'sprockets', :destination => "lib/rrd-grapher/public/javascripts" do
+  watch (%r{lib/rrd-grapher/assets/javascripts/app.js})
+  watch (%r{lib/rrd-grapher/assets/javascripts/app-dev.js})
+end
+
+
+guard 'livereload', :apply_js_live => false do
+  watch(%r{^spec/javascripts/.+\.js$})
+  watch(%r{^lib/rrd-grapher/public/javascripts/.+\.js$})
+  watch(%r{^lib/rrd-grapher/views/stylesheets/.+\.scss$})
+end
+
+
+
+
+
+require 'bacon'
+require 'guard/guard'
+
+module ::Guard
+  class Bacon < Guard
+
+    def initialize(watchers=[], options={})
+      super
+      ::Bacon.extend(::Bacon::TestUnitOutput)
+    end
+
+    def start
+      puts "Guard::Bacon started."
+      true
+    end
+
+    # Called on Ctrl-C signal (when Guard quits)
+    def stop
+      true
+    end
+
+    # Called on Ctrl-Z signal
+    def reload
+      true
+    end
+
+    # Called on Ctrl-\ signal
+    # This method should be principally used for long action like running all specs/tests/...
+    def run_all
+      true
+    end
+    
+    SPEC_FILE ||= /_spec\.rb$/.freeze
+    FILE_REG  ||= %r{^lib/rrd-grapher/(?:[^/]+/)?(.*)\.rb$}.freeze
+    
+    def run_spec(path)
+      if File.exists?(path)
+        pid = Kernel.fork do
+          puts "     *** Running spec: #{path} ***"
+          counters = ::Bacon.run_file(path)
+          # system "bundle exec bacon -o TestUnit #{path}"
+          # {:installed_summary=>1, :specifications=>19, :depth=>0, :requirements=>30, :failed=>2}
+          
+          all_specs = counters[:specifications]
+          failed = counters[:failed]
+          
+          if counters[:failed] > 0
+            Notifier.notify("Specs: #{failed} Failures (#{all_specs} specs)",
+                :image => :failed,
+                :title => File.basename(path)
+              )
+          else
+            Notifier.notify("Specs: OK (#{all_specs} specs)",
+                :image => :success,
+                :title => File.basename(path)
+              )
+          end
+        end
+        
+        Process.wait(pid)
+      end
+    end
+    
+    def file_changed(path)
+      case
+      when path =~ SPEC_FILE    then  run_spec(path)
+      when path =~ FILE_REG     then  run_spec("spec/unit/#{$1}_spec.rb")
+      end
+      
+      puts ""
+    end
+    
+    # Called on file(s) modifications
+    def run_on_change(paths)
+      paths.each do |path|
+        file_changed(path)
+      end
+    end
+
+  end
+end
+
+
+guard 'bacon' do
+  watch(%r{^spec/([^/]/)?.*_spec.rb$})
+  watch(%r{^lib/rrd-grapher/(?:[^/]+/)?(.*)\.rb$})
+end
+

data/README.md

@@ -0,0 +1,91 @@
+
+![screenshot](http://dl.dropbox.com/u/1313066/github/rrd-grapher.png "Screenshot")
+
+# What is this ?
+
+RRDGrapher is my attempt at designing an application capable of drawing meaningful
+dynamic graphs from RRD files.
+
+This project is built as a Rack middleware providing you the with the tools you need to
+build you own views as you see fit, the middleware will provide:
+
+- a REST inerface to your rrd files
+- a javascript framework to create graphs easily (built on top of jQuery and Flot)
+- some basic css to get you started (everything can then be overloaded in your application)
+
+You can have a look at the example_app folder which is a fully working application.
+
+# My goals
+
+The main goal of this project is to allow easy creation of graphs from rrd files stored
+by any tool capable of it (the source really does not matter). Here is a features list:
+
+# Features
+
+- you should be able to able to add a new graph in minutes
+- the zoom (with mouse drag and drop) load new fresh data so your graph is as exact as possible
+- you can decide if the zoom will affect every graph on the page or just one 
+
+
+# Notifier Demon
+
+This one may go into another gem but lives there for now, I made a monitoring demon to receive
+collectd packets and trigger alerts by reacting on the data received.
+
+## What can be monitored ?
+
+Here s what the demon can monitor:
+
+- min/max value : raise an alarm if the value go above or below a <X>
+- missing data  : raise an alarm if no data was received for <X> seconds
+- clock drift   : raise an alarm if the absolute difference between the timestamp
+  inside the packet and the local time is higher then <X> (this suppose that both
+  hosts have an UTC clock)
+
+## How to use it
+
+The demon is desgined as a library and require an eventmachine reactor to run, here is a minimal
+application using it (check the documentation or the source code for more informations):
+
+``` ruby
+require 'rubygems'
+require 'bundler/setup'
+require 'rrd-grapher/notifier'
+
+puts "Notifier started."
+
+EM::run do
+  RRDNotifier::Server.start do |s|
+    s.register_alarm("*", "ping", "ping_droprate", :max => 5)
+    s.register_alarm("*", "uptime", "uptime", :monitor_presence => 2*60)
+    
+    s.register_alarm("*", "load", "load", :max => 1, :index => 1)
+    s.register_alarm("*", "memory/*", "memory/active", :monitor_presence => 1)
+  end
+  
+end
+```
+
+
+
+# Development
+
+If you wan to contribute to this project, here how to do it (in the root folder):
+
+    $ bundle
+
+Now you have all the require gems run guard, it will monitor the sources files
+and rebuild the results as you change them (coffeescript, sass).
+It will also package all the js files with sprockets in one file.
+
+    $ bundle exec guard (will take one console)
+
+You can also force a full rebuild of everything with (coffeescript + sprockets):
+
+    $ rake build
+
+Last thing you will certainly need is to start a webserver, any should do but
+I currently use unicorn
+
+    $ unicorn 
+

data/Rakefile

@@ -0,0 +1,42 @@
+require "bundler/gem_tasks"
+require 'sprockets'
+
+def pack_js(src_file)
+  secretary = ::Sprockets::Secretary.new(
+    :asset_root            => "lib",
+    :source_files          => ["lib/rrd-grapher/assets/javascripts/#{src_file}"],
+    :interpolate_constants => false
+  )
+  
+  concatenation = secretary.concatenation
+  concatenation.save_to("lib/rrd-grapher/public/javascripts/#{src_file}")
+  secretary.install_assets
+end
+
+# compile and pack coffee files
+task :build do
+  # core
+  sh "coffee -c -o lib/rrd-grapher/public/javascripts lib/rrd-grapher/assets/javascripts/"
+  
+  # example_app
+  sh "coffee -c -o example_app/public/javascripts example_app/assets/javascripts/"
+  
+  # sprockets
+  pack_js("app-dev.js")
+  pack_js("app.js")
+end
+
+task :test do
+  system("COVERAGE=1 bundle exec bacon spec/**/*_spec.rb")
+end
+
+
+
+begin
+  require 'jasmine'
+  load 'jasmine/tasks/jasmine.rake'
+rescue LoadError
+  task :jasmine do
+    abort "Jasmine is not available. In order to run jasmine, you must: (sudo) gem install jasmine"
+  end
+end

data/example_app/Gemfile

@@ -0,0 +1,9 @@
+
+gem 'rrd-grapher', :path => File.expand_path('../..', __FILE__)
+gem 'sinatra'
+gem 'sinatra-content-for'
+gem 'haml'
+
+group(:dev) do
+  gem 'guard-coffeescript'
+end

data/example_app/Guardfile

@@ -0,0 +1,18 @@
+
+guard 'coffeescript',
+  :input => 'assets/javascripts',
+  :output => 'public/javascripts'
+
+# guard 'coffeescript',
+#   :input => 'spec/javascripts/source',
+#   :output => 'spec/javascripts'
+
+
+
+# guard 'livereload', :apply_js_live => false do
+#   watch(%r{^spec/javascripts/.+\.js$})
+#   watch(%r{^public/javascripts/.+\.js$})
+#   watch(%r{^views/stylesheets/.+\.scss$})
+#   watch(%r{^views/.+\.haml$})
+# end
+

data/example_app/app.rb

@@ -0,0 +1,38 @@
+require 'rest-client'
+require 'sinatra/base'
+require 'sinatra/content_for'
+
+class TestApp < Sinatra::Base
+  helpers Sinatra::ContentFor
+  
+  set :haml, :format => :html5
+  
+  # set :markdown, :layout_engine => :haml, :layout => :post
+  set :root, File.dirname(__FILE__)
+  
+  get '/available_rrds' do
+    haml :available_rrds
+  end
+  
+  get '/graph' do
+    haml :graph
+  end
+  
+  
+  get '/collectd' do
+    haml :collectd
+  end
+  
+  # css
+  
+  def self.dynamic_css(path)
+    get "/stylesheets/#{path}.css" do
+      content_type :css
+      scss "stylesheets/#{path}".to_sym
+    end
+  end
+  
+  dynamic_css('available_rrds')
+  dynamic_css('graph')
+  
+end

data/example_app/assets/javascripts/available_rrds.coffee

@@ -0,0 +1,13 @@
+
+list_rrd = (callback) ->
+  jQuery.get "/rrd", (o) ->
+    callback(o)
+
+$ ->
+  list_rrd (data) ->
+    # $("#template").tmpl(data).appendTo("#target")
+    tmp = $("#template").tmpl(data)
+    tmp.appendTo("#data_list")
+    # $("#time").showTime( { div_hours: "h ", div_minutes: "m ", div_seconds: "s " } )
+    $(".time").timeago()
+    

data/example_app/assets/javascripts/collectd.coffee

@@ -0,0 +1,48 @@
+
+class window.TestGraph extends GraphDefinition
+  constructor: (container, host, @interface, ymin = null) ->
+    super(host, container, "Test Traffic (#{interface})", [ Format.size, Format.size ], ymin)
+    
+    @graph.addSerie("#{@host}/interface/if_octets-#{@interface}", "rx", "(#{@interface}) Bytes Received")
+    @graph.addSerie("#{@host}/interface/if_octets-#{@interface}", "tx", "(#{@interface}) Bytes Sent", 2)
+
+
+
+class CollectdPage extends GraphPage
+  constructor: (container, panel_container, host) ->
+    super(container, panel_container, host)
+    
+    # @addGraph("NetworkGraph", "en0", 1 * Size.megabyte )
+    @addGraph("TestGraph", "en1", [20 * Size.kilobyte, 100 * Size.kilobyte ] )
+    @addGraph("MemoryGraph", "osx")
+    @addGraph("LoadGraph", 2.0)
+
+$ ->
+  graphs = []
+  
+  container = $("#graphs")
+  panel_container = $("#config_panel")
+  
+  page = new CollectdPage(container, panel_container, "pomme.local")
+  # page.set_simple_interval(30)
+  
+  $("#dateselect").datepicker().change ->
+    date_string = $(this).val()
+    time = Date.parse(date_string) / 1000
+    
+    page.set_autorefresh(null)
+    page.set_interval(time, time + 24*60*60)
+  
+  $("#rangeselect").chosen().change ->
+    page.set_autorefresh(null)
+    page.set_simple_interval( $(this).val() )
+  
+  $("#linkedzoom").change (event) =>
+    if $(event.currentTarget).attr("checked")
+      page.refresh()
+  
+  $("#autorefresh").change (event) =>
+    if $(event.currentTarget).attr("checked")
+      page.set_autorefresh(5000)
+    else
+      page.set_autorefresh(null)

data/example_app/config.ru

@@ -0,0 +1,9 @@
+require 'bundler/setup'
+require 'rrd-grapher'
+
+require File.expand_path('../app', __FILE__)
+
+use RRDGrapher::RRDServer, :root_path => "/usr/local/var/lib/collectd/"
+use RRDGrapher::ResourcesServer
+
+run TestApp

data/example_app/public/.gitignore

@@ -0,0 +1 @@
+javascripts/wijmo-open/