logstash-output-datadog_metrics 3.0.0 → 3.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: e7a0c5110fd5ca55d0975e4ef8dda085e5ae6d78
-  data.tar.gz: dfba3be7bc31453f548b7e6526a7e07b185e2c79
+  metadata.gz: ef04ec9cb2f2c563f7001a554f2bb30230d4d101
+  data.tar.gz: 685454a3e4e7e7116f2b4ca2c5b0895e2c4f7dba
 SHA512:
-  metadata.gz: a0af10bd52895b185c8d7162dd51ec3c913f4127ffdfc0d1a0ead47f805d2720d5ec2d68b475822a8f1a8d19934094470b5b73101729e5925c0ed10871ceae7a
-  data.tar.gz: 94baa3fc7ca45b43a8a665ad940385a033bea142fbf2dc41f949c18024aaee29c640b310f44d7ff3da9ecccab8d25740e659aec7c58baeb8e7ec7f809c123473
+  metadata.gz: e6fc5b6c25b189408318502995964e15932a4b666f75497ff485d03a5c31ce4521057d435695b9b1d4fa93e4b1698a192bc8c239278cd9c62e8d9a08e03c7b9c
+  data.tar.gz: 4db96cf173be3a3f6f57f21af2011874933809fe5e5818dd140cfe3473e94cc9be7efbe1420d5c904fc06bfb0cf4a5443bbd877a37516b5a82ca5894f969ee8d

data/Gemfile

@@ -1,2 +1,11 @@
 source 'https://rubygems.org'
-gemspec
+
+gemspec
+
+logstash_path = ENV["LOGSTASH_PATH"] || "../../logstash"
+use_logstash_source = ENV["LOGSTASH_SOURCE"] && ENV["LOGSTASH_SOURCE"].to_s == "1"
+
+if Dir.exist?(logstash_path) && use_logstash_source
+  gem 'logstash-core', :path => "#{logstash_path}/logstash-core"
+  gem 'logstash-core-plugin-api', :path => "#{logstash_path}/logstash-core-plugin-api"
+end

data/docs/index.asciidoc

@@ -0,0 +1,130 @@
+:plugin: datadog_metrics
+:type: output
+
+///////////////////////////////////////////
+START - GENERATED VARIABLES, DO NOT EDIT!
+///////////////////////////////////////////
+:version: %VERSION%
+:release_date: %RELEASE_DATE%
+:changelog_url: %CHANGELOG_URL%
+:include_path: ../../../../logstash/docs/include
+///////////////////////////////////////////
+END - GENERATED VARIABLES, DO NOT EDIT!
+///////////////////////////////////////////
+
+[id="plugins-{type}-{plugin}"]
+
+=== Datadog_metrics output plugin
+
+include::{include_path}/plugin_header.asciidoc[]
+
+==== Description
+
+This output lets you send metrics to
+DataDogHQ based on Logstash events.
+Default `queue_size` and `timeframe` are low in order to provide near realtime alerting.
+If you do not use Datadog for alerting, consider raising these thresholds.
+
+[id="plugins-{type}s-{plugin}-options"]
+==== Datadog_metrics Output Configuration Options
+
+This plugin supports the following configuration options plus the <<plugins-{type}s-{plugin}-common-options>> described later.
+
+[cols="<,<,<",options="header",]
+|=======================================================================
+|Setting |Input type|Required
+| <<plugins-{type}s-{plugin}-api_key>> |<<string,string>>|Yes
+| <<plugins-{type}s-{plugin}-dd_tags>> |<<array,array>>|No
+| <<plugins-{type}s-{plugin}-device>> |<<string,string>>|No
+| <<plugins-{type}s-{plugin}-host>> |<<string,string>>|No
+| <<plugins-{type}s-{plugin}-metric_name>> |<<string,string>>|No
+| <<plugins-{type}s-{plugin}-metric_type>> |<<string,string>>, one of `["gauge", "counter", "%{metric_type}"]`|No
+| <<plugins-{type}s-{plugin}-metric_value>> |<<,>>|No
+| <<plugins-{type}s-{plugin}-queue_size>> |<<number,number>>|No
+| <<plugins-{type}s-{plugin}-timeframe>> |<<number,number>>|No
+|=======================================================================
+
+Also see <<plugins-{type}s-{plugin}-common-options>> for a list of options supported by all
+output plugins.
+
+&nbsp;
+
+[id="plugins-{type}s-{plugin}-api_key"]
+===== `api_key` 
+
+  * This is a required setting.
+  * Value type is <<string,string>>
+  * There is no default value for this setting.
+
+Your DatadogHQ API key. https://app.datadoghq.com/account/settings#api
+
+[id="plugins-{type}s-{plugin}-dd_tags"]
+===== `dd_tags` 
+
+  * Value type is <<array,array>>
+  * There is no default value for this setting.
+
+Set any custom tags for this event,
+default are the Logstash tags if any.
+
+[id="plugins-{type}s-{plugin}-device"]
+===== `device` 
+
+  * Value type is <<string,string>>
+  * Default value is `"%{metric_device}"`
+
+The name of the device that produced the metric.
+
+[id="plugins-{type}s-{plugin}-host"]
+===== `host` 
+
+  * Value type is <<string,string>>
+  * Default value is `"%{host}"`
+
+The name of the host that produced the metric.
+
+[id="plugins-{type}s-{plugin}-metric_name"]
+===== `metric_name` 
+
+  * Value type is <<string,string>>
+  * Default value is `"%{metric_name}"`
+
+The name of the time series.
+
+[id="plugins-{type}s-{plugin}-metric_type"]
+===== `metric_type` 
+
+  * Value can be any of: `gauge`, `counter`, `%{metric_type}`
+  * Default value is `"%{metric_type}"`
+
+The type of the metric.
+
+[id="plugins-{type}s-{plugin}-metric_value"]
+===== `metric_value` 
+
+  * Value type is <<string,string>>
+  * Default value is `"%{metric_value}"`
+
+The value.
+
+[id="plugins-{type}s-{plugin}-queue_size"]
+===== `queue_size` 
+
+  * Value type is <<number,number>>
+  * Default value is `10`
+
+How many events to queue before flushing to Datadog
+prior to schedule set in `@timeframe`
+
+[id="plugins-{type}s-{plugin}-timeframe"]
+===== `timeframe` 
+
+  * Value type is <<number,number>>
+  * Default value is `10`
+
+How often (in seconds) to flush queued events to Datadog
+
+
+
+[id="plugins-{type}s-{plugin}-common-options"]
+include::{include_path}/{type}.asciidoc[]

data/logstash-output-datadog_metrics.gemspec

@@ -1,6 +1,6 @@
 Gem::Specification.new do |s|
   s.name            = 'logstash-output-datadog_metrics'
-  s.version         = '3.0.0'
+  s.version         = '3.0.1'
   s.licenses        = ['Apache License (2.0)']
   s.summary         = "This output lets you send metrics to DataDogHQ based on Logstash events."
   s.description     = "This gem is a Logstash plugin required to be installed on top of the Logstash core pipeline using $LS_HOME/bin/logstash-plugin install gemname. This gem is not a stand-alone program"
@@ -10,7 +10,7 @@ Gem::Specification.new do |s|
   s.require_paths = ["lib"]
 
   # Files
-  s.files = Dir['lib/**/*','spec/**/*','vendor/**/*','*.gemspec','*.md','CONTRIBUTORS','Gemfile','LICENSE','NOTICE.TXT']
+  s.files = Dir["lib/**/*","spec/**/*","*.gemspec","*.md","CONTRIBUTORS","Gemfile","LICENSE","NOTICE.TXT", "vendor/jar-dependencies/**/*.jar", "vendor/jar-dependencies/**/*.rb", "VERSION", "docs/**/*"]
 
   # Tests
   s.test_files = s.files.grep(%r{^(test|spec|features)/})

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: logstash-output-datadog_metrics
 version: !ruby/object:Gem::Version
-  version: 3.0.0
+  version: 3.0.1
 platform: ruby
 authors:
 - Elastic
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2016-09-09 00:00:00.000000000 Z
+date: 2017-06-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   requirement: !ruby/object:Gem::Requirement
@@ -70,6 +70,7 @@ files:
 - LICENSE
 - NOTICE.TXT
 - README.md
+- docs/index.asciidoc
 - lib/logstash/outputs/datadog_metrics.rb
 - logstash-output-datadog_metrics.gemspec
 - spec/outputs/datadog_metrics_spec.rb