fluent-plugin-dogstatsd-mediba 0.0.7

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: a297b61bd0812d8e8131266bea4dffa56beb19ac
+  data.tar.gz: 324fccae8ed2f25f452b19e04bb9c6a193f929f6
+SHA512:
+  metadata.gz: 8951f7726ebfa04b3a5d0267b8ace4359d49f386553a9dee7dfbbda304a4f27a5b6ad750fae93ffd327f145d31be995556b37f43adf435ddb0431db58a53f0b1
+  data.tar.gz: 8ddd66288081dcb0382fb58327c1b697d8a07e662bdb8a8e34f95efe5d42952960dd5cd28d07a1db8d1a56bc238b7506ceae2efa2a4d56daac3245bc735f40cc

data/.gitignore

@@ -0,0 +1,22 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log

data/Gemfile

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

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 Ryota Arai
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,129 @@
+# fluent-plugin-dogstatsd
+
+Fluend plugin for Dogstatsd, that is statsd server for Datadog.
+
+## Installation
+
+    $ gem install fluent-plugin-dogstatsd
+
+## Usage
+
+```
+$ echo '{"type": "increment", "key": "apache.requests", "tags": {"url": "/"}}' | fluent-cat dogstatsd.hello
+$ echo '{"type": "histogram", "key": "apache.response_time", "value": 10.5, "tags": {"url": "/hello"}}' | fluent-cat dogstatsd.hello
+$ echo '{"type": "event", "title": "Deploy", "text": "New revision"}' | fluent-cat dogstatsd.hello
+```
+
+Supported types are `increment`, `decrement`, `count`, `gauge`, `histogram`, `timing`, `set` and `event`.
+
+## Configuration
+
+```
+<match dogstatsd.*>
+  type dogstatsd
+
+  # Dogstatsd host
+  host localhost
+
+  # Dogstatsd port
+  port 8125
+
+  # Use tag of fluentd record as key sent to Dogstatsd
+  use_tag_as_key false
+
+  # (Treat fields in a record as tags)
+  # flat_tags true
+
+  # (Metric type in Datadog.)
+  # metric_type increment
+
+  # Default: "value"
+  # value_key Value
+</match>
+```
+
+## Example
+
+### Count log lines
+
+```apache
+<source>
+  type tail
+  path /tmp/sample.log
+  tag datadog.increment.sample
+  format ...
+</source>
+
+<match datadog.increment.*>
+  type dogstatsd
+  metric_type increment
+  flat_tags true
+  use_tag_as_key true
+</match>
+```
+
+### Histogram
+
+```apache
+<source>
+  type tail
+  path /tmp/sample.log
+  tag datadog.histogram.sample
+  format /^(?<value>[^ ]*) (?<host>[^ ]*)$/
+</source>
+
+<match datadog.histogram.*>
+  type dogstatsd
+  metric_type histogram
+  flat_tags true
+  use_tag_as_key true
+</match>
+```
+
+### Event
+
+```apache
+<source>
+  type tail
+  path /var/log/nginx/error.log
+  pos_file /var/log/td-agent/error.log.pos
+  format multiline
+  format_firstline /^\d{4}/\d{2}/\d{2} \d{2}:\d{2}:\d{2} \[\w+\] (?<pid>\d+).(?<tid>\d+): /
+  format1 /^(?<time>\d{4}/\d{2}/\d{2} \d{2}:\d{2}:\d{2}) \[(?<log_level>\w+)\] (?<pid>\d+).(?<tid>\d+): (?<message>.*)/
+  multiline_flush_interval 3s
+  tag datadog.nginx.errorlog
+</source>
+
+<match datadog.nginx.errorlog>
+  type dogstatsd
+  metric_type event
+  use_tag_as_title true
+  text_key message
+</match>
+```
+
+### MySQL threads
+
+```apache
+<source>
+  type mysql_query
+  tag datadog.histogram.mysql_threads
+  query SHOW VARIABLES LIKE 'Thread_%'
+</source>
+
+<match datadog.histogram.mysql_threads>
+  type dogstatsd
+  metric_type histogram
+  value_key Value
+  flat_tags true
+  use_tag_as_key true
+</match>
+```
+
+## Contributing
+
+1. Fork it ( https://github.com/ryotarai/fluent-plugin-dogstatsd/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create a new Pull Request

data/Rakefile

@@ -0,0 +1,9 @@
+require "bundler/gem_tasks"
+
+require 'rake/testtask'
+
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'test'
+  test.test_files = FileList['test/plugin/*.rb']
+end
+

data/fluent-plugin-dogstatsd-mediba.gemspec

@@ -0,0 +1,26 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'fluent/plugin/dogstatsd/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "fluent-plugin-dogstatsd-mediba"
+  spec.version       = Fluent::Plugin::Dogstatsd::VERSION
+  spec.authors       = ["Hiroki Yoshida"]
+  spec.email         = ["h-yoshida@mediba.jp"]
+  spec.summary       = %q{Fluent plugin for Dogstatsd, that is statsd server for Datadog.}
+  spec.homepage      = "https://github.com/yoshida-mediba/fluent-plugin-dogstatsd"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency "fluentd"
+  spec.add_dependency "dogstatsd-ruby", "~> 1.4.1"
+
+  spec.add_development_dependency "bundler", "~> 1.6"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "test-unit"
+end

data/lib/fluent/plugin/dogstatsd.rb

@@ -0,0 +1,9 @@
+require "fluent/plugin/dogstatsd/version"
+
+module Fluent
+  module Plugin
+    module Dogstatsd
+      # Your code goes here...
+    end
+  end
+end

data/lib/fluent/plugin/dogstatsd/version.rb

@@ -0,0 +1,7 @@
+module Fluent
+  module Plugin
+    module Dogstatsd
+      VERSION = "0.0.7"
+    end
+  end
+end

data/lib/fluent/plugin/out_dogstatsd.rb

@@ -0,0 +1,108 @@
+module Fluent
+  class DogstatsdOutput < BufferedOutput
+    Plugin.register_output('dogstatsd', self)
+
+    config_param :host, :string, :default => nil
+    config_param :port, :integer, :default => nil
+    config_param :use_tag_as_key, :bool, :default => false
+    config_param :use_tag_as_key_if_missing, :bool, :default => false
+    config_param :flat_tags, :bool, :default => false
+    config_param :flat_tag, :bool, :default => false # obsolete
+    config_param :metric_type, :string, :default => nil
+    config_param :value_key, :string, :default => nil
+    config_param :text_key, :string, :default => nil
+    config_param :sample_rate, :float, :default => nil
+
+    unless method_defined?(:log)
+      define_method(:log) { $log }
+    end
+
+    attr_accessor :statsd
+
+    def initialize
+      super
+
+      require 'statsd' # dogstatsd-ruby
+    end
+
+    def start
+      super
+
+      host = @host || Statsd::DEFAULT_HOST
+      port = @port || Statsd::DEFAULT_PORT
+
+      @statsd ||= Statsd.new(host, port)
+    end
+
+    def format(tag, time, record)
+      [tag, time, record].to_msgpack
+    end
+
+    def write(chunk)
+      @statsd.batch do |s|
+        chunk.msgpack_each do |tag, time, record|
+          key = if @use_tag_as_key
+                  tag
+                else
+                  record.delete('key')
+                end
+
+          if !key && @use_tag_as_key_if_missing
+            key = tag
+          end
+
+          unless key
+            log.warn "'key' is not specified. skip this record:", tag: tag
+            next
+          end
+
+          value = record.delete(@value_key || 'value')
+
+          options = {}
+          text  = record.delete(@text_key || 'text')
+          type  = @metric_type || record.delete('type')
+          sample_rate = @sample_rate || record.delete('sample_rate')
+
+          if sample_rate
+            options[:sample_rate] = sample_rate
+          end
+
+          tags = if @flat_tags || @flat_tag
+                   record
+                 else
+                   record['tags']
+                 end
+          if tags
+            options[:tags] = tags.map do |k, v|
+              "#{k}:#{v}"
+            end
+          end
+
+          case type
+          when 'increment'
+            s.increment(key, options)
+          when 'decrement'
+            s.decrement(key, options)
+          when 'count'
+            s.count(key, value, options)
+          when 'gauge'
+            s.gauge(key, value, options)
+          when 'histogram'
+            s.histogram(key, value, options)
+          when 'timing'
+            s.timing(key, value, options)
+          when 'set'
+            s.set(key, value, options)
+          when 'event'
+            options[:alert_type] = record['alert_type']
+            s.event(key, text, options)
+          when nil
+            log.warn "type is not provided (You can provide type via `metric_type` in config or `type` field in a record."
+          else
+            log.warn "Type '#{type}' is unknown."
+          end
+        end
+      end
+    end
+  end
+end

data/test/plugin/test_out_dogstatsd.rb

@@ -0,0 +1,171 @@
+require 'test_helper'
+
+class DummyStatsd
+  attr_reader :messages
+
+  def initialize
+    @messages = []
+  end
+
+  def batch
+    yield(self)
+  end
+
+  %i!increment decrement count gauge histogram timing set event!.each do |name|
+    define_method(name) do |*args|
+      @messages << [name, args].flatten
+    end
+  end
+end
+
+class DogstatsdOutputTest < Test::Unit::TestCase
+  def setup
+    Fluent::Test.setup
+    require 'fluent/plugin/out_dogstatsd'
+  end
+
+  def teardown
+  end
+
+  def test_configure
+    d = create_driver(<<-EOC)
+      type dogstatsd
+      host HOST
+      port 12345
+    EOC
+
+    assert_equal('HOST', d.instance.host)
+    assert_equal(12345, d.instance.port)
+  end
+
+  def test_write
+    d = create_driver
+
+    d.emit({'type' => 'increment', 'key' => 'hello.world1'}, Time.now.to_i)
+    d.emit({'type' => 'increment', 'key' => 'hello.world2'}, Time.now.to_i)
+    d.emit({'type' => 'decrement', 'key' => 'hello.world'}, Time.now.to_i)
+    d.emit({'type' => 'count', 'value' => 10, 'key' => 'hello.world'}, Time.now.to_i)
+    d.emit({'type' => 'gauge', 'value' => 10, 'key' => 'hello.world'}, Time.now.to_i)
+    d.emit({'type' => 'histogram', 'value' => 10, 'key' => 'hello.world'}, Time.now.to_i)
+    d.emit({'type' => 'timing', 'value' => 10, 'key' => 'hello.world'}, Time.now.to_i)
+    d.emit({'type' => 'set', 'value' => 10, 'key' => 'hello.world'}, Time.now.to_i)
+    d.emit({'type' => 'event', 'title' => 'Deploy', 'text' => 'Revision', 'key' => 'hello.world'}, Time.now.to_i)
+    d.run
+
+    assert_equal(d.instance.statsd.messages, [
+      [:increment, 'hello.world1', {}],
+      [:increment, 'hello.world2', {}],
+      [:decrement, 'hello.world', {}],
+      [:count, 'hello.world', 10, {}],
+      [:gauge, 'hello.world', 10, {}],
+      [:histogram, 'hello.world', 10, {}],
+      [:timing, 'hello.world', 10, {}],
+      [:set, 'hello.world', 10, {}],
+      [:event, 'Deploy', 'Revision', {}],
+    ])
+  end
+
+  def test_flat_tag
+    d = create_driver(<<-EOC)
+#{default_config}
+flat_tag true
+    EOC
+
+    d.emit({'type' => 'increment', 'key' => 'hello.world', 'tagKey' => 'tagValue'}, Time.now.to_i)
+    d.run
+
+    assert_equal(d.instance.statsd.messages, [
+      [:increment, 'hello.world', {tags: ["tagKey:tagValue"]}],
+    ])
+  end
+
+  def test_metric_type
+    d = create_driver(<<-EOC)
+#{default_config}
+metric_type decrement
+    EOC
+
+    d.emit({'key' => 'hello.world', 'tags' => {'tagKey' => 'tagValue'}}, Time.now.to_i)
+    d.run
+
+    assert_equal(d.instance.statsd.messages, [
+      [:decrement, 'hello.world', {tags: ["tagKey:tagValue"]}],
+    ])
+  end
+
+  def test_use_tag_as_key
+    d = create_driver(<<-EOC)
+#{default_config}
+use_tag_as_key true
+    EOC
+
+    d.emit({'type' => 'increment'}, Time.now.to_i)
+    d.run
+
+    assert_equal(d.instance.statsd.messages, [
+      [:increment, 'dogstatsd.tag', {}],
+    ])
+  end
+
+  def test_use_tag_as_key_fallback
+    d = create_driver(<<-EOC)
+#{default_config}
+use_tag_as_key_if_missing true
+    EOC
+
+    d.emit({'type' => 'increment'}, Time.now.to_i)
+    d.run
+
+    assert_equal(d.instance.statsd.messages, [
+      [:increment, 'dogstatsd.tag', {}],
+    ])
+  end
+
+  def test_tags
+    d = create_driver
+    d.emit({'type' => 'increment', 'key' => 'hello.world', 'tags' => {'key' => 'value'}}, Time.now.to_i)
+    d.run
+
+    assert_equal(d.instance.statsd.messages, [
+      [:increment, 'hello.world', {tags: ["key:value"]}],
+    ])
+  end
+
+  def test_sample_rate_config
+    d = create_driver(<<-EOC)
+#{default_config}
+sample_rate .5
+    EOC
+
+    d.emit({'type' => 'increment', 'key' => 'tag'}, Time.now.to_i)
+    d.run
+
+    assert_equal(d.instance.statsd.messages, [
+      [:increment, 'tag', {sample_rate: 0.5}],
+    ])
+  end
+
+  def test_sample_rate
+    d = create_driver
+    d.emit({'type' => 'increment', 'sample_rate' => 0.5, 'key' => 'tag'}, Time.now.to_i)
+    d.run
+
+    assert_equal(d.instance.statsd.messages, [
+      [:increment, 'tag', {sample_rate: 0.5}],
+    ])
+  end
+
+  private
+  def default_config
+    <<-EOC
+    type dogstatsd
+    EOC
+  end
+
+  def create_driver(conf = default_config)
+    Fluent::Test::BufferedOutputTestDriver.new(Fluent::DogstatsdOutput, 'dogstatsd.tag').configure(conf).tap do |d|
+      d.instance.statsd = DummyStatsd.new
+    end
+  end
+end
+

data/test/test_helper.rb

@@ -0,0 +1,3 @@
+require 'test/unit'
+require 'fluent/test'
+

metadata

@@ -0,0 +1,127 @@
+--- !ruby/object:Gem::Specification
+name: fluent-plugin-dogstatsd-mediba
+version: !ruby/object:Gem::Version
+  version: 0.0.7
+platform: ruby
+authors:
+- Hiroki Yoshida
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-11-24 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: fluentd
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: dogstatsd-ruby
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.4.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.4.1
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: test-unit
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: 
+email:
+- h-yoshida@mediba.jp
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- fluent-plugin-dogstatsd-mediba.gemspec
+- lib/fluent/plugin/dogstatsd.rb
+- lib/fluent/plugin/dogstatsd/version.rb
+- lib/fluent/plugin/out_dogstatsd.rb
+- test/plugin/test_out_dogstatsd.rb
+- test/test_helper.rb
+homepage: https://github.com/yoshida-mediba/fluent-plugin-dogstatsd
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.5.2
+signing_key: 
+specification_version: 4
+summary: Fluent plugin for Dogstatsd, that is statsd server for Datadog.
+test_files:
+- test/plugin/test_out_dogstatsd.rb
+- test/test_helper.rb