statsd-client 0.0.6 → 0.0.7

data/README.md

@@ -10,21 +10,24 @@ Example
 
     require 'rubygems'
     require 'statsd'
-    
+
     Statsd.host = 'localhost'
     Statsd.port = 8125
-    
+
     Statsd.increment('some_counter') # basic incrementing
     Statsd.increment('system.nested_counter', 0.1) # incrementing with sampling (10%)
 
     Statsd.decrement(:some_other_counter) # basic decrememting using a symbol
     Statsd.decrement('system.nested_counter', 0.1) # decrementing with sampling (10%)
-    
+
     Statsd.timing('some_job_time', 20) # reporting job that took 20ms
     Statsd.timing('some_job_time', 20, 0.05) # reporting job that took 20ms with sampling (5% sampling)
-    
-    # passing a block to `timing` will capture the time it takes to execute   
-    Statsd.time('some_job_time') do
+
+    Statsd.gauge('some_gauge', 1337)               # sending gauge values
+    Statsd.gauge('system.nested_gauge', 1337, 0.1) # sending gauge with sampling
+
+    # passing a block to `timing` will capture the time it takes to execute
+    Statsd.timing('some_job_time') do
       # do some job
     end
-    
+

data/lib/statsd.rb

@@ -2,22 +2,22 @@ require 'socket'
 require 'resolv'
 
 class Statsd
-  
-  Version = '0.0.6'
-  
+
+  Version = '0.0.7'
+
   class << self
-    
+
     attr_accessor :host, :port
-    
+
     def host_ip_addr
       @host_ip_addr ||= Resolv.getaddress(host)
     end
-    
+
     def host=(h)
       @host_ip_addr = nil
       @host = h
     end
-    
+
     # +stat+ to log timing for
     # +time+ is the time to log in ms
     def timing(stat, time = nil, sample_rate = 1)
@@ -28,29 +28,33 @@ class Statsd
       end
       send_stats("#{stat}:#{time}|ms", sample_rate)
     end
-    
+
+    def gauge(stat, value, sample_rate = 1)
+      send_stats("#{stat}:#{value}|g", sample_rate)
+    end
+
     # +stats+ can be a string or an array of strings
     def increment(stats, sample_rate = 1)
       update_counter stats, 1, sample_rate
     end
-    
+
     # +stats+ can be a string or an array of strings
     def decrement(stats, sample_rate = 1)
       update_counter stats, -1, sample_rate
     end
-    
+
     # +stats+ can be a string or array of strings
     def update_counter(stats, delta = 1, sample_rate = 1)
       stats = Array(stats)
       send_stats(stats.map { |s| "#{s}:#{delta}|c" }, sample_rate)
     end
-    
+
     private
-    
+
     def send_stats(data, sample_rate = 1)
       data = Array(data)
       sampled_data = []
-      
+
       # Apply sample rate if less than one
       if sample_rate < 1
         data.each do |d|
@@ -60,11 +64,11 @@ class Statsd
         end
         data = sampled_data
       end
-      
+
       return if data.empty?
-      
+
       raise "host and port must be set" unless host && port
-      
+
       begin
         sock = UDPSocket.new
         data.each do |d|
@@ -76,7 +80,7 @@ class Statsd
       end
       true
     end
-    
+
   end
-  
+
 end

data/test/statsd_test.rb

@@ -1,30 +1,30 @@
 require File.expand_path('../test_helper', __FILE__)
 
 class StatsdTest < Test::Unit::TestCase
-  
+
   def setup
     Statsd.host = 'localhost'
     Statsd.port = 8125
     super
   end
-  
+
   context "timing" do
-    
+
     should "send with ms" do
       expected_send('test.stat:23|ms')
       Statsd.timing('test.stat', 23)
     end
-    
+
     should "log when sampled" do
       fake_rand(0.09)
       expected_send('test.stat:23|ms@0.1')
       Statsd.timing('test.stat', 23, 0.1)
     end
-    
+
     should "not log when not sampled" do
       fake_rand(0.11)
       expect_nothing
-      Statsd.timing('test.stat', 23, 0.1)      
+      Statsd.timing('test.stat', 23, 0.1)
     end
 
     should "work with a block" do
@@ -33,11 +33,11 @@ class StatsdTest < Test::Unit::TestCase
         sleep 0.023
       end
     end
-    
+
   end
-  
+
   context "increment" do
-    
+
     should "send number" do
       expected_send('test.stat:1|c')
       Statsd.increment('test.stat')
@@ -52,13 +52,13 @@ class StatsdTest < Test::Unit::TestCase
     should "not log when not sampled" do
       fake_rand(0.11)
       expect_nothing
-      Statsd.increment('test.stat', 0.1)      
+      Statsd.increment('test.stat', 0.1)
     end
-        
+
   end
-  
+
   context "decrement" do
-    
+
     should "send number" do
       expected_send('test.stat:-1|c')
       Statsd.decrement('test.stat')
@@ -73,60 +73,81 @@ class StatsdTest < Test::Unit::TestCase
     should "not log when not sampled" do
       fake_rand(0.11)
       expect_nothing
-      Statsd.decrement('test.stat', 0.1)      
+      Statsd.decrement('test.stat', 0.1)
     end
-    
+
   end
-  
+
+  context "gauge" do
+
+    should "send number" do
+      expected_send('test.stat:1337|g')
+      Statsd.gauge('test.stat', 1337)
+    end
+
+    should "log when sampled" do
+      fake_rand(0.09)
+      expected_send('test.stat:1337|g@0.1')
+      Statsd.gauge('test.stat', 1337, 0.1)
+    end
+
+    should "not log when not sampled" do
+      fake_rand(0.11)
+      expect_nothing
+      Statsd.gauge('test.stat', 1337, 0.1)
+    end
+
+  end
+
   context "host" do
-    
+
     should "be gettable and settable" do
       Statsd.host = 'statsd-01'
       assert_equal 'statsd-01', Statsd.host
     end
-    
+
   end
-  
+
   context "port" do
 
     should "be gettable and settable" do
       Statsd.port = 1234
       assert_equal 1234, Statsd.port
     end
-    
+
   end
-  
+
   context "host_ip_addr" do
-    
+
     should "resolve dns" do
       Statsd.host = 'localhost'
       assert loopback?(Statsd.host_ip_addr)
     end
-    
+
     should "be cleared when host is set" do
       Statsd.host = 'statsd-01'
       assert_nil Statsd.instance_variable_get(:@host_ip_addr)
     end
-    
+
   end
-  
+
   private
-  
+
   def fake_rand(v)
     Statsd.stubs(:rand).returns(v)
   end
-  
+
   def expected_send(buf)
     buf_re = Regexp.new(buf)
     UDPSocket.any_instance.expects(:send).with(regexp_matches(buf_re), 0, Statsd.host_ip_addr, Statsd.port).once
   end
-  
+
   def expect_nothing
     UDPSocket.any_instance.expects(:send).never
   end
-  
+
   def loopback?(ip)
     ['::1', '127.0.0.1'].include?(ip)
   end
-  
+
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: statsd-client
 version: !ruby/object:Gem::Version
-  version: 0.0.6
+  version: 0.0.7
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2011-12-06 00:00:00.000000000Z
+date: 2012-06-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: shoulda-context
-  requirement: &2171313560 !ruby/object:Gem::Requirement
+  requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -21,10 +21,15 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *2171313560
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: mocha
-  requirement: &2171312840 !ruby/object:Gem::Requirement
+  requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -32,7 +37,12 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *2171312840
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
 description: Ruby client for statsd.
 email:
 - bvandenbos@gmail.com
@@ -62,7 +72,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: 3523856790933509678
+      hash: -1611389077087709382
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
@@ -71,10 +81,10 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: 3523856790933509678
+      hash: -1611389077087709382
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.8.5
+rubygems_version: 1.8.21
 signing_key: 
 specification_version: 3
 summary: Ruby client for statsd.