pulse-meter 0.0.1

data/Rakefile

@@ -0,0 +1,53 @@
+#!/usr/bin/env rake
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+require "yard"
+require 'yard/rake/yardoc_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+YARD::Rake::YardocTask.new(:yard)
+
+ROOT = File.dirname(__FILE__)
+
+task :default => :spec
+
+namespace :coffee do
+	desc "Complile coffee to js"
+	task :compile do
+		system 'coffee', '-c', "#{ROOT}/lib/pulse-meter/visualize/public/"
+		puts "Done"
+	end
+
+	desc "Watch coffee files and recomplile them immediately"
+	task :watch do
+		system 'coffee', '--watch', '-c', "#{ROOT}/lib/pulse-meter/visualize/public/"
+	end
+
+end
+
+namespace :yard do
+  desc "Open doc index in a browser"
+  task :open do
+    system 'open', "#{ROOT}/doc/index.html"
+  end
+end
+
+namespace :example do
+  desc "Run minimal example"
+  task :minimal do
+    chdir(ROOT) do
+      system "bundle"
+      system "cd examples/minimal && bundle exec foreman start"
+    end
+  end
+
+  desc "Run full example"
+  task :full do
+    chdir(ROOT) do
+      system "bundle"
+      system "cd examples/full && bundle exec foreman start"
+    end
+  end
+
+end

data/bin/pulse

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '../lib/'))
+require 'pulse-meter'
+require 'cmd'
+
+Cmd::All.start

data/examples/basic.ru

@@ -0,0 +1,109 @@
+$: << File.join(File.absolute_path(__FILE__), '..', 'lib')
+
+require 'pulse-meter/visualizer'
+
+PulseMeter.redis = Redis.new
+
+layout = PulseMeter::Visualizer.draw do |l|
+
+  l.title "WunderZoo Stats"
+
+  l.page "Counts" do |p|
+
+    p.spline "Lama count", sensor: :lama_count do |c|
+      c.redraw_interval 5
+      c.values_label 'Count'
+      c.width 5
+      c.show_last_point true
+      c.timespan 1200
+    end
+
+    p.area "Rhino count", sensor: :rhino_count do |c|
+      c.redraw_interval 5
+      c.values_label 'Count'
+      c.width 5
+      c.show_last_point true
+      c.timespan 1200
+    end
+
+    p.spline "Rhino & Lama count comparison" do |c|
+      c.redraw_interval 5
+      c.values_label 'Count'
+      c.width 5
+      c.show_last_point true
+      c.timespan 1200
+
+      c.sensor :rhino_count, color: '#AAAAAA'
+      c.sensor :lama_count, color: '#CC1155'
+    end
+
+    p.pie "Rhino & Lama count comparison" do |c|
+      c.redraw_interval 5
+      c.values_label 'Count'
+      c.width 5
+      c.show_last_point false
+      c.timespan 1200
+
+      c.sensor :rhino_count, color: '#AAAAAA'
+      c.sensor :lama_count, color: '#CC1155'
+    end
+
+  end
+
+  l.page "Ages" do |p|
+
+    p.line "Lama average age", sensor: :lama_average_age do |c|
+      c.redraw_interval 5
+      c.values_label 'Age'
+      c.width 5
+      c.show_last_point true
+      c.timespan 1200
+    end
+
+    p.line "Rhino average age", sensor: :rhino_average_age do |c|
+      c.redraw_interval 5
+      c.values_label 'Age'
+      c.width 5
+      c.show_last_point true
+      c.timespan 1200
+    end
+
+    p.area "Rhino & Lama average age comparison" do |c|
+      c.redraw_interval 5
+      c.values_label 'Age'
+      c.width 5
+      c.show_last_point true
+      c.timespan 1200
+
+      c.sensor :lama_average_age
+      c.sensor :rhino_average_age
+    end
+
+    p.pie "Rhino & Lama average age comparison" do |c|
+      c.redraw_interval 5
+      c.values_label 'Age'
+      c.width 5
+      c.show_last_point false
+      c.timespan 1200
+
+      c.sensor :lama_average_age
+      c.sensor :rhino_average_age
+    end
+
+    p.highchart_options({
+      chart: {
+        height: 300
+      }
+    })
+  end
+
+  l.use_utc false
+  l.outlier_color '#FF0000'
+  l.highchart_options({
+    tooltip: {
+      value_decimals: 2
+    }
+  })
+end
+
+run layout.to_app

data/examples/basic_sensor_data.rb

@@ -0,0 +1,38 @@
+$: << File.join(File.absolute_path(__FILE__), '..', 'lib')
+
+require "pulse-meter"
+
+PulseMeter.redis = Redis.new
+
+lama_counter = PulseMeter::Sensor::Timelined::Counter.new(:lama_count,
+  annotation: 'Lama Count',
+  interval: 10,
+  ttl: 3600
+)
+
+lama_average_age = PulseMeter::Sensor::Timelined::Average.new(:lama_average_age,
+  annotation: 'Lama Average Age',
+  interval: 20,
+  ttl: 3600
+)
+
+rhino_counter = PulseMeter::Sensor::Timelined::Counter.new(:rhino_count,
+  annotation: 'Rhino Count',
+  interval: 10,
+  ttl: 3600
+)
+
+rhino_average_age = PulseMeter::Sensor::Timelined::Average.new(:rhino_average_age,
+  annotation: 'Rhino average age',
+  interval: 20,
+  ttl: 3600
+)
+
+while true
+  sleep(Random.rand)
+  STDERR.puts "tick"
+  lama_counter.event(1)
+  rhino_counter.event(2)
+  lama_average_age.event(Random.rand(50))
+  rhino_average_age.event(Random.rand(100))
+end

data/examples/full/Procfile

@@ -0,0 +1,2 @@
+web: bundle exec rackup server.ru
+sensor_data_generator: bundle exec ruby client.rb

data/examples/full/client.rb

@@ -0,0 +1,82 @@
+$: << File.join(File.absolute_path(__FILE__), '..', '..', 'lib')
+
+require "pulse-meter"
+
+PulseMeter.redis = Redis.new
+
+requests_per_minute = PulseMeter::Sensor::Timelined::Counter.new(:requests_per_minute,
+  :annotation => 'Requests per minute',
+  :interval => 60,
+  :ttl => 60 * 60 * 24    # keep data one day
+)
+
+requests_per_hour =  PulseMeter::Sensor::Timelined::Counter.new(:requests_per_hour,
+  :annotation => 'Requests per hour',
+  :interval => 60 * 60,
+  :ttl => 60 * 60 * 24 * 30    # keep data 30 days
+  # when ActiveSupport extentions are loaded, a better way is to write just
+  # :interval => 1.hour,
+  # :ttl => 30.days
+)
+
+errors_per_minute = PulseMeter::Sensor::Timelined::Counter.new(:errors_per_minute,
+  :annotation => 'Errors per minute',
+  :interval => 60,
+  :ttl => 60 * 60 * 24
+)
+
+errors_per_hour =  PulseMeter::Sensor::Timelined::Counter.new(:errors_per_hour,
+  :annotation => 'Errors per hour',
+  :interval => 60 * 60,
+  :ttl => 60 * 60 * 24 * 30
+)
+
+longest_minute_request = PulseMeter::Sensor::Timelined::Max.new(:longest_minute_request,
+  :annotation => 'Longest minute requests',
+  :interval => 60,
+  :ttl => 60 * 60 * 24
+)
+
+shortest_minute_request = PulseMeter::Sensor::Timelined::Min.new(:shortest_minute_request,
+  :annotation => 'Shortest minute requests',
+  :interval => 60,
+  :ttl => 60 * 60 * 24
+)
+
+perc90_minute_request = PulseMeter::Sensor::Timelined::Percentile.new(:perc90_minute_request,
+  :annotation => 'Minute request 90-percent percentile',
+  :interval => 60,
+  :ttl => 60 * 60 * 24,
+  :p => 0.9
+)
+
+agent_names = [:ie, :firefox, :chrome, :other]
+hour_agents = agent_names.each_with_object({}) do |agent, h|
+  h[agent] = PulseMeter::Sensor::Timelined::Counter.new(agent,
+    :annotation => "Requests from #{agent} browser",
+    :interval => 60 * 60,
+    :ttl => 60 * 60 * 24 * 30
+  )
+end
+
+
+while true
+  requests_per_minute.event(1)
+  requests_per_hour.event(1)
+
+  if Random.rand(10) < 1 # let "errors" sometimes occur
+    errors_per_minute.event(1)
+    errors_per_hour.event(1)
+  end
+
+  request_time = 0.1 + Random.rand
+
+  longest_minute_request.event(request_time)
+  shortest_minute_request.event(request_time)
+  perc90_minute_request.event(request_time)
+
+  agent_counter = hour_agents[agent_names.shuffle.first]
+  agent_counter.event(1)
+
+  sleep(Random.rand / 10)
+end

data/examples/full/server.ru

@@ -0,0 +1,114 @@
+$: << File.join(File.absolute_path(__FILE__), '..', 'lib')
+
+require "pulse-meter/visualizer"
+
+PulseMeter.redis = Redis.new
+
+layout = PulseMeter::Visualizer.draw do |l|
+
+  # Application title
+  l.title "Full Example"
+
+  # Use local time for x-axis of charts
+  l.use_utc false
+
+  # Color for values cut off
+  l.outlier_color '#FF0000'
+
+  # Transfer some global parameters to Highcharts
+  l.highchart_options({
+    tooltip: {
+      value_decimals: 2
+    }
+  })
+
+  # Add some pages
+  l.page "Request count" do |p|
+
+    # Add chart  (of Highcharts `area' style, `spline', `pie' and `line' are also available)
+    p.area "Requests per minute" do |w|
+
+      # Plot :requests_per_minute values on this chart with black color
+      w.sensor :requests_per_minute, color: '#000000'
+
+      # Plot :errors_per_minute values on this chart with red color
+      w.sensor :errors_per_minute, color: '#FF0000'
+
+      # Plot values for the last hour
+      w.timespan 60 * 60
+
+      # Redraw chart every 10 seconds
+      w.redraw_interval 10
+
+      # Plot incomplete data
+      w.show_last_point true
+
+      # Meaning of the y-axis
+      w.values_label "Request count"
+
+      # Occupy half (5/10) of the page (horizontally)
+      w.width 5
+
+      # Transfer page-wide (and page-specific) options to Highcharts
+      p.highchart_options({
+        chart: {
+          height: 300
+        }
+      })
+    end
+
+    p.area "Requests per hour" do |w|
+
+      w.sensor :requests_per_hour, color: '#555555'
+      w.sensor :errors_per_hour, color: '#FF0000'
+
+      w.timespan 24 * 60 * 60
+      w.redraw_interval 10
+      w.show_last_point true
+      w.values_label "Request count"
+      w.width 5
+
+    end
+  end
+
+  l.page "Request times" do |p|
+    p.area "Requests time" do |w|
+
+      w.sensor :longest_minute_request
+      w.sensor :shortest_minute_request
+      w.sensor :perc90_minute_request
+
+      w.timespan 60 * 60
+      w.redraw_interval 10
+      w.show_last_point true
+      w.values_label "Time in seconds"
+      w.width 10
+
+    end
+  end
+
+  l.page "Browsers" do |p|
+    p.pie "Requests from browser" do |w|
+
+      [:ie, :firefox, :chrome, :other].each do |sensor|
+        w.sensor sensor
+      end
+
+      w.timespan 24 * 60 * 60
+      w.redraw_interval 10
+      w.show_last_point true
+      w.values_label "Request count"
+      w.width 10
+
+    end
+
+    p.highchart_options({
+      chart: {
+        height: 500
+      }
+    })
+  end
+
+end
+
+run layout.to_app

data/examples/minimal/Procfile

@@ -0,0 +1,2 @@
+web: bundle exec rackup server.ru
+sensor_data_generator: bundle exec ruby client.rb

data/examples/minimal/client.rb

@@ -0,0 +1,16 @@
+$: << File.join(File.absolute_path(__FILE__), '..', '..', 'lib')
+
+require "pulse-meter"
+
+PulseMeter.redis = Redis.new
+
+sensor = PulseMeter::Sensor::Timelined::Counter.new(:simple_sample_counter,
+  :interval => 5,
+  :ttl => 60 * 60
+)
+
+while true
+  STDERR.puts "tick"
+  sensor.event(1)
+  sleep(Random.rand)
+end

data/examples/minimal/server.ru

@@ -0,0 +1,20 @@
+$: << File.join(File.absolute_path(__FILE__), '..', 'lib')
+
+require "pulse-meter/visualizer"
+
+PulseMeter.redis = Redis.new
+
+layout = PulseMeter::Visualizer.draw do |l|
+
+  l.title "Minimal App"
+
+  l.page "Main Page" do |p|
+    p.area "Live Counter",
+      sensor: :simple_sample_counter,
+      timespan: 5 * 60,
+      redraw_interval: 1
+  end
+
+end
+
+run layout.to_app