statsd-client 0.0.1

data/.gitignore

@@ -0,0 +1 @@
+*.gem

data/README.md

@@ -0,0 +1,26 @@
+statsd-client
+=============
+
+This is a simple client for [statsd](https://github.com/etsy/statsd).  It's
+roughly equivalent to the php and python examples included in the statsd
+repo.  I put it in a gem to make it easy to install, reuse, etc.
+
+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)
+    
+    

data/lib/statsd.rb

@@ -0,0 +1,65 @@
+require 'socket'
+
+class Statsd
+  
+  Version = '0.0.1'
+  
+  class << self
+    
+    attr_accessor :host, :port
+    
+    # +stat+ to log timing for
+    # +time+ is the time to log in ms
+    def timing(stat, time, sample_rate = 1)
+      send_stats "#{stat}:#{time}|ms", 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|
+          if rand <= sample_rate
+            sampled_data << "#{d}@#{sample_rate}"
+          end
+        end
+        data = sampled_data
+      end
+      
+      return if data.empty?
+      
+      raise "host and port must be set" unless host && port
+      
+      sock = UDPSocket.new
+      data.each do |d|
+        puts d
+        sock.send(d, 0, host, port)
+      end
+      true
+    end
+      
+    
+  end
+  
+  
+end

data/statsd-client.gemspec

@@ -0,0 +1,20 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path("../lib/statsd", __FILE__)
+
+Gem::Specification.new do |s|
+  s.name        = "statsd-client"
+  s.version     = Statsd::Version
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ['Ben VandenBos']
+  s.email       = ['bvandenbos@gmail.com']
+  s.homepage    = "http://github.com/bvandenbos/statsd-client"
+  s.summary     = "Ruby client for statsd."
+  s.description = "Ruby client for statsd."
+  
+  s.required_rubygems_version = ">= 1.3.6"
+
+  s.files        = `git ls-files`.split("\n")
+  s.executables  = `git ls-files`.split("\n").map{|f| f =~ /^bin\/(.*)/ ? $1 : nil}.compact
+  s.require_path = 'lib'
+end
+

metadata

@@ -0,0 +1,70 @@
+--- !ruby/object:Gem::Specification 
+name: statsd-client
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Ben VandenBos
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-02-23 00:00:00 -08:00
+default_executable: 
+dependencies: []
+
+description: Ruby client for statsd.
+email: 
+- bvandenbos@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- README.md
+- lib/statsd.rb
+- statsd-client.gemspec
+has_rdoc: true
+homepage: http://github.com/bvandenbos/statsd-client
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 1
+      - 3
+      - 6
+      version: 1.3.6
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Ruby client for statsd.
+test_files: []
+