leafy-metrics 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 32f03a451482abd7703260a77742d3e6673fa1f6
+  data.tar.gz: 353a861b96966a5b6c57103e6342de7360db0ecf
+SHA512:
+  metadata.gz: 4c7af7eebe97349d2c17327efe778fa8d84f078fda748b3258a83284ad33579da965b7429c6cad0b3d8589aa048fd8dec88a8a95da9c92e66f5fd3c76d402376
+  data.tar.gz: e974467905d84881a2213ede5ccef40bed73de429046080b5a7def0a305ff174ecaceedd8bf6c413801f95ce001dfb05b0fd93d3f12549079cccc5c29dc2ef33

data/.gitignore

@@ -0,0 +1,5 @@
+.yardoc
+doc
+pkg
+*.lock
+*.jar

data/Gemfile

@@ -0,0 +1,7 @@
+#-*- mode: ruby -*-
+
+source 'https://rubygems.org'
+
+gemspec
+
+# vim: syntax=Ruby

data/LICENSE

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 Lookout
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

data/README.md

@@ -0,0 +1,183 @@
+# Leafy-Metrics
+
+## installation
+
+via rubygems
+```
+gem install leafy-metrics
+```
+or add to your Gemfile
+```
+gem 'leafy-metrics'
+```
+
+installing the gem also takes care of the jar dependencies with jruby-1.7.16+
+
+## usage
+
+an instance of the registry ```Leafy::Metrics::Registry``` can register various metrics like gauge, timer, meter, counter and histogram and remove them again.
+
+     registry = Leafy::Metrics::Registry.new
+
+### gauge
+
+it can be other a given block or any object with a #call method returning the gauge - a number
+     
+    registry.register_gauge( 'app.uptime') do
+	  App.uptime
+	end
+
+or with an object
+
+    class UptimeGauge
+	  def call
+	    App.uptime
+      enf
+	end
+	registry.register_gauge( 'app.uptime', UptimeGauge.new )
+
+### timer
+
+a timer can measure the time an block needs to execute:
+
+    timer = registry.register_timer( 'app.timer' )
+	timer.time do
+      App.update_data
+    end
+
+### counter
+
+a counter simply counts i.e. can be incremented or decremented
+
+    counter = registry.register_counter( 'active.users.counter' )
+
+	# one new user logged on
+	counter.inc
+	
+	# three new users logged on
+	counter.inc 3
+	
+    # one user logged off
+    counter.dec
+
+    # two users logged off
+    counter.dec 2
+
+### meter
+
+    used = registry.register_meter( 'app.used' )
+
+mark the occurrence of an event
+
+	used.mark
+
+mark the occurrence of 'n' events
+
+	used.mark n
+
+
+### histogram
+
+measures the distribution of values in a stream of data using an exponentially decaying reservoir
+
+    histogram = registry.register_histogram( 'search.results' )
+    histogram.update( Search.last_result.size )
+
+### remove any metrics
+
+    registry.unregister( 'app.uptime )
+
+### note
+
+currently there is not further introspection on the registry and its health-check. with the ```Leafy::Json::MetricsWriter``` (from leafy-rack) you can get a json representation of the current **metrics report**
+
+    Leafy::Json::MetricsWriter.to_json( registry.metrics )
+
+## reporters
+
+all reporters use a builder pattern. there are following timeunits for
+configuration:
+
+* ```Leafy::Metrics::Reporter::DAYS```
+* ```Leafy::Metrics::Reporter::HOURS```
+* ```Leafy::Metrics::Reporter::MINUTES```
+* ```Leafy::Metrics::Reporter::SECONDS```
+* ```Leafy::Metrics::Reporter::MILLISECONDS```
+* ```Leafy::Metrics::Reporter::MICROSECONDS```
+* ```Leafy::Metrics::Reporter::NANOSECONDS```
+
+in all examples below ```metrics = Leafy::Metrics::Registry.new```
+
+### console reporter
+
+    require 'leafy/metrics/console_reporter'
+    reporter = Leafy::Metrics::ConsoleReporter.for_registry( metrics ).build
+	reporter.start( 1, Leafy::Metrics::Reporter::SECONDS )
+	....
+	reporter.stop
+
+or with all the possible configuration
+
+	reporter = Leafy::Metrics::ConsoleReporter.for_registry( metrics )
+	    .convert_rates_to( Leafy::Metrics::Reporter::MILLISECONDS )
+        .convert_durations_to( Leafy::Metrics::Reporter::MILLISECONDS )
+        .output_to( STDERR )
+        .build
+
+### csv reporter
+
+for each metric there will be a CSV file inside a given directory
+
+    require 'leafy/metrics/csv_reporter'
+    reporter = Leafy::Metrics::CSVReporter.for_registry( metrics )
+	    .build( 'metrics/directory' )
+	reporter.start( 1, Leafy::Metrics::Reporter::SECONDS )
+	....
+	reporter.stop
+
+or with all possible configuration
+
+	reporter = Leafy::Metrics::CSVReporter.for_registry( metrics )
+	    .convert_rates_to( Leafy::Metrics::Reporter::MILLISECONDS )
+        .convert_durations_to( Leafy::Metrics::Reporter::MILLISECONDS )
+        .build( 'metrics/directory' )
+
+### graphite reporter
+
+there are three targets where to send the data
+
+* ```Leafy::Metrics::Graphite.new_tcp( hostname, port )```
+* ```Leafy::Metrics::Graphite.new_udp( hostname, port )```
+* ```Leafy::Metrics::Graphite.new_pickled( hostname, port, batchsize )```
+
+the latter is collecting a few report event and sends them as batch. the ```sender``` is one of the above targets.
+
+    require 'leafy/metrics/graphite_reporter'
+    reporter = Leafy::Metrics::GraphiteReporter.for_registry( metrics )
+	    .build( sender )
+	reporter.start( 1, Leafy::Metrics::Reporter::SECONDS )
+	....
+	reporter.stop
+
+or with full configuration
+
+	reporter = Leafy::Metrics::GraphiteReporter.for_registry( metrics )
+	    .convert_rates_to( Leafy::Metrics::Reporter::MILLISECONDS )
+        .convert_durations_to( Leafy::Metrics::Reporter::MILLISECONDS )
+		.prefixed_with( 'myapp' )
+        .build( sender )
+
+## developement
+
+get all the gems and jars in place
+
+    gem install jar-dependencies --development
+	bundle install
+
+for running all specs
+
+	rake
+
+or
+
+    rspec spec/reporter_spec.rb

data/Rakefile

@@ -0,0 +1,14 @@
+#-*- mode: ruby -*-
+
+require "rspec/core/rake_task"
+RSpec::Core::RakeTask.new
+
+require "yard"
+YARD::Rake::YardocTask.new do |t|
+  t.files   = ['lib/**/*.rb']
+  t.options += ["--title", "Leafy Metrics API"]
+end
+
+task :default => [ :spec ]
+
+# vim: syntax=Ruby

data/leafy-metrics.gemspec

@@ -0,0 +1,29 @@
+#-*- mode: ruby -*-
+
+require File.expand_path( '../lib/leafy/metrics/version', __FILE__ )
+
+Gem::Specification.new do |s|
+  s.name = 'leafy-metrics'
+  s.version = Leafy::Metrics::VERSION
+  s.author = 'christian meier'
+  s.email = [ 'christian.meier@lookout.com' ]
+  
+  s.license = 'MIT'
+  s.summary = %q(provide an API to register metrics)
+  s.homepage = 'https://github.com/lookout/leafy'
+  s.description = %q(provides an API to register metrics like meters, timers, gauge, counter using dropwizard-metrics. it also allows to setup reporters: console-reporter, csv-reporter and graphite-reporter)
+  
+  s.files = `git ls-files`.split($/)
+
+  METRICS_VERSION = '3.1.0'
+  s.requirements << "jar io.dropwizard.metrics:metrics-core, #{METRICS_VERSION}"
+  s.requirements << "jar io.dropwizard.metrics:metrics-graphite, #{METRICS_VERSION}"
+  s.requirements << "jar org.slf4j, slf4j-simple, 1.7.7, :scope => :test"
+
+  s.add_runtime_dependency 'jar-dependencies', '~> 0.1.8'
+  s.add_development_dependency 'rspec', '~> 3.1.0'
+  s.add_development_dependency 'yard', '~> 0.8.7'
+  s.add_development_dependency 'rake', '~> 10.2'
+end
+
+# vim: syntax=Ruby

data/lib/leafy-metrics.rb

@@ -0,0 +1,2 @@
+require 'leafy-metrics_jars'
+require 'leafy/metrics/registry'

data/lib/leafy-metrics_jars.rb

@@ -0,0 +1,5 @@
+require 'jar_dependencies'
+
+require_jar( 'io.dropwizard.metrics', 'metrics-graphite', '3.1.0' )
+require_jar( 'org.slf4j', 'slf4j-api', '1.7.7' )
+require_jar( 'io.dropwizard.metrics', 'metrics-core', '3.1.0' )

data/lib/leafy/metrics.rb

@@ -0,0 +1,2 @@
+require 'leafy-metrics_jars'
+require 'leafy/metrics/registry'

data/lib/leafy/metrics/console_reporter.rb

@@ -0,0 +1,32 @@
+require 'leafy/metrics/reporter'
+
+java_import com.codahale.metrics.ConsoleReporter
+
+module Leafy
+  module Metrics
+    class ConsoleReporter < Reporter
+
+      class Builder < Reporter::Builder
+        def initialize( metrics )
+          super( ::ConsoleReporter, metrics )
+        end
+        
+        def output_to( io )
+          # IO objects in jruby do have a to_outputstream method
+          @io = java.io.PrintStream.new( io.to_outputstream )
+          @builder.output_to( @io )
+          self
+        end
+        
+        def build
+          Reporter.new( @builder.build )
+        end
+      end
+
+      def self.for_registry( metrics )
+        Builder.new( metrics )
+      end
+    end
+  end
+end
+

data/lib/leafy/metrics/csv_reporter.rb

@@ -0,0 +1,26 @@
+require 'leafy/metrics/reporter'
+
+java_import com.codahale.metrics.CsvReporter
+
+module Leafy
+  module Metrics
+    class CSVReporter < Reporter
+
+      class Builder < Reporter::Builder
+        def initialize( metrics )
+          super( ::CsvReporter, metrics )
+        end
+        
+        def build( directory )
+          directory = java.io.File.new( directory )
+          Reporter.new( @builder.build( directory ) )
+        end
+      end
+
+      def self.for_registry( metrics )
+        Builder.new( metrics )
+      end
+    end
+  end
+end
+

data/lib/leafy/metrics/graphite/graphite.rb

@@ -0,0 +1,28 @@
+module Leafy
+  module Metrics
+    class Graphite
+
+      attr_reader :sender
+
+      def initialize( sender )
+        unless sender.java_kind_of? Java::ComCodahaleMetricsGraphite::GraphiteSender
+          raise "not instance of 'Java::ComCodahaleMetricsGraphite::Graphite'"
+        end
+        @sender = sender
+      end
+  
+      def self.new_tcp( hostname, port )
+        new com.codahale.metrics.graphite.Graphite.new( hostname, port )
+      end
+
+      def self.new_udp( hostname, port )
+        new com.codahale.metrics.graphite.GraphiteUDP.new( hostname, port )
+      end
+
+      def self.new_pickled( hostname, port, batchsize )
+        new com.codahale.metrics.graphite.PickledGraphite.new( hostname, port, batchsize )
+      end
+    end
+  end
+end
+

data/lib/leafy/metrics/graphite/graphite_reporter.rb

@@ -0,0 +1,31 @@
+require 'leafy/metrics/reporter'
+require 'leafy/metrics/graphite/graphite'
+
+java_import com.codahale.metrics.graphite.GraphiteReporter
+
+module Leafy
+  module Metrics
+    class GraphiteReporter < Reporter
+
+      class Builder < Reporter::Builder
+        def initialize( metrics )
+          super( ::GraphiteReporter, metrics )
+        end
+        
+        def prefixed_with( prefix )
+          @builder.prefixed_with( prefix )
+          self
+        end
+
+        def build( graphite )
+          Reporter.new( @builder.build( graphite.sender ) )
+        end
+      end
+
+      def self.for_registry( metrics )
+        Builder.new( metrics )
+      end
+    end
+  end
+end
+

data/lib/leafy/metrics/registry.rb

@@ -0,0 +1,96 @@
+require 'leafy/metrics'
+module Leafy
+  module Metrics
+    class Registry
+
+      class Timer
+
+        attr_reader :timer
+
+        def initialize( timer )
+          @timer = timer
+        end
+        
+        def time( &block )
+          context = @timer.time
+          
+          yield
+          
+        ensure
+          context.stop
+        end
+      end
+      
+      class Gauge
+        include com.codahale.metrics.Gauge
+        
+        def initialize( block )
+          @block = block
+        end
+        
+        def value
+          @block.call
+        end
+      end
+
+      # state ofthe registry
+      attr_reader :metrics
+      
+      def initialize
+        @metrics = com.codahale.metrics.MetricRegistry.new
+      end
+      
+      # register a gauge under a given name
+      # 
+      # @param [String] name
+      # @param [String] instead of block any gauge object which responds to 'call'
+      # @yieldreturn [Object] can be any object like Fixnum, String, Float
+      # @return [MetricsRegistry::Gauge] gauge object which has a 'value' method to retrieve the current value
+      def register_gauge( name, gauge = nil, &block )
+        if gauge and not block_given? and gauge.respond_to? :call
+          @metrics.register( name, Gauge.new( gauge ) )      
+        elsif gauge.nil? and block_given?
+          @metrics.register( name, Gauge.new( block ) )
+        else
+          raise 'needs either a block and object with call method'
+        end
+      end
+      
+      # register a meter under a given name
+      # 
+      # @param [String] name
+      # @return [Java::ComCodahaleMetrics::Meter] meter object which has a 'mark' method to mark the meter
+      def register_meter( name )
+        @metrics.meter( name )
+      end
+      
+      # register a counter under a given name
+      # 
+      # @param [String] name
+      # @return [Java::ComCodahaleMetrics::Counter] counter object which has an 'inc' and 'dec' method
+      def register_counter( name )
+        @metrics.counter( name )
+      end
+      
+      # register a timer under a given name
+      # 
+      # @param [String] name
+      # @return [Java::ComCodahaleMetrics::Timer] timer object which has an 'context' method which starts the timer. the context has a 'stop' method to stop it.
+      def register_timer( name )
+        Timer.new( @metrics.timer( name ) )
+      end
+      
+      # register a histogram under a given name
+      # 
+      # @param [String] name
+      # @return [Java::ComCodahaleMetrics::Counter] histogram object which has an 'update' method
+      def register_histogram( name )
+        @metrics.histogram( name )
+      end
+
+      def remove( name )
+        @metrics.remove( name )
+      end
+    end
+  end
+end

data/lib/leafy/metrics/reporter.rb

@@ -0,0 +1,48 @@
+require 'leafy/metrics/registry'
+
+java_import java.util.concurrent.TimeUnit;
+
+module Leafy
+  module Metrics
+    class Reporter
+      # copy the TimeUnit constants
+      TimeUnit.constants.each do |c|
+        const_set( c, TimeUnit.const_get( c ) )
+      end
+
+      def initialize( reporter )
+        @reporter = reporter
+      end
+
+      def start( period, time_unit )
+        @reporter.start( period, time_unit )
+      end
+
+      def stop
+        @reporter.stop
+      end
+
+      def report
+        @reporter.report
+      end
+
+      class Builder
+        def initialize( reporter_class, metrics )
+          @builder = reporter_class.for_registry( metrics.metrics )
+          self
+        end
+        
+        def convert_rates_to( time_unit )
+          @builder.convert_rates_to( time_unit )
+          self
+        end
+        
+        def convert_durations_to( time_unit )
+          @builder.convert_durations_to( time_unit )
+          self
+        end
+      end
+    end
+  end
+end
+

data/lib/leafy/metrics/version.rb

@@ -0,0 +1,6 @@
+module Leafy
+  module Metrics
+    VERSION = '0.1.0'.freeze
+  end
+end
+    

data/spec/console_reporter_spec.rb

@@ -0,0 +1,51 @@
+require_relative 'setup'
+require 'leafy/metrics/console_reporter'
+
+describe Leafy::Metrics::ConsoleReporter do
+
+  subject { Leafy::Metrics::ConsoleReporter }
+
+  let( :metrics ) { Leafy::Metrics::Registry.new }
+  let( :requests ) { metrics.register_meter( "requests" ) }
+
+  it 'run reporter with defaults' do
+    old_out = java.lang.System.out
+    bytes = StringIO.new
+    java.lang.System.out = java.io.PrintStream.new( bytes.to_outputstream )
+    begin
+      reporter = subject.for_registry( metrics ).build
+      requests.mark
+      reporter.start( 10, Leafy::Metrics::Reporter::MILLISECONDS )
+      sleep 0.01
+      reporter.stop
+      result = bytes.string.gsub( /\n/m, '')
+      expect( result ).to match /count = 1/
+      expect( result ).to match /second/
+    ensure
+      java.lang.System.out = old_out
+      reporter.stop if reporter
+    end
+  end
+
+  it 'run reporter' do
+    bytes = StringIO.new
+    begin
+      reporter = subject.for_registry( metrics )
+        .convert_rates_to( Leafy::Metrics::Reporter::MILLISECONDS )
+        .convert_durations_to( Leafy::Metrics::Reporter::MILLISECONDS )
+        .output_to( bytes )
+        .build
+
+      requests.mark
+      reporter.start( 10, Leafy::Metrics::Reporter::MILLISECONDS )
+      sleep 0.01
+      reporter.stop 
+      result = bytes.string.gsub( /\n/m, '')
+      expect( result ).to match /count = 1/
+      expect( result ).to match /millisecond/
+    ensure
+      reporter.stop if reporter
+    end
+  end
+
+end

data/spec/csv_reporter_spec.rb

@@ -0,0 +1,55 @@
+require_relative 'setup'
+require 'leafy/metrics/csv_reporter'
+require 'fileutils'
+
+describe Leafy::Metrics::CSVReporter do
+
+  subject { Leafy::Metrics::CSVReporter }
+
+  let( :metrics ) { Leafy::Metrics::Registry.new }
+  let( :requests ) { metrics.register_meter( "requests" ) }
+  let( :csvfile ) { File.expand_path( File.dirname( __FILE__ ) ) + "/tmp/requests.csv" }
+  let( :tmpdir ) do
+    dir = File.expand_path( File.dirname( csvfile ) )
+    FileUtils.mkdir_p( dir )
+    FileUtils.rm_f( csvfile )
+    dir
+  end
+  
+  it 'run reporter with defaults' do
+    begin
+      reporter = subject.for_registry( metrics ).build( tmpdir )
+      requests.mark
+      reporter.start( 10, Leafy::Metrics::Reporter::MILLISECONDS )
+      sleep 0.01
+      reporter.stop
+      result = File.read( csvfile )
+      expect( result ).to match /t,count,mean_rate,m1_rate,m5_rate,m15_rate,rate_unit/
+      expect( result ).to match /second/
+    ensure
+      FileUtils.rm_rf( tmpdir )
+      reporter.stop if reporter
+    end
+  end
+
+  it 'run reporter' do
+    begin
+      reporter = subject.for_registry( metrics )
+        .convert_rates_to( Leafy::Metrics::Reporter::MILLISECONDS )
+        .convert_durations_to( Leafy::Metrics::Reporter::MILLISECONDS )
+        .build( tmpdir )
+
+      requests.mark
+      reporter.start( 10, Leafy::Metrics::Reporter::MILLISECONDS )
+      sleep 0.01
+      reporter.stop 
+      result = File.read( csvfile )
+      expect( result ).to match /t,count,mean_rate,m1_rate,m5_rate,m15_rate,rate_unit/
+      expect( result ).to match /second/
+    ensure
+      FileUtils.rm_rf( tmpdir )
+      reporter.stop if reporter
+    end
+  end
+
+end

data/spec/graphite_reporter_spec.rb

@@ -0,0 +1,51 @@
+require_relative 'setup'
+require 'leafy/metrics/graphite/graphite_reporter'
+
+describe Leafy::Metrics::GraphiteReporter do
+
+  subject { Leafy::Metrics::GraphiteReporter }
+
+  let( :metrics ) { Leafy::Metrics::Registry.new }
+  let( :requests ) { metrics.register_meter( "requests" ) }
+  let( :logfile ) { LOG_FILE }
+
+  graphites = [ Leafy::Metrics::Graphite.new_tcp( 'localhost', 12345 ),
+                Leafy::Metrics::Graphite.new_pickled( 'localhost', 12345, 1 ) ]
+  graphites.each_with_index do |graphite, index|
+    describe graphite.sender.class do
+      it 'run reporter with defaults' do
+        log = File.read( logfile )
+        begin
+          reporter = subject.for_registry( metrics ).build( graphite )
+          requests.mark
+          reporter.start( 10, Leafy::Metrics::Reporter::MILLISECONDS )
+          sleep 0.01
+          reporter.stop
+          result = File.read( logfile )[ (log.size)..-1 ]
+          expect( result ).to match /metrics-graphite-reporter-.-thread-1] WARN com.codahale.metrics.graphite.GraphiteReporter/
+        ensure
+          reporter.stop if reporter
+        end
+      end
+
+      it 'run reporter' do
+        log = File.read( logfile )
+        begin
+          reporter = subject.for_registry( metrics )
+            .convert_rates_to( Leafy::Metrics::Reporter::MILLISECONDS )
+            .convert_durations_to( Leafy::Metrics::Reporter::MILLISECONDS )
+            .build( graphite )
+      
+          requests.mark
+          reporter.start( 10, Leafy::Metrics::Reporter::MILLISECONDS )
+          sleep 0.01
+          reporter.stop 
+          result = File.read( logfile )[ (log.size)..-1 ]
+          expect( result ).to match /metrics-graphite-reporter-.-thread-1] WARN com.codahale.metrics.graphite.GraphiteReporter/
+        ensure
+          reporter.stop if reporter
+        end
+      end
+    end
+  end
+end

data/spec/graphite_spec.rb

@@ -0,0 +1,23 @@
+require_relative 'setup'
+require 'leafy/metrics/graphite/graphite'
+
+describe Leafy::Metrics::Graphite do
+
+  subject { Leafy::Metrics::Graphite }
+
+  it 'fails to create an instance without proper sender' do
+    expect { subject.new Object.new }.to raise_error RuntimeError
+  end
+
+  it 'creates tcp graphite' do
+    expect( subject.new_tcp( 'localhost', 123 ) ).not_to be_nil
+  end
+
+  it 'creates udp graphite' do
+    expect( subject.new_udp( 'localhost', 123 ) ).not_to be_nil
+  end
+
+  it 'creates pickled graphite' do
+    expect( subject.new_pickled( 'localhost', 123, 456 ) ).not_to be_nil
+  end
+end

data/spec/registry_spec.rb

@@ -0,0 +1,92 @@
+require_relative 'setup'
+require 'leafy/metrics/registry'
+
+describe Leafy::Metrics::Registry do
+
+  subject { Leafy::Metrics::Registry.new }
+
+  it 'registers and unregister a meter' do
+    obj = subject.register_meter('me')
+    expect(obj).to be_a(Java::ComCodahaleMetrics::Meter)
+    expect(subject.metrics.meters['me']).to be obj
+    expect(obj.respond_to? :mark).to be true
+
+    subject.remove('me')
+    expect(subject.metrics.meters).to be_empty
+  end
+
+  it 'registers and unregister a counter' do
+    obj = subject.register_counter('me')
+    expect(obj).to be_a(Java::ComCodahaleMetrics::Counter)
+    expect(subject.metrics.counters['me']).to be obj
+    expect(obj.respond_to? :inc).to be true
+    expect(obj.respond_to? :dec).to be true
+
+    subject.remove('me')
+    expect(subject.metrics.counters).to be_empty
+  end
+
+  it 'registers and unregister a histogram' do
+    obj = subject.register_histogram('me')
+    expect(obj).to be_a(Java::ComCodahaleMetrics::Histogram)
+    expect(subject.metrics.histograms['me']).to be obj
+    expect(obj.respond_to? :update).to be true
+
+    subject.remove('me')
+    expect(subject.metrics.histograms).to be_empty
+  end
+
+  it 'registers and unregister a timer' do
+    obj = subject.register_timer('me')
+    expect(obj).to be_a(Leafy::Metrics::Registry::Timer)
+    expect(subject.metrics.timers['me']).to be obj.timer
+    expect(obj.timer.respond_to? :time).to be true
+
+    subject.remove('me')
+    expect(subject.metrics.timers).to be_empty
+  end
+
+  it 'registers and unregister gauge as block' do
+    obj = subject.register_gauge('me') do
+      123
+    end
+    expect(obj).to be_a(Leafy::Metrics::Registry::Gauge)
+    expect(subject.metrics.gauges['me']).to be obj
+    expect(obj.value).to eq 123
+
+    subject.remove('me')
+    expect(subject.metrics.gauges).to be_empty
+  end
+
+  it 'registers and unregister gauge as object with call method' do
+    obj = subject.register_gauge('me', Proc.new do
+      123
+    end )
+    expect(obj).to be_a(Leafy::Metrics::Registry::Gauge)
+    expect(subject.metrics.gauges['me']).to be obj
+    expect(obj.value).to eq 123
+
+    subject.remove('me')
+    expect(subject.metrics.gauges).to be_empty
+  end
+
+  it 'fails register gauge as object without call method' do
+    expect { subject.register_gauge('me', Object.new ) }.to raise_error
+  end
+
+  describe Leafy::Metrics::Registry::Timer do
+
+    it 'can messure duration' do
+      obj = subject.register_timer('me')
+      expect(obj.timer.mean_rate).to eq 0.0
+
+      obj.time do
+        sleep 0.1
+      end
+      
+      expect(obj.timer.mean_rate).to be > 0.0
+
+      subject.remove('me')
+    end
+  end
+end

data/spec/setup.rb

@@ -0,0 +1,10 @@
+$LOAD_PATH.unshift File.expand_path( '../../lib', __FILE__ )
+require 'jar-dependencies'
+
+# setup logging
+LOG_FILE = File.expand_path( '../../pkg/log', __FILE__ )
+require 'fileutils'
+FileUtils.mkdir_p File.dirname( LOG_FILE )
+FileUtils.rm_f( LOG_FILE )
+java.lang.System.set_property( 'org.slf4j.simpleLogger.logFile', LOG_FILE )
+require_jar( 'org.slf4j', 'slf4j-simple', '1.7.7' )

metadata

@@ -0,0 +1,127 @@
+--- !ruby/object:Gem::Specification
+name: leafy-metrics
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- christian meier
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-02-19 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: jar-dependencies
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.1.8
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.1.8
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.1.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.1.0
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.8.7
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.8.7
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.2'
+description: 'provides an API to register metrics like meters, timers, gauge, counter
+  using dropwizard-metrics. it also allows to setup reporters: console-reporter, csv-reporter
+  and graphite-reporter'
+email:
+- christian.meier@lookout.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- leafy-metrics.gemspec
+- lib/leafy-metrics.rb
+- lib/leafy-metrics_jars.rb
+- lib/leafy/metrics.rb
+- lib/leafy/metrics/console_reporter.rb
+- lib/leafy/metrics/csv_reporter.rb
+- lib/leafy/metrics/graphite/graphite.rb
+- lib/leafy/metrics/graphite/graphite_reporter.rb
+- lib/leafy/metrics/registry.rb
+- lib/leafy/metrics/reporter.rb
+- lib/leafy/metrics/version.rb
+- spec/console_reporter_spec.rb
+- spec/csv_reporter_spec.rb
+- spec/graphite_reporter_spec.rb
+- spec/graphite_spec.rb
+- spec/registry_spec.rb
+- spec/setup.rb
+homepage: https://github.com/lookout/leafy
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements:
+- jar io.dropwizard.metrics:metrics-core, 3.1.0
+- jar io.dropwizard.metrics:metrics-graphite, 3.1.0
+- jar org.slf4j, slf4j-simple, 1.7.7, :scope => :test
+rubyforge_project: 
+rubygems_version: 2.4.5
+signing_key: 
+specification_version: 4
+summary: provide an API to register metrics
+test_files: []