yam-ruby-metrics 0.8.6

data/spec/integration/rack_endpoint_spec.rb

@@ -0,0 +1,60 @@
+require "rack/test"
+
+describe Metrics::Integration::Rack::Endpoint do
+  include Rack::Test::Methods
+  
+  def app(options = {})
+    @app ||= Metrics::Integration::Rack::Endpoint.new(options)
+  end
+  def agent
+    app.agent
+  end
+  
+  it "should show stats" do
+    get "/"
+    last_response.should be_ok
+    last_response.body.should == agent.to_json
+  end
+  
+  context "configuring" do
+    
+    context "agent" do
+      it "should create an agent by default" do
+        app(:agent => nil)
+        agent.should be_a(Metrics::Agent)
+      end
+      
+      it "should use an agent if provided" do
+        @agent = Metrics::Agent.new
+        app(:agent => @agent)
+        agent.should be_a(Metrics::Agent)
+        agent.should == @agent
+      end
+    end
+    
+    context "show" do
+      it "should match a string to the PATH_INFO exactly" do
+        app(:show => "/foo")
+        get '/foo'
+        last_response.should be_ok
+        last_response.body.should == agent.to_json
+      end
+      
+      it "should match a regular expression to the PATH_INFO" do
+        app(:show => /bar/)
+        get '/foobarbaz'
+        last_response.should be_ok
+        last_response.body.should == agent.to_json
+      end
+      
+      it "should call `call` on the show option if it responds to it" do
+        app(:show => lambda{ |env| env['PATH_INFO'] == "/bing" })
+        get '/bing'
+        last_response.should be_ok
+        last_response.body.should == agent.to_json
+      end
+    end
+    
+  end
+  
+end

data/spec/integration/rack_middleware_spec.rb

@@ -0,0 +1,129 @@
+require "rack/test"
+
+describe Metrics::Integration::Rack::Middleware do
+  include Rack::Test::Methods
+  
+  def app(status = 200, body = ["Hello, World!"], headers = {})
+    @app ||= lambda{ |env| [status, {'Content-Type' => 'text/plain', 'Content-Length' => body.to_s.size.to_s}.merge(headers), body] }
+  end
+  alias_method :original_app, :app
+  
+  describe "without integration" do
+    it "should work normally" do
+      get "/"
+      
+      last_response.should be_ok
+      last_response.body.should == "Hello, World!"
+    end
+  end
+  
+  describe "with integration" do
+    def app(options = {})
+      @integrated_app ||= Metrics::Integration::Rack::Middleware.new(original_app, options)
+    end
+    def agent
+      app.agent
+    end
+    
+    it "should work normally" do
+      get "/"
+      
+      last_response.should be_ok
+      last_response.body.should == "Hello, World!"
+    end
+    
+    it "should show stats for default endpoint" do
+      get "/stats"
+      last_response.should be_ok
+      last_response.body.should == agent.to_json
+    end
+    
+    it "should make 'metrics.agent' available to the upstream environment" do
+      @app = lambda do |env|
+        env['metrics.agent'].should be_a(Metrics::Agent)
+        env['metrics.agent'].should == agent
+        [200, {}, []]
+      end
+      
+      get '/'
+      last_response.should be_ok
+    end
+    
+    describe "integration metrics" do
+      
+      it "should count all requests" do
+        lambda do
+          get '/'
+        end.should change{ app.requests.count }.by(1)
+      end
+      
+      it "should count uncaught exceptions" do
+        @app = lambda{ |env| raise }
+        lambda do
+          lambda do
+            get '/'
+          end.should raise_error
+        end.should change{ app.uncaught_exceptions.to_i }.by(1)
+      end
+      
+      it "should time request length" do
+        length = 0.1
+        @app = lambda{ |env| sleep(length); [200, {}, ['']] }
+        get '/'
+        app.requests.mean.should be_within(length / 10).of(length)
+      end
+      
+      [ 200, 304, 404, 500].each do |status|
+        it "should count #{status} HTTP status code as #{status / 100}xx" do
+          @app = lambda{ |env| [status, {}, []] }
+          lambda do
+            get '/'
+          end.should change{ app.status_codes[status / 100].to_i }.by(1)
+        end
+      end
+      
+    end
+    
+    context "configuring" do
+      
+      context "agent" do
+        it "should create an agent by default" do
+          app(:agent => nil)
+          agent.should be_a(Metrics::Agent)
+        end
+        
+        it "should use an agent if provided" do
+          @agent = Metrics::Agent.new
+          app(:agent => @agent)
+          agent.should be_a(Metrics::Agent)
+          agent.should == @agent
+        end
+      end
+      
+      context "show" do
+        it "should match a string to the PATH_INFO exactly" do
+          app(:show => "/foo")
+          get '/foo'
+          last_response.should be_ok
+          last_response.body.should == agent.to_json
+        end
+        
+        it "should match a regular expression to the PATH_INFO" do
+          app(:show => /bar/)
+          get '/foobarbaz'
+          last_response.should be_ok
+          last_response.body.should == agent.to_json
+        end
+        
+        it "should call `call` on the show option if it responds to it" do
+          app(:show => lambda{ |env| env['PATH_INFO'] == "/bing" })
+          get '/bing'
+          last_response.should be_ok
+          last_response.body.should == agent.to_json
+        end
+      end
+      
+    end
+  end
+  
+end

data/spec/integration/webrick_spec.rb

@@ -0,0 +1,18 @@
+require "rack/test"
+
+describe Metrics::Integration::WEBrick do
+  
+  it "should start the WEBrick thread" do
+    Thread.stub!(:new).and_return do |block|
+      block.call
+    end
+    
+    mock_server = mock(WEBrick::HTTPServer)
+    WEBrick::HTTPServer.should_receive(:new).and_return mock_server
+    mock_server.should_receive(:mount)
+    mock_server.should_receive(:start)
+    
+    Metrics::Integration::WEBrick.start
+  end
+  
+end

data/spec/spec_helper.rb

@@ -0,0 +1,18 @@
+require 'simplecov'
+
+SimpleCov.start do
+  add_filter "/spec/"
+  add_group "Instruments", "metrics/instruments"
+  add_group "Statistical Samples", "metrics/statistics"
+  merge_timeout 3600
+end
+
+$:.unshift(File.expand_path('../../lib', __FILE__))
+require 'ruby-metrics'
+
+Metrics.logger = Logger.new(STDERR)
+Metrics.logger.level = Logger::INFO
+
+RSpec.configure do |config|
+  config.mock_with :rspec
+end

data/spec/statistics/exponential_sample_spec.rb

@@ -0,0 +1,138 @@
+require 'spec_helper'
+
+describe Metrics::Statistics::ExponentialSample do
+  before(:each) do
+  end
+  
+  it "should have a size equal 0 intially no matter to the initialization parameter" do 
+    sample = Metrics::Statistics::ExponentialSample.new(100)
+    sample.size.should == 0
+    
+  end
+  
+  it "should have an empty backing hash initially" do
+    sample = Metrics::Statistics::ExponentialSample.new(100)
+    sample.values.length.should == 0
+  end
+  
+  
+  context "A sample of 100 out of 1000 elements" do
+    before(:each) do
+      @population = (0..99).to_a
+      @sample =  Metrics::Statistics::ExponentialSample.new(1000, 0.99)
+      @population.each do |datum|
+        @sample.update(datum)
+      end
+    end
+    
+    it "should have 100 elements" do
+      @sample.size.should == 100
+      @sample.values.length.should == 100
+    end
+
+    it "should only have elements from the population" do
+      values = @sample.values
+      @population.each do |datum|
+        values.should include datum
+      end
+    end
+  end
+
+  context "A heavily-biased sample of 100 out of 1000 elements" do
+    before(:each) do
+      @population = (0..99).to_a
+      @sample =  Metrics::Statistics::ExponentialSample.new(1000, 0.01)
+      @population.each do |datum| 
+        @sample.update(datum)
+      end
+    end
+
+    it "should have 100 elements" do
+      @sample.size.should == 100
+      @sample.values.length.should == 100
+    end
+
+    it "should only have elements from the population" do
+      values = @sample.values
+      @population.each do |datum|
+        values.should include datum
+      end
+    end
+    
+    it "should add another element when updating" do 
+      @sample.update(42)
+      @sample.size.should == 101
+      @sample.values.should include 42
+    end
+    
+    it "should rescale when the clock is one hour in the future or more" do 
+      future_time = Time.now + (60 * 60)
+      Time.stub(:now).and_return future_time
+      @sample.update(42)
+      @sample.size.should == 101
+      
+      values = @sample.values
+      
+      @population.each do |datum|
+        values.should include datum
+      end
+      
+      values.should include 42
+    end
+  end
+  
+  context "A heavily-biased sample of 1000 out of 1000 elements" do
+    before(:each) do
+      @population = (0..999).to_a
+      @sample =  Metrics::Statistics::ExponentialSample.new(1000, 0.01)
+      @population.each do |datum| 
+        @sample.update(datum)
+      end
+    end
+    
+    it "should have 1000 elements" do
+      @sample.size.should == 1000
+      @sample.values.length.should == 1000
+    end
+
+    it "should only have elements from the population" do
+      values = @sample.values
+      @population.each do |datum|
+        values.should include datum
+      end
+    end
+    
+    it "should replace an element when updating" do 
+      @sample.update(4242)
+      @sample.size.should == 1000
+      @sample.values.should include 4242
+    end
+    
+    it "should rescale so that newer events are higher in priority in the hash" do 
+      future_time = Time.now + (60 * 60)
+      Time.stub(:now).and_return future_time
+      
+      @sample.update(2121)
+      
+
+      @sample.size.should == 1000
+
+      future_time = Time.now + (60 * 60 * 2)
+      Time.stub(:now).and_return future_time
+      
+      @sample.update(4242)      
+      @sample.size.should == 1000
+      
+      values = @sample.values
+      
+      values.length.should == 1000
+      values.should include 4242
+      values.should include 2121
+      
+      # Most recently added values in time should be at the end with the highest priority
+      values[999].should == 4242
+      values[998].should == 2121
+    end
+  end
+  
+end

data/spec/statistics/uniform_sample_spec.rb

@@ -0,0 +1,59 @@
+require 'spec_helper'
+
+describe Metrics::Statistics::UniformSample do
+  before(:each) do
+  end
+  
+  it "should have a size equal to the initialization parameter" do 
+    sample = Metrics::Statistics::UniformSample.new(100)
+    sample.size.should == 100
+    
+  end
+  
+  it "should allocate an array of the requested size" do
+    sample = Metrics::Statistics::UniformSample.new(100)
+    sample.values.length.should == 100
+    
+    sample.values.each do |value|
+      value.should == 0
+    end
+  end
+  
+  it "should update at the end of the list" do
+    sample = Metrics::Statistics::UniformSample.new(100)
+    (1..100).each do |i|
+      sample.update(i)
+    end
+    
+    values = sample.values
+    
+    (0..99).each do |index|
+      values[index].should == (index + 1)
+    end
+  end
+  
+  it "should update a random entry in the list when it's full" do
+    
+    sample = Metrics::Statistics::UniformSample.new(100)
+    sample.should_receive(:rand).with(any_args()).and_return(50)
+
+    (1..101).each do |i|
+      sample.update(i)
+    end
+    
+    values = sample.values
+    
+    (0..49).each do |index|
+      values[index].should == (index + 1)
+    end
+    
+    values[50].should == 101
+    
+    (51..99).each do |index|
+      values[index].should == (index + 1)
+    end
+    
+  end
+  
+  
+end

data/spec/time_units_spec.rb

@@ -0,0 +1,13 @@
+require 'spec_helper'
+
+describe Metrics::TimeUnit do
+  it "should raise NotImplementedError for #to_nsec" do
+    begin
+      Metrics::TimeUnit.to_nsec
+    rescue NotImplementedError
+      true
+    else
+      fail
+    end
+  end
+end

metadata

@@ -0,0 +1,184 @@
+--- !ruby/object:Gem::Specification 
+name: yam-ruby-metrics
+version: !ruby/object:Gem::Version 
+  hash: 51
+  prerelease: 
+  segments: 
+  - 0
+  - 8
+  - 6
+  version: 0.8.6
+platform: ruby
+authors: 
+- John Ewart
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-11-16 00:00:00 -08:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: json
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: simplecov
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        - 3
+        - 8
+        version: 0.3.8
+  type: :development
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: rack-test
+  prerelease: false
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id004
+description: A Ruby implementation of metrics inspired by @coda's JVM metrics for those of us in Ruby land
+email: 
+- john@johnewart.net
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .bundle/config
+- .gitignore
+- .rvmrc
+- CHANGELOG.md
+- Gemfile
+- Gemfile.lock
+- LICENSE
+- README.md
+- Rakefile
+- autotest/discover.rb
+- examples/counter.rb
+- examples/gauge.rb
+- examples/histogram.rb
+- examples/integration/rack_endpoint.ru
+- examples/integration/rack_middleware.ru
+- examples/integration/webrick.rb
+- examples/meter.rb
+- examples/timer.rb
+- lib/ruby-metrics.rb
+- lib/ruby-metrics/agent.rb
+- lib/ruby-metrics/instruments/counter.rb
+- lib/ruby-metrics/instruments/gauge.rb
+- lib/ruby-metrics/instruments/histogram.rb
+- lib/ruby-metrics/instruments/meter.rb
+- lib/ruby-metrics/instruments/timer.rb
+- lib/ruby-metrics/integration.rb
+- lib/ruby-metrics/integration/rack_endpoint.rb
+- lib/ruby-metrics/integration/rack_middleware.rb
+- lib/ruby-metrics/integration/webrick.rb
+- lib/ruby-metrics/logging.rb
+- lib/ruby-metrics/statistics/exponential_sample.rb
+- lib/ruby-metrics/statistics/uniform_sample.rb
+- lib/ruby-metrics/time_units.rb
+- lib/ruby-metrics/version.rb
+- ruby-metrics.gemspec
+- spec/agent_spec.rb
+- spec/instruments/counter_spec.rb
+- spec/instruments/gauge_spec.rb
+- spec/instruments/histogram_spec.rb
+- spec/instruments/meter_spec.rb
+- spec/instruments/timer_spec.rb
+- spec/integration/rack_endpoint_spec.rb
+- spec/integration/rack_middleware_spec.rb
+- spec/integration/webrick_spec.rb
+- spec/spec_helper.rb
+- spec/statistics/exponential_sample_spec.rb
+- spec/statistics/uniform_sample_spec.rb
+- spec/time_units_spec.rb
+has_rdoc: true
+homepage: https://github.com/johnewart/ruby-metrics
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: yam-ruby-metrics
+rubygems_version: 1.5.2
+signing_key: 
+specification_version: 3
+summary: Metrics for Ruby
+test_files: 
+- spec/agent_spec.rb
+- spec/instruments/counter_spec.rb
+- spec/instruments/gauge_spec.rb
+- spec/instruments/histogram_spec.rb
+- spec/instruments/meter_spec.rb
+- spec/instruments/timer_spec.rb
+- spec/integration/rack_endpoint_spec.rb
+- spec/integration/rack_middleware_spec.rb
+- spec/integration/webrick_spec.rb
+- spec/spec_helper.rb
+- spec/statistics/exponential_sample_spec.rb
+- spec/statistics/uniform_sample_spec.rb
+- spec/time_units_spec.rb