fluent-plugin-ganglia 0.0.1

data/.gitignore

@@ -0,0 +1,19 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+*~
+.#*

data/Gemfile

@@ -0,0 +1,4 @@
+source :rubygems
+
+# Specify your gem's dependencies in fluent-plugin-ganglia.gemspec
+gemspec

data/README.rdoc

@@ -0,0 +1,87 @@
+= fluent-plugin-ganglia
+
+Plugin to output values to Ganglia.
+
+= Configuration
+
+* type
+  * required "ganglia"
+* name_keys or name_key_pattern
+  * required
+  * specify key name by _name_keys_ or regexp pattern of keys by _name_key_pattern_
+* add_key_prefix
+  * string to add key prefix
+* host
+  * host to send metric (default=127.0.0.1)
+* post
+  * port of host to send metric (default=8649)
+* value_type
+  * type of value
+  * same as gmetric --type
+* units
+  * unit of value
+  * same as gemtric --units
+* group
+  * metric group
+  * same as gemtric --group
+* title
+  * metric title
+  * same as gemtric --title
+* tmax
+  * maximum time in seconds between gmetric calls. (default=60)
+  * same as gemtric --tmax
+* dmax
+  * lifetime in seconds of this metric. (default=0)
+  * same as gemtric --dmax
+* slope
+  * Either zero|positive|negative|both. (default=both)
+  * same as gemtric --slope
+* spoof
+  * IP address and name of host/device we are spoofing. (default=nil)
+  * same as gmetric --spooof
+* bind_hostname
+  * whether upd_send_channel.bind_hostname is yes(true) or no(fale). (default=false)
+
+= Example
+
+== gmond configured with multicast
+
+when the gmond configured with multicast and bind_hostname as below:
+
+    udp_send_channel {
+        mcast_join    = 239.2.11.71
+        bind_hostname = yes
+        port          = 8640
+        ...
+    }
+
+you should specify mcast_join ip address to _host_ and set _bind__hostname_ true:
+
+    <match metrics>
+      type          ganglia
+      host          239.2.11.71
+      port          8649
+      group         metric_group
+      name_keys     metrics.field1,metrics.field2
+      bind_hostname true
+    </match>
+
+== gmond configured with unicast
+
+when the gmond configured with unicast, you should specify _host_ and _port_ with same value of gmond.conf:
+
+    <match metrics>
+      type              ganglia
+      host              192.0.2.100
+      port              8649
+      group             metric_group
+      name_key_pattern  ^field
+    </match>
+
+= License
+
+Apache License, Version 2.0
+
+= Copyright
+
+Copyright (c) 2013 Hiroshi Sakai

data/Rakefile

@@ -0,0 +1,8 @@
+require 'rake/testtask'
+
+Rake::TestTask.new do |t|
+  t.libs << "test"
+  t.pattern = 'test/**/test_*.rb'
+end
+
+task :default => :test

data/fluent-plugin-ganglia.gemspec

@@ -0,0 +1,22 @@
+# -*- mode:ruby -*-
+
+Gem::Specification.new do |gem|
+  gem.name          = "fluent-plugin-ganglia"
+  gem.version       = "0.0.1"
+  gem.authors       = ["Hiroshi Sakai"]
+  gem.email         = ["ziguzagu@gmail.com"]
+  gem.description   = %q{Fluentd output plugin to ganglia}
+  gem.summary       = %q{Fluentd output plugin to ganglia}
+  gem.homepage      = "https://github.com/ziguzagu/fluent-plugin-ganglia"
+
+  gem.files         = `git ls-files`.split($\)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.require_paths = ["lib"]
+
+  gem.add_development_dependency "rake"
+  gem.add_development_dependency "fluentd"
+
+  gem.add_runtime_dependency "fluentd"
+  gem.add_runtime_dependency "gmetric"
+end

data/lib/fluent/plugin/out_ganglia.rb

@@ -0,0 +1,106 @@
+class Fluent::GangliaOutput < Fluent::Output
+  Fluent::Plugin.register_output('ganglia', self)
+
+  HOSTNAME = Socket.gethostname
+  HOSTADDR = IPSocket.getaddress(HOSTNAME)
+
+  def initialize
+    super
+    require "gmetric"
+    require "socket"
+  end
+
+  config_param :port,             :integer, :default => 8649
+  config_param :host,             :string,  :default => '127.0.0.1'
+  config_param :name_keys,        :string,  :default => nil
+  config_param :name_key_pattern, :string,  :default => nil
+  config_param :add_key_prefix,   :string,  :default => nil
+  config_param :value_type,       :string,  :default => 'uint32'
+  config_param :units,            :string,  :default => ''
+  config_param :group,            :string,  :default => ''
+  config_param :title,            :string,  :default => ''
+  config_param :tmax,             :integer, :default => 60
+  config_param :dmax,             :integer, :default => 0
+  config_param :slope,            :string,  :default => 'both'
+  config_param :spoof,            :string,  :default => nil
+  config_param :bind_hostname,    :bool,    :default => false
+
+  def configure(conf)
+    super
+
+    if @name_keys.nil? and @name_key_pattern.nil?
+      raise Fluent::ConfigError, "missing both of name_keys and name_key_pattern"
+    end
+    if not @name_keys.nil? and not @name_key_pattern.nil?
+      raise Fluent::ConfigError, "cannot specify both of name_keys and name_key_pattern"
+    end
+    if @name_keys
+      @name_keys = @name_keys.split(/ *, */)
+    end
+    if @name_key_pattern
+      @name_key_pattern = Regexp.new(@name_key_pattern)
+    end
+  end
+
+  def start
+    super
+  end
+
+  def shutdown
+    super
+  end
+
+  def send(tag, name, value, time)
+    if @add_key_prefix
+      name = "#{@add_key_prefix} #{name}"
+    end
+    begin
+      $log.debug("ganglia: #{name}: #{value}, ts: #{time}")
+      gmetric = Ganglia::GMetric.pack(
+        :name     => name,
+        :value    => value.to_s,
+        :type     => @value_type,
+        :units    => @units,
+        :tmax     => @tmax,
+        :dmax     => @dmax,
+        :title    => @title,
+        :group    => @group,
+        :slope    => @slope,
+        :spoof    => @spoof ? 1 : 0,
+        :hostname => @spoof ? @spoof : HOSTNAME,
+      )
+      conn = UDPSocket.new
+      conn.bind(HOSTADDR, 0) if @bind_hostname
+      conn.send gmetric[0], 0, @host, @port
+      conn.send gmetric[1], 0, @host, @port
+      conn.close
+      status = true
+    rescue IOError, EOFError, SystemCallError
+      $log.warn "Ganglia::GMetric.send raises exception: #{$!.class}, '#{$!.message}'"
+    end
+    unless status
+      $log.warn "failed to send to ganglia: #{@host}:#{@port}, '#{name}': #{value}"
+    end
+  end
+
+  def emit(tag, es, chain)
+    if @name_keys
+      es.each {|time,record|
+        @name_keys.each {|name|
+          if record[name]
+            send(tag, name, record[name], time)
+          end
+        }
+      }
+    else # for name_key_pattern
+      es.each {|time,record|
+        record.keys.each {|key|
+          if @name_key_pattern.match(key) and record[key]
+            send(tag, key, record[key], time)
+          end
+        }
+      }
+    end
+    chain.next
+  end
+end

data/test/helper.rb

@@ -0,0 +1,28 @@
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'test/unit'
+
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require 'fluent/test'
+unless ENV.has_key?('VERBOSE')
+  nulllogger = Object.new
+  nulllogger.instance_eval {|obj|
+    def method_missing(method, *args)
+      # pass
+    end
+  }
+  $log = nulllogger
+end
+
+require 'fluent/plugin/out_ganglia'
+
+class Test::Unit::TestCase
+end

data/test/plugin/test_out_ganglia.rb

@@ -0,0 +1,24 @@
+require 'helper'
+
+class GangliaOutputTest < Test::Unit::TestCase
+  def setup
+    Fluent::Test.setup
+  end
+
+  CONFIG = %[
+    port           8649
+    add_key_prefix test
+    name_keys      foo, bar, baz
+  ]
+
+  def create_driver(conf = CONFIG, tag='test')
+    Fluent::Test::OutputTestDriver.new(Fluent::GangliaOutput, tag).configure(conf)
+  end
+
+  def test_write
+#    d = create_driver
+#    d.emit({"foo" => "test value of foo"})
+#    d.emit({"bar" => "test value of bar"})
+#    d.emit({"baz" => rand * 10 }) 
+  end
+end

data/test/plugins.rb

@@ -0,0 +1,35 @@
+class Fluent::GangliaTestInput < Fluent::Input
+  Fluent::Plugin.register_input('ganglia_test', self)
+  config_param :port
+  config_param :host
+  config_param :name_keys
+  config_param :name_key_pattern
+  config_param :add_key_prefix
+  config_param :value_type
+  config_param :units
+  config_param :group
+  config_param :title
+  config_param :tmax
+  config_param :dmax
+  config_param :slope
+  config_param :spoof
+  config_param :bind_hostname
+end
+
+class Fluent::GangliaTestOutput < Fluent::Output
+  Fluent::Plugin.register_output('ganglia_test', self)
+  config_param :port
+  config_param :host
+  config_param :name_keys
+  config_param :name_key_pattern
+  config_param :add_key_prefix
+  config_param :value_type
+  config_param :units
+  config_param :group
+  config_param :title
+  config_param :tmax
+  config_param :dmax
+  config_param :slope
+  config_param :spoof
+  config_param :bind_hostname
+end

metadata

@@ -0,0 +1,121 @@
+--- !ruby/object:Gem::Specification
+name: fluent-plugin-ganglia
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Hiroshi Sakai
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-03-10 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: fluentd
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: fluentd
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: gmetric
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Fluentd output plugin to ganglia
+email:
+- ziguzagu@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- README.rdoc
+- Rakefile
+- fluent-plugin-ganglia.gemspec
+- lib/fluent/plugin/out_ganglia.rb
+- test/helper.rb
+- test/plugin/test_out_ganglia.rb
+- test/plugins.rb
+homepage: https://github.com/ziguzagu/fluent-plugin-ganglia
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: Fluentd output plugin to ganglia
+test_files:
+- test/helper.rb
+- test/plugin/test_out_ganglia.rb
+- test/plugins.rb