logstash-output-dogstatsd 1.3.0 → 2.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: b5ddb05f4531bbcabcd244a0dba19614a95a003a
-  data.tar.gz: b8a1da9467d14137a19f35320b9c40f35fbc81d5
+  metadata.gz: fb60ee39b04f8b4cc73d0ae258eb98ec9a24c275
+  data.tar.gz: 89d5c802803972370fcf61125c0b8a5f85e6c677
 SHA512:
-  metadata.gz: 7b63850c1cf2c3e37e80297d04ee405f05f96eed298676353158387ba477c6f709b6cfda1bdc5f75c33f976281de56c66c07443687c0eab7ad12124afee8b969
-  data.tar.gz: e1e90e25ed3fb81c8864bd3f0dafafc24dcb7e7d0f3836e5fcef700c0386ff82cf7d19dce4bc301005aa87a4c09762b4f87f3264cf2ad9601c4529a07f2ce2ca
+  metadata.gz: e75c8013e39024ca5f802b2e223177ac766021c334d8b5fbc9e13f4cd2e9f9634cb8b5320ebb88d1411a9ccde7097a6898aa5b4491eb42c2ebda8c4e0d82cd15
+  data.tar.gz: 1b9fa80070b4f91ba19374e3a8e23e9451fe2a343fbcabee25febc22094735299bfa97604d0a3c7d01b6b24cda2f81a87b60f7d329fd3483fab08666c4c1ceba

data/CHANGELOG.md

@@ -1,3 +1,8 @@
+# 2.0.0
+- Updates from logstash-output-statsd v2.0.5.
+- Upgraded logstash-core dependency to 2.0.
+- Upgraded dogstatsd-ruby dependency to 1.6.
+
 # 0.9.0
 - First version of logstash-output-dogstatsd, forked from v1.1.0 of
   logstash-output-statsd.

data/README.md

@@ -1,15 +1,15 @@
 # Logstash Plugin
 
-This is a plugin for [Logstash](https://github.com/elasticsearch/logstash).
+This is a plugin for [Logstash](https://github.com/elastic/logstash).
 
 It is fully free and fully open source. The license is Apache 2.0, meaning you are pretty much free to use it however you want in whatever way.
 
 ## Documentation
 
-Logstash provides infrastructure to automatically generate documentation for this plugin. We use the asciidoc format to write documentation so any comments in the source code will be first converted into asciidoc and then into html. All plugin documentation are placed under one [central location](http://www.elasticsearch.org/guide/en/logstash/current/).
+Logstash provides infrastructure to automatically generate documentation for this plugin. We use the asciidoc format to write documentation so any comments in the source code will be first converted into asciidoc and then into html. All plugin documentation are placed under one [central location](http://www.elastic.co/guide/en/logstash/current/).
 
 - For formatting code or config example, you can use the asciidoc `[source,ruby]` directive
-- For more asciidoc formatting tips, see the excellent reference here https://github.com/elasticsearch/docs#asciidoc-guide
+- For more asciidoc formatting tips, see the excellent reference here https://github.com/elastic/docs#asciidoc-guide
 
 ## Need Help?
 
@@ -83,4 +83,4 @@ Programming is not a required skill. Whatever you've seen about open source and
 
 It is more important to the community that you are able to contribute.
 
-For more information about contributing, see the [CONTRIBUTING](https://github.com/elasticsearch/logstash/blob/master/CONTRIBUTING.md) file.
+For more information about contributing, see the [CONTRIBUTING](https://github.com/elastic/logstash/blob/master/CONTRIBUTING.md) file.

data/lib/logstash/outputs/dogstatsd.rb

@@ -19,50 +19,57 @@ end
 #
 # You can learn about statsd here:
 #
-# * http://codeascraft.etsy.com/2011/02/15/measure-anything-measure-everything/[Etsy blog post announcing statsd]
+# * https://codeascraft.com/2011/02/15/measure-anything-measure-everything/[Etsy blog post announcing statsd]
 # * https://github.com/etsy/statsd[statsd on github]
 #
-# A simple example usage of this is to count HTTP hits by response code; to learn
-# more about that, check out the ../tutorials/metrics-from-logs[log metrics tutorial]
+# Typical examples of how this can be used with Logstash include counting HTTP hits
+# by response code, summing the total number of bytes of traffic served, and tracking
+# the 50th and 95th percentile of the processing time of requests.
 #
 # Example:
 # [source,ruby]
 # output {
-#  dogstatsd {
-#   metric_tags => ["host:%{host}","role:foo"]
-#   count => {
-#    "http.bytes" => "%{bytes}"
+#   dogstatsd {
+#     metric_tags => ["host:%{host}","role:foo"]
+#     count => {
+#       "http.bytes" => "%{bytes}"
+#     }
 #   }
-#  }
 # }
 class LogStash::Outputs::Dogstatsd < LogStash::Outputs::Base
   ## Regex stolen from statsd code
   RESERVED_CHARACTERS_REGEX = /[\:\|\@]/
   config_name "dogstatsd"
 
-  # The address of the dogstatsd server.
+  # The hostname or IP address of the dogstatsd server.
   config :host, :validate => :string, :default => "localhost"
 
   # The port to connect to on your dogstatsd server.
   config :port, :validate => :number, :default => 8125
 
-  # An increment metric. Metric names as array.
+  # An increment metric. Metric names as array. `%{fieldname}` substitutions are
+  # allowed in the metric names.
   config :increment, :validate => :array, :default => []
 
-  # A decrement metric. Metric names as array.
+  # A decrement metric. Metric names as array. `%{fieldname}` substitutions are
+  # allowed in the metric names.
   config :decrement, :validate => :array, :default => []
 
   # A histogram metric, which a statsd timing but conceptually maps to any
-  # numeric value, not just durations. `metric_name => value` as hash
+  # numeric value, not just durations. `metric_name => value` as hash. `%{fieldname}`
+  # substitutions are allowed in the metric names.
   config :histogram, :validate => :hash, :default => {}
 
-  # A count metric. `metric_name => count` as hash
+  # A count metric. `metric_name => count` as hash. `%{fieldname}` substitutions are
+  # allowed in the metric names.
   config :count, :validate => :hash, :default => {}
 
-  # A set metric. `metric_name => "string"` to append as hash
+  # A set metric. `metric_name => "string"` to append as hash. `%{fieldname}`
+  # substitutions are allowed in the metric names.
   config :set, :validate => :hash, :default => {}
 
-  # A gauge metric. `metric_name => gauge` as hash.
+  # A gauge metric. `metric_name => gauge` as hash. `%{fieldname}` substitutions are
+  # allowed in the metric names.
   config :gauge, :validate => :hash, :default => {}
 
   # The sample rate for the metric.
@@ -78,7 +85,6 @@ class LogStash::Outputs::Dogstatsd < LogStash::Outputs::Base
 
   public
   def receive(event)
-    return unless output?(event)
     @logger.debug? and @logger.debug("Event: #{event}")
 
     metric_opts = {
@@ -110,4 +116,9 @@ class LogStash::Outputs::Dogstatsd < LogStash::Outputs::Base
       @client.gauge(event.sprintf(metric), event.sprintf(val), metric_opts)
     end
   end # def receive
+
+  public
+  def close
+    @client.close
+  end # def close
 end # class LogStash::Outputs::Statsd

data/logstash-output-dogstatsd.gemspec

@@ -1,7 +1,7 @@
 Gem::Specification.new do |s|
 
   s.name            = 'logstash-output-dogstatsd'
-  s.version         = '1.3.0'
+  s.version         = '2.0.0'
   s.licenses        = ['Apache License (2.0)']
   s.summary         = "Send metrics to StatsD"
   s.description     = "This gem is a logstash plugin required to be installed on top of the Logstash core pipeline using $LS_HOME/bin/plugin install gemname. This gem is not a stand-alone program"
@@ -11,7 +11,7 @@ Gem::Specification.new do |s|
   s.require_paths = ["lib"]
 
   # Files
-  s.files = `git ls-files`.split($\)+::Dir.glob('vendor/*')
+  s.files = Dir['lib/**/*','*.gemspec','*.md','CONTRIBUTORS','Gemfile','LICENSE','NOTICE.TXT']
 
   # Tests
   s.test_files = s.files.grep(%r{^(test|spec|features)/})
@@ -20,14 +20,13 @@ Gem::Specification.new do |s|
   s.metadata = { "logstash_plugin" => "true", "logstash_group" => "output" }
 
   # Gem dependencies
-  s.add_runtime_dependency "logstash-core", '>= 1.4.0', '< 2.0.0'
+  s.add_runtime_dependency "logstash-core", ">= 2.0.0.beta2", "< 3.0.0"
   s.add_runtime_dependency 'logstash-input-generator'
 
   # This version is pinned exactly to ensure that upgrades don't break the
   # gnarly `module_eval` hack in lib/logstash/outputs/dogstatsd.rb.
-  s.add_runtime_dependency 'dogstatsd-ruby', '= 1.5'
+  s.add_runtime_dependency 'dogstatsd-ruby', '= 1.6'
 
   s.add_development_dependency 'logstash-devutils'
   s.add_development_dependency 'overcommit'
 end
-

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: logstash-output-dogstatsd
 version: !ruby/object:Gem::Version
-  version: 1.3.0
+  version: 2.0.0
 platform: ruby
 authors:
 - Tom Dooner
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2015-08-28 00:00:00.000000000 Z
+date: 2016-07-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: logstash-core
@@ -16,18 +16,18 @@ dependencies:
     requirements:
     - - '>='
       - !ruby/object:Gem::Version
-        version: 1.4.0
+        version: 2.0.0.beta2
     - - <
       - !ruby/object:Gem::Version
-        version: 2.0.0
+        version: 3.0.0
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '>='
       - !ruby/object:Gem::Version
-        version: 1.4.0
+        version: 2.0.0.beta2
     - - <
       - !ruby/object:Gem::Version
-        version: 2.0.0
+        version: 3.0.0
   prerelease: false
   type: :runtime
 - !ruby/object:Gem::Dependency
@@ -50,12 +50,12 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: '1.5'
+        version: '1.6'
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: '1.5'
+        version: '1.6'
   prerelease: false
   type: :runtime
 - !ruby/object:Gem::Dependency
@@ -92,20 +92,14 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- .gitignore
-- .overcommit.yml
-- .ruby-version
 - CHANGELOG.md
 - CONTRIBUTORS
 - Gemfile
 - LICENSE
 - NOTICE.TXT
 - README.md
-- Rakefile
 - lib/logstash/outputs/dogstatsd.rb
 - logstash-output-dogstatsd.gemspec
-- spec/outputs/dogstatsd_spec.rb
-- spec/spec_helper.rb
 homepage: http://www.elastic.co/guide/en/logstash/current/index.html
 licenses:
 - Apache License (2.0)
@@ -132,6 +126,4 @@ rubygems_version: 2.4.6
 signing_key:
 specification_version: 4
 summary: Send metrics to StatsD
-test_files:
-- spec/outputs/dogstatsd_spec.rb
-- spec/spec_helper.rb
+test_files: []

data/.gitignore

@@ -1,4 +0,0 @@
-*.gem
-Gemfile.lock
-.bundle
-vendor

data/.overcommit.yml

@@ -1,13 +0,0 @@
-PreCommit:
-  HardTabs:
-    enabled: true
-
-  RuboCop:
-    enabled: true
-    command: ['bundle', 'exec', 'rubocop']
-
-  TrailingWhitespace:
-    enabled: true
-
-# Overcommit will use the repo's Gemfile when loading the Bundler context
-gemfile: Gemfile

data/.ruby-version

@@ -1 +0,0 @@
-jruby-1.7.20

data/Rakefile

@@ -1,7 +0,0 @@
-@files=[]
-
-task :default do
-  system("rake -T")
-end
-
-require "logstash/devutils/rake"

data/spec/outputs/dogstatsd_spec.rb

@@ -1,67 +0,0 @@
-# encoding: utf-8
-require 'logstash/outputs/dogstatsd'
-require_relative '../spec_helper'
-
-describe LogStash::Outputs::Dogstatsd do
-  let(:output) { described_class.new(config) }
-
-  let(:config) do
-    {
-      'host' => '127.0.0.1',
-      'port' => 8125
-    }.merge(metric_config)
-  end
-  let(:metric_config) { {} }
-
-  describe 'registration and teardown' do
-    it 'registers without errors' do
-      output = LogStash::Plugin.lookup('output', 'dogstatsd').new
-      expect { output.register }.to_not raise_error
-    end
-  end
-
-  describe '#send' do
-    before { output.register }
-    subject { output.receive(LogStash::Event.new(event)) }
-
-    let(:event) { { 'something_count' => 10 } }
-
-    context 'increment metrics' do
-      let(:metric_config) { { 'increment' => [metric_to_track] } }
-      let(:metric_to_track) { 'metric.name.here' }
-
-      context 'with a plain ol metric name' do
-        it 'tracks' do
-          expect_any_instance_of(Datadog::Statsd).to receive(:send_to_socket)
-            .with("#{metric_to_track}:1|c")
-          subject
-        end
-      end
-
-      context 'with tags' do
-        let(:metric_config) { super().merge('metric_tags' => ['foo:%{value}']) }
-        let(:event) { { 'value' => 'helloworld' } }
-
-        it 'sprintf tags' do
-          expect_any_instance_of(Datadog::Statsd).to receive(:send_to_socket)
-            .with("#{metric_to_track}:1|c|#foo:helloworld")
-          subject
-        end
-      end
-    end
-
-    context 'histogram metrics' do
-      let(:metric_to_track) { 'metric.name.here' }
-      let(:metric_config) { { 'histogram' => { '%{metric_name}' => '%{track_value}' } } }
-      let(:event) { super().merge('metric_name' => metric_to_track, 'track_value' => 123) }
-
-      context 'with event fields in the metric name and value' do
-        it 'tracks' do
-          expect_any_instance_of(Datadog::Statsd).to receive(:send_to_socket)
-            .with("#{metric_to_track}:123|h")
-          subject
-        end
-      end
-    end
-  end
-end

data/spec/spec_helper.rb

@@ -1,8 +0,0 @@
-require 'logstash/devutils/rspec/spec_helper'
-require 'logstash/outputs/dogstatsd'
-
-RSpec.configure do |c|
-  c.before do
-    allow_any_instance_of(Datadog::Statsd).to receive(:send_to_socket)
-  end
-end