statsd-ruby 1.1.1 → 1.2.0

data/LICENSE.txt

@@ -1,4 +1,4 @@
-Copyright (c) 2011 Rein Henrichs
+Copyright (c) 2011, 2012, 2013 Rein Henrichs
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/README.rdoc

@@ -35,7 +35,7 @@ Run the specs and include live integration specs with <tt>LIVE=true rake spec</t
 * A short note about DNS: If you use a dns name for the host option, then you will want to use a local caching dns service for optimial performance (e.g. nscd).
 
 == Contributing to statsd
- 
+
 * Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet
 * Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it
 * Fork the project
@@ -55,7 +55,21 @@ Run the specs and include live integration specs with <tt>LIVE=true rake spec</t
 * Trae Robrock
 * Corey Donohoe
 * James Tucker
+* Dotan Nahum
+* Eric Chapweske
+* Hannes Georg
+* John Nunemaker
+* Mahesh Murthy
+* Manu J
+* Matt Sanford
+* Nate Bird
+* Noah Lorang
+* Oscar Del Ben
+* Peter Mounce
+* Ray Krueger
+* Reed Lipman
+* Thomas Whaples
 
 == Copyright
 
-Copyright (c) 2011 Rein Henrichs. See LICENSE.txt for further details.
+Copyright (c) 2011, 2012, 2013 Rein Henrichs. See LICENSE.txt for further details.

data/lib/statsd.rb

@@ -43,7 +43,11 @@ class Statsd
 
     extend Forwardable
     def_delegators :@statsd,
-      :namespace, :namespace=, :host, :port, :prefix, :postfix
+      :namespace, :namespace=,
+      :host, :host=,
+      :port, :port=,
+      :prefix,
+      :postfix
 
     attr_accessor :batch_size
 
@@ -187,6 +191,22 @@ class Statsd
     send_stats stat, value, :g, sample_rate
   end
 
+  # Sends an arbitary set value for the given stat to the statsd server.
+  #
+  # This is for recording counts of unique events, which are useful to
+  # see on graphs to correlate to other values.  For example, a deployment
+  # might get recorded as a set, and be drawn as annotations on a CPU history
+  # graph.
+  #
+  # @param [String] stat stat name.
+  # @param [Numeric] value event value.
+  # @param [Numeric] sample_rate sample rate, 1 for always
+  # @example Report a deployment happening:
+  #   $statsd.set('deployment', DEPLOYMENT_EVENT_CODE)
+  def set(stat, value, sample_rate=1)
+    send_stats stat, value, :s, sample_rate
+  end
+
   # Sends a timing (in ms) for the given stat to the statsd server. The
   # sample_rate determines what percentage of the time this report is sent. The
   # statsd server then uses the sample_rate to correctly track the average

data/spec/statsd_spec.rb

@@ -111,6 +111,21 @@ describe Statsd do
     end
   end
 
+  describe "#set" do
+    it "should format the message according to the statsd spec" do
+      @statsd.set('foobar', 765)
+      @socket.recv.must_equal ['foobar:765|s']
+    end
+
+    describe "with a sample rate" do
+      before { class << @statsd; def rand; 0; end; end } # ensure delivery
+      it "should format the message according to the statsd spec" do
+        @statsd.set('foobar', 500, 0.5)
+        @socket.recv.must_equal ['foobar:500|s|@0.5']
+      end
+    end
+  end
+
   describe "#time" do
     it "should format the message according to the statsd spec" do
       @statsd.time('foobar') { 'test' }
@@ -318,6 +333,24 @@ describe Statsd do
       @socket.recv.must_equal %w[foobar:1|c]
     end
 
+    it "should support setting namespace for the underlying instance" do
+      batch = Statsd::Batch.new(@statsd)
+      batch.namespace = 'ns'
+      @statsd.namespace.must_equal 'ns'
+    end
+
+    it "should support setting host for the underlying instance" do
+      batch = Statsd::Batch.new(@statsd)
+      batch.host = '1.2.3.4'
+      @statsd.host.must_equal '1.2.3.4'
+    end
+
+    it "should support setting port for the underlying instance" do
+      batch = Statsd::Batch.new(@statsd)
+      batch.port = 42
+      @statsd.port.must_equal 42
+    end
+
   end
 
   describe "thread safety" do

data/statsd-ruby.gemspec

@@ -1,8 +1,8 @@
 # -*- encoding: utf-8 -*-
 
-Gem::Specification.new("statsd-ruby", "1.1.1") do |s|
+Gem::Specification.new("statsd-ruby", "1.2.0") do |s|
   s.authors = ["Rein Henrichs"]
-  s.email = "rein@phpfog.com"
+  s.email = "reinh@reinh.com"
 
   s.summary = "A Ruby StatsD client"
   s.description = "A Ruby StatsD client (https://github.com/etsy/statsd)"

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: statsd-ruby
 version: !ruby/object:Gem::Version 
-  hash: 17
+  hash: 31
   prerelease: 
   segments: 
   - 1
-  - 1
-  - 1
-  version: 1.1.1
+  - 2
+  - 0
+  version: 1.2.0
 platform: ruby
 authors: 
 - Rein Henrichs
@@ -78,7 +78,7 @@ dependencies:
   type: :development
   version_requirements: *id004
 description: A Ruby StatsD client (https://github.com/etsy/statsd)
-email: rein@phpfog.com
+email: reinh@reinh.com
 executables: []
 
 extensions: []