logstash-output-metriccatcher 3.0.0 → 3.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/Gemfile +10 -1
- data/docs/index.asciidoc +164 -0
- data/logstash-output-metriccatcher.gemspec +2 -2
- metadata +3 -2
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA1:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: bf185005f47230ba607fa32adc2cbc855c0750b5
|
|
4
|
+
data.tar.gz: aeaace05eff1ffbe2d9ca13c65009484456a0a30
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: 00aa76135900567997ec95bf3ce005f99f04c76f5a03e074bbf31051bf6a684493df561f7c602f964c4256a40b038f950ff6ff751d9fe1c03ce3fd81d59e80bf
|
|
7
|
+
data.tar.gz: 04259bfa38494861afa0f8dcc59c74984e7a7b11c26c524eda502796774288a298f7f1fa5fe4dea090369998020253060469925d42b12ca7da9b978ae884b927
|
data/Gemfile
CHANGED
|
@@ -1,2 +1,11 @@
|
|
|
1
1
|
source 'https://rubygems.org'
|
|
2
|
-
|
|
2
|
+
|
|
3
|
+
gemspec
|
|
4
|
+
|
|
5
|
+
logstash_path = ENV["LOGSTASH_PATH"] || "../../logstash"
|
|
6
|
+
use_logstash_source = ENV["LOGSTASH_SOURCE"] && ENV["LOGSTASH_SOURCE"].to_s == "1"
|
|
7
|
+
|
|
8
|
+
if Dir.exist?(logstash_path) && use_logstash_source
|
|
9
|
+
gem 'logstash-core', :path => "#{logstash_path}/logstash-core"
|
|
10
|
+
gem 'logstash-core-plugin-api', :path => "#{logstash_path}/logstash-core-plugin-api"
|
|
11
|
+
end
|
data/docs/index.asciidoc
ADDED
|
@@ -0,0 +1,164 @@
|
|
|
1
|
+
:plugin: metriccatcher
|
|
2
|
+
:type: output
|
|
3
|
+
|
|
4
|
+
///////////////////////////////////////////
|
|
5
|
+
START - GENERATED VARIABLES, DO NOT EDIT!
|
|
6
|
+
///////////////////////////////////////////
|
|
7
|
+
:version: %VERSION%
|
|
8
|
+
:release_date: %RELEASE_DATE%
|
|
9
|
+
:changelog_url: %CHANGELOG_URL%
|
|
10
|
+
:include_path: ../../../../logstash/docs/include
|
|
11
|
+
///////////////////////////////////////////
|
|
12
|
+
END - GENERATED VARIABLES, DO NOT EDIT!
|
|
13
|
+
///////////////////////////////////////////
|
|
14
|
+
|
|
15
|
+
[id="plugins-{type}-{plugin}"]
|
|
16
|
+
|
|
17
|
+
=== Metriccatcher output plugin
|
|
18
|
+
|
|
19
|
+
include::{include_path}/plugin_header.asciidoc[]
|
|
20
|
+
|
|
21
|
+
==== Description
|
|
22
|
+
|
|
23
|
+
This output ships metrics to MetricCatcher, allowing you to
|
|
24
|
+
utilize Coda Hale's Metrics.
|
|
25
|
+
|
|
26
|
+
More info on MetricCatcher: https://github.com/clearspring/MetricCatcher
|
|
27
|
+
|
|
28
|
+
At Clearspring, we use it to count the response codes from Apache logs:
|
|
29
|
+
[source,ruby]
|
|
30
|
+
metriccatcher {
|
|
31
|
+
host => "localhost"
|
|
32
|
+
port => "1420"
|
|
33
|
+
type => "apache-access"
|
|
34
|
+
fields => [ "response" ]
|
|
35
|
+
meter => {
|
|
36
|
+
"%{host}.apache.response.%{response}" => "1"
|
|
37
|
+
}
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
[id="plugins-{type}s-{plugin}-options"]
|
|
41
|
+
==== Metriccatcher Output Configuration Options
|
|
42
|
+
|
|
43
|
+
This plugin supports the following configuration options plus the <<plugins-{type}s-{plugin}-common-options>> described later.
|
|
44
|
+
|
|
45
|
+
[cols="<,<,<",options="header",]
|
|
46
|
+
|=======================================================================
|
|
47
|
+
|Setting |Input type|Required
|
|
48
|
+
| <<plugins-{type}s-{plugin}-biased>> |<<hash,hash>>|No
|
|
49
|
+
| <<plugins-{type}s-{plugin}-counter>> |<<hash,hash>>|No
|
|
50
|
+
| <<plugins-{type}s-{plugin}-gauge>> |<<hash,hash>>|No
|
|
51
|
+
| <<plugins-{type}s-{plugin}-host>> |<<string,string>>|No
|
|
52
|
+
| <<plugins-{type}s-{plugin}-meter>> |<<hash,hash>>|No
|
|
53
|
+
| <<plugins-{type}s-{plugin}-port>> |<<number,number>>|No
|
|
54
|
+
| <<plugins-{type}s-{plugin}-timer>> |<<hash,hash>>|No
|
|
55
|
+
| <<plugins-{type}s-{plugin}-uniform>> |<<hash,hash>>|No
|
|
56
|
+
|=======================================================================
|
|
57
|
+
|
|
58
|
+
Also see <<plugins-{type}s-{plugin}-common-options>> for a list of options supported by all
|
|
59
|
+
output plugins.
|
|
60
|
+
|
|
61
|
+
|
|
62
|
+
|
|
63
|
+
[id="plugins-{type}s-{plugin}-biased"]
|
|
64
|
+
===== `biased`
|
|
65
|
+
|
|
66
|
+
* Value type is <<hash,hash>>
|
|
67
|
+
* There is no default value for this setting.
|
|
68
|
+
|
|
69
|
+
The metrics to send. This supports dynamic strings like `%{host}`
|
|
70
|
+
for metric names and also for values. This is a hash field with key
|
|
71
|
+
of the metric name, value of the metric value.
|
|
72
|
+
|
|
73
|
+
The value will be coerced to a floating point value. Values which cannot be
|
|
74
|
+
coerced will zero (0)
|
|
75
|
+
|
|
76
|
+
[id="plugins-{type}s-{plugin}-counter"]
|
|
77
|
+
===== `counter`
|
|
78
|
+
|
|
79
|
+
* Value type is <<hash,hash>>
|
|
80
|
+
* There is no default value for this setting.
|
|
81
|
+
|
|
82
|
+
The metrics to send. This supports dynamic strings like `%{host}`
|
|
83
|
+
for metric names and also for values. This is a hash field with key
|
|
84
|
+
of the metric name, value of the metric value. Example:
|
|
85
|
+
[source,ruby]
|
|
86
|
+
counter => { "%{host}.apache.hits.%{response} => "1" }
|
|
87
|
+
|
|
88
|
+
The value will be coerced to a floating point value. Values which cannot be
|
|
89
|
+
coerced will zero (0)
|
|
90
|
+
|
|
91
|
+
[id="plugins-{type}s-{plugin}-gauge"]
|
|
92
|
+
===== `gauge`
|
|
93
|
+
|
|
94
|
+
* Value type is <<hash,hash>>
|
|
95
|
+
* There is no default value for this setting.
|
|
96
|
+
|
|
97
|
+
The metrics to send. This supports dynamic strings like `%{host}`
|
|
98
|
+
for metric names and also for values. This is a hash field with key
|
|
99
|
+
of the metric name, value of the metric value.
|
|
100
|
+
|
|
101
|
+
The value will be coerced to a floating point value. Values which cannot be
|
|
102
|
+
coerced will zero (0)
|
|
103
|
+
|
|
104
|
+
[id="plugins-{type}s-{plugin}-host"]
|
|
105
|
+
===== `host`
|
|
106
|
+
|
|
107
|
+
* Value type is <<string,string>>
|
|
108
|
+
* Default value is `"localhost"`
|
|
109
|
+
|
|
110
|
+
The address of the MetricCatcher
|
|
111
|
+
|
|
112
|
+
[id="plugins-{type}s-{plugin}-meter"]
|
|
113
|
+
===== `meter`
|
|
114
|
+
|
|
115
|
+
* Value type is <<hash,hash>>
|
|
116
|
+
* There is no default value for this setting.
|
|
117
|
+
|
|
118
|
+
The metrics to send. This supports dynamic strings like `%{host}`
|
|
119
|
+
for metric names and also for values. This is a hash field with key
|
|
120
|
+
of the metric name, value of the metric value.
|
|
121
|
+
|
|
122
|
+
The value will be coerced to a floating point value. Values which cannot be
|
|
123
|
+
coerced will zero (0)
|
|
124
|
+
|
|
125
|
+
[id="plugins-{type}s-{plugin}-port"]
|
|
126
|
+
===== `port`
|
|
127
|
+
|
|
128
|
+
* Value type is <<number,number>>
|
|
129
|
+
* Default value is `1420`
|
|
130
|
+
|
|
131
|
+
The port to connect on your MetricCatcher
|
|
132
|
+
|
|
133
|
+
[id="plugins-{type}s-{plugin}-timer"]
|
|
134
|
+
===== `timer`
|
|
135
|
+
|
|
136
|
+
* Value type is <<hash,hash>>
|
|
137
|
+
* There is no default value for this setting.
|
|
138
|
+
|
|
139
|
+
The metrics to send. This supports dynamic strings like %{host}
|
|
140
|
+
for metric names and also for values. This is a hash field with key
|
|
141
|
+
of the metric name, value of the metric value. Example:
|
|
142
|
+
[source,ruby]
|
|
143
|
+
timer => { "%{host}.apache.response_time => "%{response_time}" }
|
|
144
|
+
|
|
145
|
+
The value will be coerced to a floating point value. Values which cannot be
|
|
146
|
+
coerced will zero (0)
|
|
147
|
+
|
|
148
|
+
[id="plugins-{type}s-{plugin}-uniform"]
|
|
149
|
+
===== `uniform`
|
|
150
|
+
|
|
151
|
+
* Value type is <<hash,hash>>
|
|
152
|
+
* There is no default value for this setting.
|
|
153
|
+
|
|
154
|
+
The metrics to send. This supports dynamic strings like `%{host}`
|
|
155
|
+
for metric names and also for values. This is a hash field with key
|
|
156
|
+
of the metric name, value of the metric value.
|
|
157
|
+
|
|
158
|
+
The value will be coerced to a floating point value. Values which cannot be
|
|
159
|
+
coerced will zero (0)
|
|
160
|
+
|
|
161
|
+
|
|
162
|
+
|
|
163
|
+
[id="plugins-{type}s-{plugin}-common-options"]
|
|
164
|
+
include::{include_path}/{type}.asciidoc[]
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Gem::Specification.new do |s|
|
|
2
2
|
s.name = 'logstash-output-metriccatcher'
|
|
3
|
-
s.version = '3.0.
|
|
3
|
+
s.version = '3.0.1'
|
|
4
4
|
s.licenses = ['Apache License (2.0)']
|
|
5
5
|
s.summary = "This output ships metrics to MetricCatcher"
|
|
6
6
|
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|
|
|
|
10
10
|
s.require_paths = ["lib"]
|
|
11
11
|
|
|
12
12
|
# Files
|
|
13
|
-
s.files = Dir[
|
|
13
|
+
s.files = Dir["lib/**/*","spec/**/*","*.gemspec","*.md","CONTRIBUTORS","Gemfile","LICENSE","NOTICE.TXT", "vendor/jar-dependencies/**/*.jar", "vendor/jar-dependencies/**/*.rb", "VERSION", "docs/**/*"]
|
|
14
14
|
|
|
15
15
|
# Tests
|
|
16
16
|
s.test_files = s.files.grep(%r{^(test|spec|features)/})
|
metadata
CHANGED
|
@@ -1,14 +1,14 @@
|
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
|
2
2
|
name: logstash-output-metriccatcher
|
|
3
3
|
version: !ruby/object:Gem::Version
|
|
4
|
-
version: 3.0.
|
|
4
|
+
version: 3.0.1
|
|
5
5
|
platform: ruby
|
|
6
6
|
authors:
|
|
7
7
|
- Elastic
|
|
8
8
|
autorequire:
|
|
9
9
|
bindir: bin
|
|
10
10
|
cert_chain: []
|
|
11
|
-
date:
|
|
11
|
+
date: 2017-06-23 00:00:00.000000000 Z
|
|
12
12
|
dependencies:
|
|
13
13
|
- !ruby/object:Gem::Dependency
|
|
14
14
|
requirement: !ruby/object:Gem::Requirement
|
|
@@ -56,6 +56,7 @@ files:
|
|
|
56
56
|
- LICENSE
|
|
57
57
|
- NOTICE.TXT
|
|
58
58
|
- README.md
|
|
59
|
+
- docs/index.asciidoc
|
|
59
60
|
- lib/logstash/outputs/metriccatcher.rb
|
|
60
61
|
- logstash-output-metriccatcher.gemspec
|
|
61
62
|
- spec/outputs/metriccatcher_spec.rb
|