gmetric 0.1.0 → 0.1.1

data/README.rdoc

@@ -2,6 +2,8 @@
 
 A pure Ruby client for generating Ganglia 3.1.x+ gmetric meta and metric packets and talking to your gmond / gmetad nodes over UDP protocol. Supports host spoofing, and all the same parameters as the gmetric command line executable.
 
+- http://www.igvita.com/2010/01/28/cluster-monitoring-with-ganglia-ruby/
+
 == Example: Sending a gmetric to a gmond over UDP
 
   Ganglia::GMetric.send("127.0.0.1", 8670, {

data/VERSION

@@ -1 +1 @@
-0.1.0
+0.1.1

data/lib/gmetric.rb

@@ -16,47 +16,58 @@ module Ganglia
       conn = UDPSocket.new
       conn.connect(host, port)
       gmetric = self.pack(metric)
-      
+
       conn.send gmetric[0], 0
       conn.send gmetric[1], 0
     end
 
     def self.pack(metric)
       metric = {
-        :hostname => '',   
+        :hostname => '',
+        :group    => '',
         :spoof    => 0,
         :units    => '',
         :slope    => 'both',
         :tmax     => 60,
         :dmax     => 0
       }.merge(metric)
-      
+
+      # convert bools to ints
+      metric[:spoof] = 1 if metric[:spoof].is_a? TrueClass
+      metric[:spoof] = 0 if metric[:spoof].is_a? FalseClass
+
       raise "Missing key, value, type" if not metric.key? :name or not metric.key? :value or not metric.key? :type
       raise "Invalid metric type" if not %w(string int8 uint8 int16 uint16 int32 uint32 float double).include? metric[:type]
-      
+
       meta = XDRPacket.new
       data = XDRPacket.new
-      
+
       # METADATA payload
       meta.pack_int(128)                            # gmetadata_full
       meta.pack_string(metric[:hostname])           # hostname
       meta.pack_string(metric[:name].to_s)          # name of the metric
       meta.pack_int(metric[:spoof].to_i)            # spoof hostname flag
-      
+
       meta.pack_string(metric[:type].to_s)          # one of: string, int8, uint8, int16, uint16, int32, uint32, float, double
-      meta.pack_string(metric[:name].to_s)          # name of the metric 
+      meta.pack_string(metric[:name].to_s)          # name of the metric
       meta.pack_string(metric[:units].to_s)         # units for the value, e.g. 'kb/sec'
       meta.pack_int(SLOPE[metric[:slope]])          # sign of the derivative of the value over time, one of zero, positive, negative, both, default both
       meta.pack_uint(metric[:tmax].to_i)            # maximum time in seconds between gmetric calls, default 60
       meta.pack_uint(metric[:dmax].to_i)            # lifetime in seconds of this metric, default=0, meaning unlimited
-      meta.pack_int(0)                                                   
-                                                                         
-      # DATA payload                                                     
-      data.pack_int(128+5)                          # string message     
-      data.pack_string(metric[:hostname].to_s)      # hostname           
-      data.pack_string(metric[:name].to_s)          # name of the metric 
-      data.pack_int(metric[:spoof].to_i)            # spoof hostname flag      
-      data.pack_string("%s")                        #                    
+
+      ## MAGIC NUMBER: equals the elements of extra data, here it's 1 because I added Group.
+      meta.pack_int(1)
+
+      ## METADATA EXTRA DATA: functionally key/value
+      meta.pack_string("GROUP")
+      meta.pack_string(metric[:group].to_s)
+
+      # DATA payload
+      data.pack_int(128+5)                          # string message
+      data.pack_string(metric[:hostname].to_s)      # hostname
+      data.pack_string(metric[:name].to_s)          # name of the metric
+      data.pack_int(metric[:spoof].to_i)            # spoof hostname flag
+      data.pack_string("%s")                        #
       data.pack_string(metric[:value].to_s)         # value of the metric
 
       [meta.data, data.data]
@@ -88,4 +99,4 @@ module Ganglia
       @data.string
     end
   end
-end
+end

data/spec/gmetric_spec.rb

@@ -37,7 +37,7 @@ describe Ganglia::GMetric do
 
     g = Ganglia::GMetric.pack(data)
     g.size.should == 2
-    g[0].should == "\000\000\000\200\000\000\000\000\000\000\000\003foo\000\000\000\000\000\000\000\000\006string\000\000\000\000\000\003foo\000\000\000\000\000\000\000\000\003\000\000\000<\000\000\000\000\000\000\000\000"
+    g[0].should == "\000\000\000\200\000\000\000\000\000\000\000\003foo\000\000\000\000\000\000\000\000\006string\000\000\000\000\000\003foo\000\000\000\000\000\000\000\000\003\000\000\000<\000\000\000\000\000\000\000\001\000\000\000\005GROUP\000\000\000\000\000\000\000"
     g[1].should == "\000\000\000\205\000\000\000\000\000\000\000\003foo\000\000\000\000\000\000\000\000\002%s\000\000\000\000\000\003bar\000"
   end
 
@@ -64,4 +64,24 @@ describe Ganglia::GMetric do
       Ganglia::GMetric.pack(data)
     }.should raise_error
   end
+
+  it "should allow host spoofing" do
+    lambda {
+      data = {:name => 'a', :type => 'uint8', :value => 'c', :spoof => 1, :host => 'host'}
+      Ganglia::GMetric.pack(data)
+
+      data = {:name => 'a', :type => 'uint8', :value => 'c', :spoof => true, :host => 'host'}
+      Ganglia::GMetric.pack(data)
+    }.should_not raise_error
+
+  end
+
+  it "should allow group meta data" do
+    lambda {
+      data = {:name => 'a', :type => 'uint8', :value => 'c', :spoof => 1, :host => 'host', :group => 'test'}
+      g = Ganglia::GMetric.pack(data)
+      g[0].should == "\000\000\000\200\000\000\000\000\000\000\000\001a\000\000\000\000\000\000\001\000\000\000\005uint8\000\000\000\000\000\000\001a\000\000\000\000\000\000\000\000\000\000\003\000\000\000<\000\000\000\000\000\000\000\001\000\000\000\005GROUP\000\000\000\000\000\000\004test"
+
+    }.should_not raise_error
+  end
 end

metadata

@@ -1,7 +1,12 @@
 --- !ruby/object:Gem::Specification 
 name: gmetric
 version: !ruby/object:Gem::Version 
-  version: 0.1.0
+  prerelease: false
+  segments: 
+  - 0
+  - 1
+  - 1
+  version: 0.1.1
 platform: ruby
 authors: 
 - Ilya Grigorik
@@ -9,7 +14,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-01-28 00:00:00 -05:00
+date: 2010-06-13 00:00:00 -04:00
 default_executable: 
 dependencies: []
 
@@ -41,18 +46,20 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
+      segments: 
+      - 0
       version: "0"
-  version: 
 required_rubygems_version: !ruby/object:Gem::Requirement 
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
+      segments: 
+      - 0
       version: "0"
-  version: 
 requirements: []
 
 rubyforge_project: gmetric
-rubygems_version: 1.3.5
+rubygems_version: 1.3.6
 signing_key: 
 specification_version: 3
 summary: Pure Ruby interface for generating Ganglia gmetric packets