drone 0.0.1

data/specs/unit/ewma_spec.rb

@@ -0,0 +1,138 @@
+require File.expand_path('../../common', __FILE__)
+
+require 'drone/utils/ewma'
+
+describe 'EWMA' do
+  
+  describe 'A 1min EWMA with a value of 3' do
+    before do
+      @ewma = EWMA.one_minute_ewma
+      @ewma.update(3)
+      @ewma.tick()
+    end
+    
+    
+    def mark_minutes(minutes)
+      1.upto( (minutes*60.0) / 5 ) do
+        @ewma.tick()
+      end
+    end
+    
+    should "have a rate of 0.6 events/sec after the first tick" do
+      @ewma.rate.should.be.close(0.6, 0.000001)
+    end
+    
+    {
+      1   => 0.22072766,
+      2   => 0.08120117,
+      3   => 0.02987224,
+      4   => 0.01098938,
+      5   => 0.00404277,
+      6   => 0.00148725,
+      7   => 0.00054713,
+      8   => 0.00020128,
+      9   => 0.00007405,
+      10  => 0.00002724,
+      11  => 0.00001002,
+      12  => 0.00000369,
+      13  => 0.00000136,
+      14  => 0.00000050,
+      15  => 0.00000018
+      
+    }.each do |minutes, expected|
+      should "have a rate of #{expected} events/sec after #{minutes} minute(s)" do
+        mark_minutes(minutes)
+        @ewma.rate.should.be.close(expected, 0.00000001)
+      end
+    end
+    
+  end
+  
+  
+  
+  describe 'A 5min EWMA with a value of 3' do
+    before do
+      @ewma = EWMA.five_minutes_ewma
+      @ewma.update(3)
+      @ewma.tick()
+    end
+    
+    should "have a rate of 0.6 events/sec after the first tick" do
+      @ewma.rate.should.be.close(0.6, 0.000001)
+    end
+    
+    def mark_minutes(minutes)
+      1.upto( (minutes*60.0) / 5 ) do
+        @ewma.tick()
+      end
+    end
+    
+    {
+      1  => 0.49123845,
+      2  => 0.40219203,
+      3  => 0.32928698,
+      4  => 0.26959738,
+      5  => 0.22072766,
+      6  => 0.18071653,
+      7  => 0.14795818,
+      8  => 0.12113791,
+      9  => 0.09917933,
+      10 => 0.08120117,
+      11 => 0.06648190,
+      12 => 0.05443077,
+      13 => 0.04456415,
+      14 => 0.03648604,
+      15 => 0.02987224
+    }.each do |minutes, expected|
+      should "have a rate of #{expected} events/sec after #{minutes} minute(s)" do
+        mark_minutes(minutes)
+        @ewma.rate.should.be.close(expected, 0.00000001)
+      end
+    end
+    
+  end
+  
+  
+  describe 'A 15min EWMA with a value of 3' do
+    before do
+      @ewma = EWMA.fifteen_minutes_ewma
+      @ewma.update(3)
+      @ewma.tick()
+    end
+    
+    should "have a rate of 0.6 events/sec after the first tick" do
+      @ewma.rate.should.be.close(0.6, 0.000001)
+    end
+    
+    def mark_minutes(minutes)
+      1.upto( (minutes*60.0) / 5 ) do
+        @ewma.tick()
+      end
+    end
+    
+    {
+      1   => 0.56130419,
+      2   => 0.52510399,
+      3   => 0.49123845,
+      4   => 0.45955700,
+      5   => 0.42991879,
+      6   => 0.40219203,
+      7   => 0.37625345,
+      8   => 0.35198773,
+      9   => 0.32928698,
+      10  => 0.30805027,
+      11  => 0.28818318,
+      12  => 0.26959738,
+      13  => 0.25221023,
+      14  => 0.23594443,
+      15  => 0.22072766
+    }.each do |minutes, expected|
+      should "have a rate of #{expected} events/sec after #{minutes} minute(s)" do
+        mark_minutes(minutes)
+        @ewma.rate.should.be.close(expected, 0.00000001)
+      end
+    end
+    
+  end
+  
+end

data/specs/unit/exponentially_decaying_sample_spec.rb

@@ -0,0 +1,83 @@
+require File.expand_path('../../common', __FILE__)
+
+require 'drone/utils/exponentially_decaying_sample'
+
+describe 'Exponentially Decaying Sample' do
+  describe "A sample of 100 out of 1000 elements" do
+    before do
+      @population = (0...100)
+      @sample = ExponentiallyDecayingSample.new(1000, 0.99)
+      @population.step(1){|n| @sample.update(n) }
+    end
+    
+
+    should "have 100 elements" do
+      @sample.size.should == 100
+      @sample.values.size.should == 100
+    end
+
+    should "only have elements from the population" do
+      arr = @sample.values - @population.to_a
+      arr.should == []
+    end
+    
+  end
+  
+  
+  describe "A sample of 100 out of 10 elements" do
+    before do
+      @population = (0...10)
+      @sample = ExponentiallyDecayingSample.new(100, 0.99)
+      @population.step(1){|n| @sample.update(n) }
+    end
+
+    should "have 10 elements" do
+      @sample.size.should == 10
+      @sample.values.size.should == 10
+    end
+
+    should "only have elements from the population" do
+      arr = @sample.values - @population.to_a
+      arr.should == []
+    end
+    
+  end
+  
+  
+  describe "A heavily-biased sample of 100 out of 1000 elements" do
+    before do
+      @population = (0...100)
+      @sample = ExponentiallyDecayingSample.new(1000, 0.99)
+      @population.step(1){|n| @sample.update(n) }
+    end
+
+    should "have 100 elements" do
+      @sample.size.should == 100
+      @sample.values.size.should == 100
+    end
+
+    should "only have elements from the population" do
+      arr = @sample.values - @population.to_a
+      arr.should == []
+    end
+    
+    should "rescale after 1 hour" do
+      @sample.expects(:rescale)
+      
+      Delorean.time_travel_to("2 hours from now") do
+        @sample.update(1)
+      end
+      
+      @sample.size.should == 101
+      @sample.values.size.should == 101
+    end
+    
+    it 'can rescale' do
+      @sample.rescale(Time.now)
+      @sample.values.should.not == []
+      # TODO: add a real test here, for now it only tests
+      # that the code actually runs
+    end
+  end
+  
+end

data/specs/unit/histogram_spec.rb

@@ -0,0 +1,87 @@
+require File.expand_path('../../common', __FILE__)
+
+require 'drone/metrics/histogram'
+
+include Drone
+
+describe 'Histogram' do
+  describe "A histogram with zero recorded valeus" do
+    before do
+      @histogram = Histogram.new(UniformSample.new(100))
+    end
+
+    should "have a count of 0" do
+      @histogram.count.should == 0
+    end
+
+    should "have a max of 0" do
+      @histogram.max.should == 0
+    end
+
+    should "have a min of 0" do
+      @histogram.min.should == 0
+    end
+
+    should "have a mean of 0" do
+      @histogram.mean.should == 0.0
+    end
+
+    should "have a standard deviation of 0" do
+      @histogram.stdDev.should == 0
+    end
+
+    should "calculate percentiles" do
+      percentiles = @histogram.percentiles(0.5, 0.75, 0.99)
+    
+      percentiles[0].should.be.close?(0, 0.01)
+      percentiles[1].should.be.close?(0, 0.01)
+      percentiles[2].should.be.close?(0, 0.01)
+    end
+    
+    should "have no values" do
+      @histogram.values.should == []
+    end
+  end
+  
+  
+  describe "A histogram of the numbers 1 through 10000" do
+    before do
+      @histogram = Histogram.new( UniformSample.new(100000) )
+      (1..10000).each{|n| @histogram.update(n) }
+    end
+
+    should "have a count of 10000" do
+      @histogram.count.should == 10000
+    end
+
+    should "have a max value of 10000" do
+      @histogram.max.should == 10000
+    end
+
+    should "have a min value of 1" do
+      @histogram.min.should == 1
+    end
+
+    should "have a mean value of 5000.5" do
+      @histogram.mean.should.be.close?(5000.5, 0.01)
+    end
+
+    should "have a standard deviation of X" do
+      @histogram.stdDev.should.be.close?(2886.89, 0.1)
+    end
+
+    should "calculate percentiles" do
+      percentiles = @histogram.percentiles(0.5, 0.75, 0.99)
+
+      percentiles[0].should.be.close?(5000.5, 0.01)
+      percentiles[1].should.be.close?(7500.75, 0.01)
+      percentiles[2].should.be.close?(9900.99, 0.01)
+    end
+
+    should "have 10000 values" do
+      @histogram.values.should == (1..10000).to_a
+      # histogram.values.toList must beEqualTo((1 to 10000).toList)
+    end
+  end
+  
+end

data/specs/unit/monitoring_spec.rb

@@ -0,0 +1,129 @@
+require File.expand_path('../../common', __FILE__)
+
+require 'drone'
+require 'drone/monitoring'
+
+EM.describe 'Monitoring' do
+  describe 'rate monitor' do
+    before do
+      
+      Drone::init_drone()
+      
+      @klass = Class.new() do
+        include Drone::Monitoring
+        
+        monitor_rate("users/no_args")
+        def a_method_without_args; 42; end
+        
+        monitor_rate("users/with_args")
+        def method_with_args(a, b); a + b; end
+        
+        monitor_rate("users/with_block")
+        def method_with_block(&block); block.call; end
+        
+      end
+      @obj = @klass.new
+      
+    end
+    
+    should 'reuse same meter for every instances of this class' do
+      meter = Drone::find_metric("users/no_args")
+      meter.count.should == 0
+      
+      obj1 = @klass.new
+      obj2 = @klass.new
+      
+      obj1.a_method_without_args()
+      meter.count.should == 1
+      
+      obj2.a_method_without_args()
+      meter.count.should == 2
+      
+      done
+    end
+    
+    should 'increment counter on call' do
+      Drone::Metrics::Meter.any_instance.expects(:mark)
+      
+      ret = @obj.a_method_without_args()
+      ret.should == 42
+      done
+    end
+    
+    should 'be transparent for method with arguments' do
+      Drone::Metrics::Meter.any_instance.expects(:mark)
+      
+      ret = @obj.method_with_args(4, 5)
+      ret.should == 9
+      done
+    end
+    
+    should 'be transparent for method with block argument' do
+      Drone::Metrics::Meter.any_instance.expects(:mark)
+      
+      ret = @obj.method_with_block(){ 32 }
+      ret.should == 32
+      done
+    end
+    
+  end
+  
+  
+  describe 'timing monitor' do
+    before do
+      
+      Drone::init_drone()
+      
+      klass = Class.new() do
+        include Drone::Monitoring
+        
+        monitor_time("users/no_args")
+        def a_method_without_args; 42; end
+        
+        monitor_time("users/with_args")
+        def method_with_args(a, b); a + b; end
+        
+        monitor_time("users/with_block")
+        def method_with_block(&block); block.call; end
+        
+      end
+      @obj = klass.new
+      
+    end
+    
+    should 'time call with no args' do
+      Drone::Metrics::Timer.any_instance.expects(:update).with{|delay|
+          delay.should.be.close?(0, 0.001)
+          true
+        }
+      
+      ret = @obj.a_method_without_args()
+      ret.should == 42
+      done
+    end
+    
+    should 'time call with args' do
+      Drone::Metrics::Timer.any_instance.expects(:update).with{|delay|
+          delay.should.be.close?(0, 0.001)
+          true
+        }
+      
+      ret = @obj.method_with_args(2, 4)
+      ret.should == 6
+      done
+    end
+    
+    should 'time call with a block' do
+      Drone::Metrics::Timer.any_instance.expects(:update).with{|delay|
+          delay.should.be.close?(0, 0.001)
+          true
+        }
+      
+      ret = @obj.method_with_block(){ 42 }
+      ret.should == 42
+      done
+    end
+    
+  end
+  
+end

data/specs/unit/uniform_sample_spec.rb

@@ -0,0 +1,43 @@
+require File.expand_path('../../common', __FILE__)
+
+require 'drone/utils/uniform_sample'
+
+describe 'EWMA' do
+  describe "A sample of 100 out of 1000 elements" do
+    before do
+      @population = (0...1000)
+      @sample = UniformSample.new(100)
+      @population.step(1){|n| @sample.update(n) }
+    end
+
+    should "have 100 elements" do
+      @sample.size.should == 100
+      @sample.values.size.should == 100
+    end
+
+    should "only have elements from the population" do
+      arr = @sample.values - @population.to_a
+      arr.should == []
+    end
+  end
+  
+  describe "A sample of 100 out of 10 elements" do
+    before do
+      @population = (0...10)
+      @sample = UniformSample.new(100)
+      @population.step(1){|n| @sample.update(n) }
+    end
+
+    should "have 10 elements" do
+      @sample.size.should == 10
+      @sample.values.size.should == 10
+    end
+
+    should "only have elements from the population" do
+      arr = @sample.values - @population.to_a
+      arr.should == []
+    end
+  end
+  
+end
+