logstash-filter-rest2 0.5.3
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +7 -0
- data/CHANGELOG.md +24 -0
- data/CONTRIBUTORS +11 -0
- data/Gemfile +2 -0
- data/LICENSE +13 -0
- data/README.md +92 -0
- data/lib/logstash/filters/rest.rb +320 -0
- data/logstash-filter-rest.gemspec +33 -0
- data/spec/filters/rest_spec.rb +406 -0
- metadata +118 -0
checksums.yaml
ADDED
@@ -0,0 +1,7 @@
|
|
1
|
+
---
|
2
|
+
SHA256:
|
3
|
+
metadata.gz: 5093c9df4843c58afdcf73d5340d27b56b2df0e13df0af8f34e9d83f4346653a
|
4
|
+
data.tar.gz: ea0db1681f4c9e948c9bf02e8b628575e9319c3e1ac23855aa904cbb3f7dba0d
|
5
|
+
SHA512:
|
6
|
+
metadata.gz: 705f79dae08026d09fd0355f9caa229573cc794cfec2380d2773e34dbdd8d7c3d1b804d0ac054e95306ed772ddf5af937d9bb1f148b214d22acb1b4601e1a986
|
7
|
+
data.tar.gz: 77eed5e5c69da9a35b928f9db1f9909f36d4f42c682f49ccf58121d2e258553eaf94e3dff51999e563933d528819ce162f6a8c6b403c4ea345e0639285705fc5
|
data/CHANGELOG.md
ADDED
@@ -0,0 +1,24 @@
|
|
1
|
+
## 0.5.3
|
2
|
+
- freeze all instance variables
|
3
|
+
- fix parallel processing by creating a `deep_clone` for each event
|
4
|
+
- use `LogStash::Util.deep_clone` for object cloning
|
5
|
+
- only dump body as json, if json is enabled in config (default)
|
6
|
+
- delete empty target testcase, as catched by upper logstash `LogStash::ConfigurationError`
|
7
|
+
- fix `sprintf` find and merge for more complex structures
|
8
|
+
|
9
|
+
## 0.5.2
|
10
|
+
- Fix behavior, where a referenced field (`%{...}`) has `ruby` chars
|
11
|
+
(i.e., consisting of `:`)
|
12
|
+
- Field interpolation is done by assigning explicit values instead
|
13
|
+
of converting the `sprintf` string back into a `hash`
|
14
|
+
|
15
|
+
## 0.5.0
|
16
|
+
- Relax constraint on logstash-core-plugin-api to >= 1.60 <= 2.99
|
17
|
+
- Require devutils >= 0 to make `bundler` update the package
|
18
|
+
- Use Event API for LS-5
|
19
|
+
- Implicit `sprintf`, deprecating the setting
|
20
|
+
- `target` is now required, dropping support to write into top-level in favor of only using new Event API
|
21
|
+
- this follows other logstash-plugins like `logstash-filter-json`
|
22
|
+
- if the response is empty, add the restfailure tags
|
23
|
+
- Some logging moved before code
|
24
|
+
- Testcases adapted to new behavior with error check
|
data/CONTRIBUTORS
ADDED
@@ -0,0 +1,11 @@
|
|
1
|
+
The following is a list of people who have contributed ideas, code, bug
|
2
|
+
reports, or in general have helped logstash along its way.
|
3
|
+
|
4
|
+
Contributors:
|
5
|
+
* Aaron Mildenstein (untergeek)
|
6
|
+
* Pier-Hugues Pellerin (ph)
|
7
|
+
|
8
|
+
Note: If you've sent us patches, bug reports, or otherwise contributed to
|
9
|
+
Logstash, and you aren't on the list above and want to be, please let us know
|
10
|
+
and we'll make sure you're here. Contributions from folks like you are what make
|
11
|
+
open source awesome.
|
data/Gemfile
ADDED
data/LICENSE
ADDED
@@ -0,0 +1,13 @@
|
|
1
|
+
Copyright (c) 2012–2015 Elasticsearch <http://www.elastic.co>
|
2
|
+
|
3
|
+
Licensed under the Apache License, Version 2.0 (the "License");
|
4
|
+
you may not use this file except in compliance with the License.
|
5
|
+
You may obtain a copy of the License at
|
6
|
+
|
7
|
+
http://www.apache.org/licenses/LICENSE-2.0
|
8
|
+
|
9
|
+
Unless required by applicable law or agreed to in writing, software
|
10
|
+
distributed under the License is distributed on an "AS IS" BASIS,
|
11
|
+
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
12
|
+
See the License for the specific language governing permissions and
|
13
|
+
limitations under the License.
|
data/README.md
ADDED
@@ -0,0 +1,92 @@
|
|
1
|
+
# Logstash REST Filter [![Build Status](https://travis-ci.org/gandalfb/logstash-filter-rest.svg?branch=master)](https://travis-ci.org/gandalfb/logstash-filter-rest)
|
2
|
+
|
3
|
+
This is a filter plugin for [Logstash](https://github.com/elasticsearch/logstash).
|
4
|
+
|
5
|
+
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.
|
6
|
+
|
7
|
+
## Documentation
|
8
|
+
|
9
|
+
This logstash filter provides an easy way to access RESTful Resources within logstash. It can be used to post data to a REST API or to gather data and save it in your log file.
|
10
|
+
|
11
|
+
## Usage
|
12
|
+
### 1. Installation
|
13
|
+
You can use the built-in plugin tool of Logstash to install the filter:
|
14
|
+
```
|
15
|
+
$LS_HOME/bin/logstash-plugin install logstash-filter-rest
|
16
|
+
```
|
17
|
+
|
18
|
+
Or you can build it yourself:
|
19
|
+
```
|
20
|
+
git clone https://github.com/lucashenning/logstash-filter-rest.git
|
21
|
+
bundle install
|
22
|
+
gem build logstash-filter-rest.gemspec
|
23
|
+
$LS_HOME/bin/logstash-plugin install logstash-filter-rest-0.1.0.gem
|
24
|
+
```
|
25
|
+
|
26
|
+
### 2. Filter Configuration
|
27
|
+
Add the following inside the filter section of your logstash configuration:
|
28
|
+
|
29
|
+
```sh
|
30
|
+
filter {
|
31
|
+
rest {
|
32
|
+
request => {
|
33
|
+
url => "http://example.com" # string (required, with field reference: "http://example.com?id=%{id}" or params, if defined)
|
34
|
+
method => "post" # string (optional, default = "get")
|
35
|
+
headers => { # hash (optional)
|
36
|
+
"key1" => "value1"
|
37
|
+
"key2" => "value2"
|
38
|
+
}
|
39
|
+
auth => {
|
40
|
+
user => "AzureDiamond"
|
41
|
+
password => "hunter2"
|
42
|
+
}
|
43
|
+
params => { # hash (optional, available for method => "get" and "post"; if post it will be transformed into body hash and posted as json)
|
44
|
+
"key1" => "value1"
|
45
|
+
"key2" => "value2"
|
46
|
+
"key3" => "%{somefield}" # sprintf is used implicitly
|
47
|
+
}
|
48
|
+
}
|
49
|
+
json => true # boolean (optional, default = true)
|
50
|
+
target => "my_key" # string (mandatory, no default)
|
51
|
+
fallback => { # hash describing a default in case of error
|
52
|
+
"key1" => "value1"
|
53
|
+
"key2" => "value2"
|
54
|
+
}
|
55
|
+
}
|
56
|
+
}
|
57
|
+
```
|
58
|
+
|
59
|
+
Print plugin version:
|
60
|
+
|
61
|
+
``` bash
|
62
|
+
bin/logstash-plugin list --verbose | grep rest
|
63
|
+
```
|
64
|
+
|
65
|
+
Examples for running logstash from `cli`:
|
66
|
+
|
67
|
+
``` bash
|
68
|
+
bin/logstash --debug -e 'input { stdin{} } filter { rest { request => { url => "https://jsonplaceholder.typicode.com/posts" method => "post" params => { "userId" => "%{message}" } headers => { "Content-Type" => "application/json" } } target => 'rest' } } output {stdout { codec => rubydebug }}'
|
69
|
+
```
|
70
|
+
|
71
|
+
``` bash
|
72
|
+
bin/logstash --debug -e 'input { stdin{} } filter { rest { request => { url => "https://jsonplaceholder.typicode.com/posts" method => "post" body => { "userId" => "%{message}" } headers => { "Content-Type" => "application/json" } } target => 'rest' } } output {stdout { codec => rubydebug }}'
|
73
|
+
```
|
74
|
+
|
75
|
+
``` bash
|
76
|
+
bin/logstash --debug -e 'input { stdin{} } filter { rest { request => { url => "http://jsonplaceholder.typicode.com/users/%{message}" } target => 'rest' } } output {stdout { codec => rubydebug }}'
|
77
|
+
```
|
78
|
+
|
79
|
+
``` bash
|
80
|
+
bin/logstash --debug -e 'input { stdin{} } filter { rest { request => { url => "https://jsonplaceholder.typicode.com/posts" method => "get" params => { "userId" => "%{message}" } headers => { "Content-Type" => "application/json" } } target => 'rest' } } output {stdout { codec => rubydebug }}'
|
81
|
+
```
|
82
|
+
|
83
|
+
|
84
|
+
## Contributing
|
85
|
+
|
86
|
+
All contributions are welcome: ideas, patches, documentation, bug reports, complaints, and even something you drew up on a napkin.
|
87
|
+
|
88
|
+
Programming is not a required skill. Whatever you've seen about open source and maintainers or community members saying "send patches or die" - you will not see that here.
|
89
|
+
|
90
|
+
It is more important to the community that you are able to contribute.
|
91
|
+
|
92
|
+
For more information about contributing, see the [CONTRIBUTING](https://github.com/elasticsearch/logstash/blob/master/CONTRIBUTING.md) file.
|
@@ -0,0 +1,320 @@
|
|
1
|
+
# encoding: utf-8
|
2
|
+
require 'logstash/filters/base'
|
3
|
+
require 'logstash/namespace'
|
4
|
+
require 'logstash/plugin_mixins/http_client'
|
5
|
+
require 'logstash/json'
|
6
|
+
|
7
|
+
# Monkey Patch hsh with a recursive compact and deep freeze
|
8
|
+
class Hash
|
9
|
+
def compact
|
10
|
+
delete_if { |_k, v| v.respond_to?(:each) ? v.compact.empty? : v.nil? }
|
11
|
+
end
|
12
|
+
|
13
|
+
def deep_freeze
|
14
|
+
each { |_k, v| v.deep_freeze if v.respond_to? :deep_freeze }
|
15
|
+
freeze
|
16
|
+
end
|
17
|
+
end
|
18
|
+
|
19
|
+
# Monkey Patch Array with deep freeze
|
20
|
+
class Array
|
21
|
+
def compact
|
22
|
+
delete_if { |v| v.respond_to?(:each) ? v.compact.empty? : v.nil? }
|
23
|
+
end
|
24
|
+
|
25
|
+
def deep_freeze
|
26
|
+
each { |j| j.deep_freeze if j.respond_to? :deep_freeze }
|
27
|
+
freeze
|
28
|
+
end
|
29
|
+
end
|
30
|
+
|
31
|
+
# Logstash REST Filter
|
32
|
+
# This filter calls a defined URL and saves the answer into a specified field.
|
33
|
+
#
|
34
|
+
class LogStash::Filters::Rest < LogStash::Filters::Base
|
35
|
+
include LogStash::PluginMixins::HttpClient
|
36
|
+
|
37
|
+
config_name 'rest'
|
38
|
+
|
39
|
+
# Configure the rest request send via HttpClient Plugin
|
40
|
+
# with hash objects used by the mixin plugin
|
41
|
+
#
|
42
|
+
# For example, if you want the data to be put in the `doc` field:
|
43
|
+
# [source,ruby]
|
44
|
+
# filter {
|
45
|
+
# rest {
|
46
|
+
# request => {
|
47
|
+
# url => "http://example.com" # string (required, with field reference: "http://example.com?id=%{id}" or params, if defined)
|
48
|
+
# method => "post" # string (optional, default = "get")
|
49
|
+
# headers => { # hash (optional)
|
50
|
+
# "key1" => "value1"
|
51
|
+
# "key2" => "value2"
|
52
|
+
# }
|
53
|
+
# auth => {
|
54
|
+
# user => "AzureDiamond"
|
55
|
+
# password => "hunter2"
|
56
|
+
# }
|
57
|
+
# params => { # hash (optional, available for method => "get" and "post"; if post it will be transformed into body hash and posted as json)
|
58
|
+
# "key1" => "value1"
|
59
|
+
# "key2" => "value2"
|
60
|
+
# "key3" => "%{somefield}" # Field references are found implicitly on startup
|
61
|
+
# }
|
62
|
+
# }
|
63
|
+
# target => "doc"
|
64
|
+
# }
|
65
|
+
# }
|
66
|
+
#
|
67
|
+
# NOTE: for further details, please reference https://github.com/logstash-plugins/logstash-mixin-http_client[logstash-mixin-http_client]
|
68
|
+
config :request, :validate => :hash, :required => true
|
69
|
+
|
70
|
+
# The plugin is written json centric, which defaults to true
|
71
|
+
# the response body will be parsed to json if true
|
72
|
+
#
|
73
|
+
# [source,ruby]
|
74
|
+
# filter {
|
75
|
+
# rest {
|
76
|
+
# json => true
|
77
|
+
# }
|
78
|
+
# }
|
79
|
+
config :json, :validate => :boolean, :default => true
|
80
|
+
|
81
|
+
# If true, references to event fields can be made in
|
82
|
+
# url, params or body by using '%{somefield}'
|
83
|
+
#
|
84
|
+
# [source,ruby]
|
85
|
+
# filter {
|
86
|
+
# rest {
|
87
|
+
# request => { .. }
|
88
|
+
# sprintf => true
|
89
|
+
# }
|
90
|
+
# }
|
91
|
+
config :sprintf, :validate => :boolean, :default => false, :deprecated => true
|
92
|
+
|
93
|
+
# Define the target field for placing the response data. This setting is
|
94
|
+
# required and may not be omitted. It is not possible to place the response
|
95
|
+
# into the event top-level.
|
96
|
+
#
|
97
|
+
# For example, if you want the data to be put in the `doc` field:
|
98
|
+
# [source,ruby]
|
99
|
+
# filter {
|
100
|
+
# rest {
|
101
|
+
# target => "doc"
|
102
|
+
# }
|
103
|
+
# }
|
104
|
+
#
|
105
|
+
# Rest response will be expanded into a data structure in the `target` field.
|
106
|
+
#
|
107
|
+
# NOTE: if the `target` field already exists, it will be overwritten!
|
108
|
+
config :target, :validate => :string, :required => true
|
109
|
+
|
110
|
+
# If set, any error like json parsing or invalid http response
|
111
|
+
# will result in this hash to be added to target instead of error tags
|
112
|
+
#
|
113
|
+
# For example, if you want the fallback data to be put in the `target` field:
|
114
|
+
# [source,ruby]
|
115
|
+
# filter {
|
116
|
+
# rest {
|
117
|
+
# fallback => {
|
118
|
+
# 'key1' => 'value1'
|
119
|
+
# 'key2' => 'value2'
|
120
|
+
# ...
|
121
|
+
# }
|
122
|
+
# }
|
123
|
+
# }
|
124
|
+
config :fallback, :validate => :hash, :default => {}
|
125
|
+
|
126
|
+
# Append values to the `tags` field when there has been no
|
127
|
+
# successful match or json parsing error
|
128
|
+
config :tag_on_rest_failure, :validate => :array, :default => ['_restfailure']
|
129
|
+
config :tag_on_json_failure, :validate => :array, :default => ['_jsonparsefailure']
|
130
|
+
|
131
|
+
public
|
132
|
+
|
133
|
+
def register
|
134
|
+
@request = normalize_request(@request).deep_freeze
|
135
|
+
@sprintf_fields = find_sprintf(
|
136
|
+
LogStash::Util.deep_clone(@request)
|
137
|
+
).deep_freeze
|
138
|
+
@sprintf_needed = !@sprintf_fields.empty?
|
139
|
+
@target = normalize_target(@target).freeze
|
140
|
+
end # def register
|
141
|
+
|
142
|
+
private
|
143
|
+
|
144
|
+
def normalize_target(target)
|
145
|
+
# make sure @target is in the format [field name] if defined,
|
146
|
+
# i.e. not empty and surrounded by brakets
|
147
|
+
raise LogStash::ConfigurationError, 'target config string is empty, please set a valid field name' if target.empty?
|
148
|
+
target = "[#{target}]" if target && target !~ /^\[[^\[\]]+\]$/
|
149
|
+
target
|
150
|
+
end
|
151
|
+
|
152
|
+
private
|
153
|
+
|
154
|
+
def normalize_request(url_or_spec)
|
155
|
+
if url_or_spec.is_a?(String)
|
156
|
+
res = [:get, url_or_spec]
|
157
|
+
elsif url_or_spec.is_a?(Hash)
|
158
|
+
# The client will expect keys / values
|
159
|
+
spec = Hash[url_or_spec.clone.map { |k, v| [k.to_sym, v] }]
|
160
|
+
|
161
|
+
# method and url aren't really part of the options, so we pull them out
|
162
|
+
method = (spec.delete(:method) || :get).to_sym.downcase
|
163
|
+
url = spec.delete(:url)
|
164
|
+
|
165
|
+
# if it is a post and json, it is used as body string, not params
|
166
|
+
spec[:body] = spec.delete(:params) if method == :post && spec[:params]
|
167
|
+
|
168
|
+
# We need these strings to be keywords!
|
169
|
+
spec[:auth] = { user: spec[:auth]['user'], pass: spec[:auth]['password'] } if spec[:auth]
|
170
|
+
|
171
|
+
res = [method.freeze, url, spec]
|
172
|
+
else
|
173
|
+
raise LogStash::ConfigurationError, "Invalid URL or request spec: '#{url_or_spec}', expected a String or Hash!"
|
174
|
+
end
|
175
|
+
|
176
|
+
validate_request!(url_or_spec, res)
|
177
|
+
res
|
178
|
+
end
|
179
|
+
|
180
|
+
private
|
181
|
+
|
182
|
+
def validate_request!(url_or_spec, request)
|
183
|
+
method, url, spec = request
|
184
|
+
|
185
|
+
raise LogStash::ConfigurationError, "No URL provided for request! #{url_or_spec}" unless url
|
186
|
+
raise LogStash::ConfigurationError, "Not supported request method #{method}" unless [ :get, :post ].include?( method )
|
187
|
+
|
188
|
+
if spec && spec[:auth]
|
189
|
+
raise LogStash::ConfigurationError, "Auth was specified, but 'user' was not!" unless spec[:auth][:user]
|
190
|
+
raise LogStash::ConfigurationError, "Auth was specified, but 'password' was not!" unless spec[:auth][:pass]
|
191
|
+
end
|
192
|
+
|
193
|
+
request
|
194
|
+
end
|
195
|
+
|
196
|
+
private
|
197
|
+
|
198
|
+
def find_sprintf(config)
|
199
|
+
field_matcher = /%\{[^}]+\}/
|
200
|
+
if config.is_a?(Hash)
|
201
|
+
config.keep_if do |_k, v|
|
202
|
+
find_sprintf(v)
|
203
|
+
end.compact
|
204
|
+
elsif config.is_a?(Array)
|
205
|
+
config.keep_if do |v|
|
206
|
+
find_sprintf(v)
|
207
|
+
end.compact
|
208
|
+
elsif config.is_a?(String) && config =~ field_matcher
|
209
|
+
config
|
210
|
+
end
|
211
|
+
end
|
212
|
+
|
213
|
+
private
|
214
|
+
|
215
|
+
def request_http(request)
|
216
|
+
if request[2].key?(:body) && @json
|
217
|
+
request[2][:body] = LogStash::Json.dump(request[2][:body])
|
218
|
+
end
|
219
|
+
@logger.debug? && @logger.debug('fetching request',
|
220
|
+
:request => request)
|
221
|
+
|
222
|
+
method, url, *request_opts = request
|
223
|
+
response = client.http(method, url, *request_opts)
|
224
|
+
[response.code, response.body]
|
225
|
+
end
|
226
|
+
|
227
|
+
private
|
228
|
+
|
229
|
+
def process_response(response, event)
|
230
|
+
if @json
|
231
|
+
begin
|
232
|
+
parsed = LogStash::Json.load(response)
|
233
|
+
if parsed.empty?
|
234
|
+
@logger.warn('rest response empty',
|
235
|
+
:response => response, :event => event)
|
236
|
+
@tag_on_rest_failure.each { |tag| event.tag(tag) }
|
237
|
+
else
|
238
|
+
event.set(@target, parsed)
|
239
|
+
end
|
240
|
+
rescue
|
241
|
+
if @fallback.empty?
|
242
|
+
@logger.warn('JSON parsing error',
|
243
|
+
:response => response, :event => event)
|
244
|
+
@tag_on_json_failure.each { |tag| event.tag(tag) }
|
245
|
+
else
|
246
|
+
event.set(@target, @fallback)
|
247
|
+
end
|
248
|
+
end
|
249
|
+
else
|
250
|
+
event.set(@target, response.strip)
|
251
|
+
end
|
252
|
+
end
|
253
|
+
|
254
|
+
private
|
255
|
+
|
256
|
+
def field_intrpl(intrpl_fields, event)
|
257
|
+
case intrpl_fields
|
258
|
+
when String
|
259
|
+
result = event.sprintf(intrpl_fields)
|
260
|
+
when Array
|
261
|
+
result = []
|
262
|
+
intrpl_fields.each do |v|
|
263
|
+
result << field_intrpl(v, event)
|
264
|
+
end
|
265
|
+
when Hash
|
266
|
+
result = {}
|
267
|
+
intrpl_fields.each do |k, v|
|
268
|
+
result[k] = field_intrpl(v, event)
|
269
|
+
end
|
270
|
+
else
|
271
|
+
result = intrpl_fields
|
272
|
+
end
|
273
|
+
result
|
274
|
+
end
|
275
|
+
|
276
|
+
public
|
277
|
+
|
278
|
+
def filter(event)
|
279
|
+
return unless filter?(event)
|
280
|
+
request = LogStash::Util.deep_clone(@request)
|
281
|
+
@logger.debug? && @logger.debug('processing request',
|
282
|
+
:request => request,
|
283
|
+
:sprintf_needed => @sprintf_needed)
|
284
|
+
|
285
|
+
if @sprintf_needed
|
286
|
+
request = field_intrpl(request, event)
|
287
|
+
@logger.debug? && @logger.debug('interpolated request',
|
288
|
+
:request => request)
|
289
|
+
end
|
290
|
+
|
291
|
+
client_error = nil
|
292
|
+
begin
|
293
|
+
code, body = request_http(request)
|
294
|
+
rescue StandardError => e
|
295
|
+
client_error = e
|
296
|
+
end
|
297
|
+
|
298
|
+
if !client_error && code.between?(200, 299)
|
299
|
+
@logger.debug? && @logger.debug('success received',
|
300
|
+
:code => code, :body => body)
|
301
|
+
process_response(body, event)
|
302
|
+
else
|
303
|
+
@logger.debug? && @logger.debug('http error received',
|
304
|
+
:code => code, :body => body,
|
305
|
+
:client_error => client_error)
|
306
|
+
if @fallback.empty?
|
307
|
+
@logger.error('error in rest filter',
|
308
|
+
:request => request, :json => @json,
|
309
|
+
:code => code, :body => body,
|
310
|
+
:client_error => client_error)
|
311
|
+
@tag_on_rest_failure.each { |tag| event.tag(tag) }
|
312
|
+
else
|
313
|
+
@logger.debug? && @logger.debug('setting fallback',
|
314
|
+
:fallback => @fallback)
|
315
|
+
event.set(@target, @fallback)
|
316
|
+
end
|
317
|
+
end
|
318
|
+
filter_matched(event)
|
319
|
+
end # def filter
|
320
|
+
end # class LogStash::Filters::Rest
|
@@ -0,0 +1,33 @@
|
|
1
|
+
Gem::Specification.new do |s|
|
2
|
+
s.name = 'logstash-filter-rest2'
|
3
|
+
s.version = '0.5.3'
|
4
|
+
s.licenses = ['Apache-2.0']
|
5
|
+
s.summary = 'This filter requests data from a RESTful Web Service.'
|
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 logstash-filter-rest2. This gem is not a stand-alone program'
|
7
|
+
s.authors = ['Lucas Henning', 'Gandalf Buscher', 'Boris Gorbylev']
|
8
|
+
s.email = 'ekho@ekho.name'
|
9
|
+
s.homepage = 'https://github.com/ekho/logstash-filter-rest/'
|
10
|
+
s.require_paths = ['lib']
|
11
|
+
|
12
|
+
# Files
|
13
|
+
s.files = Dir['lib/**/*',
|
14
|
+
'spec/**/*',
|
15
|
+
'vendor/**/*',
|
16
|
+
'*.gemspec',
|
17
|
+
'*.md',
|
18
|
+
'CONTRIBUTORS',
|
19
|
+
'Gemfile',
|
20
|
+
'LICENSE',
|
21
|
+
'NOTICE.TXT']
|
22
|
+
# Tests
|
23
|
+
s.test_files = s.files.grep(%r{^(test|spec|features)/})
|
24
|
+
|
25
|
+
# Special flag to let us know this is actually a logstash plugin
|
26
|
+
s.metadata = { 'logstash_plugin' => 'true', 'logstash_group' => 'filter' }
|
27
|
+
|
28
|
+
# Gem dependencies
|
29
|
+
s.add_runtime_dependency 'logstash-core-plugin-api', '>= 1.60', '<= 2.99'
|
30
|
+
s.add_runtime_dependency 'logstash-mixin-http_client', '>= 2.2.4', '< 5.0.0'
|
31
|
+
|
32
|
+
s.add_development_dependency 'logstash-devutils', '>= 0', '< 2.0.0'
|
33
|
+
end
|
@@ -0,0 +1,406 @@
|
|
1
|
+
require 'logstash/devutils/rspec/spec_helper'
|
2
|
+
require 'logstash/filters/rest'
|
3
|
+
|
4
|
+
describe LogStash::Filters::Rest do
|
5
|
+
describe 'Set to Rest Filter Get without params' do
|
6
|
+
let(:config) do <<-CONFIG
|
7
|
+
filter {
|
8
|
+
rest {
|
9
|
+
request => {
|
10
|
+
url => 'http://jsonplaceholder.typicode.com/users/10'
|
11
|
+
}
|
12
|
+
json => true
|
13
|
+
target => 'rest'
|
14
|
+
}
|
15
|
+
}
|
16
|
+
CONFIG
|
17
|
+
end
|
18
|
+
|
19
|
+
sample('message' => 'some text') do
|
20
|
+
expect(subject).to include('rest')
|
21
|
+
expect(subject.get('rest')).to include('id')
|
22
|
+
expect(subject.get('[rest][id]')).to eq(10)
|
23
|
+
expect(subject.get('rest')).to_not include('fallback')
|
24
|
+
end
|
25
|
+
end
|
26
|
+
describe 'Set to Rest Filter Get without params custom target' do
|
27
|
+
let(:config) do <<-CONFIG
|
28
|
+
filter {
|
29
|
+
rest {
|
30
|
+
request => {
|
31
|
+
url => 'http://jsonplaceholder.typicode.com/users/10'
|
32
|
+
}
|
33
|
+
json => true
|
34
|
+
target => 'testing'
|
35
|
+
}
|
36
|
+
}
|
37
|
+
CONFIG
|
38
|
+
end
|
39
|
+
|
40
|
+
sample('message' => 'some text') do
|
41
|
+
expect(subject).to include('testing')
|
42
|
+
expect(subject.get('testing')).to include('id')
|
43
|
+
expect(subject.get('[testing][id]')).to eq(10)
|
44
|
+
expect(subject.get('testing')).to_not include('fallback')
|
45
|
+
end
|
46
|
+
end
|
47
|
+
describe 'Set to Rest Filter Get without params and sprintf' do
|
48
|
+
let(:config) do <<-CONFIG
|
49
|
+
filter {
|
50
|
+
rest {
|
51
|
+
request => {
|
52
|
+
url => "http://jsonplaceholder.typicode.com/users/%{message}"
|
53
|
+
}
|
54
|
+
json => true
|
55
|
+
sprintf => true
|
56
|
+
target => 'rest'
|
57
|
+
}
|
58
|
+
}
|
59
|
+
CONFIG
|
60
|
+
end
|
61
|
+
|
62
|
+
sample('message' => '10') do
|
63
|
+
expect(subject).to include('rest')
|
64
|
+
expect(subject.get('rest')).to include('id')
|
65
|
+
expect(subject.get('[rest][id]')).to eq(10)
|
66
|
+
expect(subject.get('rest')).to_not include('fallback')
|
67
|
+
end
|
68
|
+
sample('message' => '9') do
|
69
|
+
expect(subject).to include('rest')
|
70
|
+
expect(subject.get('rest')).to include('id')
|
71
|
+
expect(subject.get('[rest][id]')).to eq(9)
|
72
|
+
expect(subject.get('rest')).to_not include('fallback')
|
73
|
+
end
|
74
|
+
end
|
75
|
+
describe 'Set to Rest Filter Get without params http error' do
|
76
|
+
let(:config) do <<-CONFIG
|
77
|
+
filter {
|
78
|
+
rest {
|
79
|
+
request => {
|
80
|
+
url => 'http://httpstat.us/404'
|
81
|
+
}
|
82
|
+
json => true
|
83
|
+
target => 'rest'
|
84
|
+
}
|
85
|
+
}
|
86
|
+
CONFIG
|
87
|
+
end
|
88
|
+
|
89
|
+
sample('message' => 'some text') do
|
90
|
+
expect(subject).to_not include('rest')
|
91
|
+
expect(subject.get('tags')).to include('_restfailure')
|
92
|
+
end
|
93
|
+
end
|
94
|
+
describe 'Set to Rest Filter Get with params' do
|
95
|
+
let(:config) do <<-CONFIG
|
96
|
+
filter {
|
97
|
+
rest {
|
98
|
+
request => {
|
99
|
+
url => 'https://jsonplaceholder.typicode.com/posts'
|
100
|
+
params => {
|
101
|
+
userId => 10
|
102
|
+
}
|
103
|
+
headers => {
|
104
|
+
'Content-Type' => 'application/json'
|
105
|
+
}
|
106
|
+
}
|
107
|
+
json => true
|
108
|
+
target => 'rest'
|
109
|
+
}
|
110
|
+
}
|
111
|
+
CONFIG
|
112
|
+
end
|
113
|
+
|
114
|
+
sample('message' => 'some text') do
|
115
|
+
expect(subject).to include('rest')
|
116
|
+
expect(subject.get('[rest][0]')).to include('userId')
|
117
|
+
expect(subject.get('[rest][0][userId]')).to eq(10)
|
118
|
+
expect(subject.get('rest')).to_not include('fallback')
|
119
|
+
end
|
120
|
+
end
|
121
|
+
describe 'empty response' do
|
122
|
+
let(:config) do <<-CONFIG
|
123
|
+
filter {
|
124
|
+
rest {
|
125
|
+
request => {
|
126
|
+
url => 'https://jsonplaceholder.typicode.com/posts'
|
127
|
+
params => {
|
128
|
+
userId => 0
|
129
|
+
}
|
130
|
+
headers => {
|
131
|
+
'Content-Type' => 'application/json'
|
132
|
+
}
|
133
|
+
}
|
134
|
+
target => 'rest'
|
135
|
+
}
|
136
|
+
}
|
137
|
+
CONFIG
|
138
|
+
end
|
139
|
+
|
140
|
+
sample('message' => 'some text') do
|
141
|
+
expect(subject).to_not include('rest')
|
142
|
+
expect(subject.get('tags')).to include('_restfailure')
|
143
|
+
end
|
144
|
+
end
|
145
|
+
describe 'Set to Rest Filter Get with params sprintf' do
|
146
|
+
let(:config) do <<-CONFIG
|
147
|
+
filter {
|
148
|
+
rest {
|
149
|
+
request => {
|
150
|
+
url => 'https://jsonplaceholder.typicode.com/posts'
|
151
|
+
params => {
|
152
|
+
userId => "%{message}"
|
153
|
+
id => "%{message}"
|
154
|
+
}
|
155
|
+
headers => {
|
156
|
+
'Content-Type' => 'application/json'
|
157
|
+
}
|
158
|
+
}
|
159
|
+
json => true
|
160
|
+
target => 'rest'
|
161
|
+
}
|
162
|
+
}
|
163
|
+
CONFIG
|
164
|
+
end
|
165
|
+
|
166
|
+
sample('message' => '1') do
|
167
|
+
expect(subject).to include('rest')
|
168
|
+
expect(subject.get('[rest][0]')).to include('userId')
|
169
|
+
expect(subject.get('[rest][0][userId]')).to eq(1)
|
170
|
+
expect(subject.get('[rest][0][id]')).to eq(1)
|
171
|
+
expect(subject.get('rest').length).to eq(1)
|
172
|
+
expect(subject.get('rest')).to_not include('fallback')
|
173
|
+
end
|
174
|
+
end
|
175
|
+
describe 'Set to Rest Filter Post with params' do
|
176
|
+
let(:config) do <<-CONFIG
|
177
|
+
filter {
|
178
|
+
rest {
|
179
|
+
request => {
|
180
|
+
url => 'https://jsonplaceholder.typicode.com/posts'
|
181
|
+
method => 'post'
|
182
|
+
params => {
|
183
|
+
title => 'foo'
|
184
|
+
body => 'bar'
|
185
|
+
userId => 42
|
186
|
+
}
|
187
|
+
headers => {
|
188
|
+
'Content-Type' => 'application/json'
|
189
|
+
}
|
190
|
+
}
|
191
|
+
json => true
|
192
|
+
target => 'rest'
|
193
|
+
}
|
194
|
+
}
|
195
|
+
CONFIG
|
196
|
+
end
|
197
|
+
|
198
|
+
sample('message' => 'some text') do
|
199
|
+
expect(subject).to include('rest')
|
200
|
+
expect(subject.get('rest')).to include('id')
|
201
|
+
expect(subject.get('[rest][userId]')).to eq(42)
|
202
|
+
expect(subject.get('rest')).to_not include('fallback')
|
203
|
+
end
|
204
|
+
end
|
205
|
+
describe 'Set to Rest Filter Post with params sprintf' do
|
206
|
+
let(:config) do <<-CONFIG
|
207
|
+
filter {
|
208
|
+
rest {
|
209
|
+
request => {
|
210
|
+
url => 'https://jsonplaceholder.typicode.com/posts'
|
211
|
+
method => 'post'
|
212
|
+
params => {
|
213
|
+
title => '%{message}'
|
214
|
+
body => 'bar'
|
215
|
+
userId => "%{message}"
|
216
|
+
}
|
217
|
+
headers => {
|
218
|
+
'Content-Type' => 'application/json'
|
219
|
+
}
|
220
|
+
}
|
221
|
+
json => true
|
222
|
+
target => 'rest'
|
223
|
+
}
|
224
|
+
}
|
225
|
+
CONFIG
|
226
|
+
end
|
227
|
+
|
228
|
+
sample('message' => '42') do
|
229
|
+
expect(subject).to include('rest')
|
230
|
+
expect(subject.get('rest')).to include('id')
|
231
|
+
expect(subject.get('[rest][title]')).to eq(42)
|
232
|
+
expect(subject.get('[rest][userId]')).to eq(42)
|
233
|
+
expect(subject.get('rest')).to_not include('fallback')
|
234
|
+
end
|
235
|
+
sample('message' => ':5e?#!-_') do
|
236
|
+
expect(subject).to include('rest')
|
237
|
+
expect(subject.get('rest')).to include('id')
|
238
|
+
expect(subject.get('[rest][title]')).to eq(':5e?#!-_')
|
239
|
+
expect(subject.get('[rest][userId]')).to eq(':5e?#!-_')
|
240
|
+
expect(subject.get('rest')).to_not include('fallback')
|
241
|
+
end
|
242
|
+
sample('message' => ':4c43=>') do
|
243
|
+
expect(subject).to include('rest')
|
244
|
+
expect(subject.get('rest')).to include('id')
|
245
|
+
expect(subject.get('[rest][title]')).to eq(':4c43=>')
|
246
|
+
expect(subject.get('[rest][userId]')).to eq(':4c43=>')
|
247
|
+
expect(subject.get('rest')).to_not include('fallback')
|
248
|
+
end
|
249
|
+
end
|
250
|
+
describe 'Set to Rest Filter Post with body sprintf' do
|
251
|
+
let(:config) do <<-CONFIG
|
252
|
+
filter {
|
253
|
+
rest {
|
254
|
+
request => {
|
255
|
+
url => 'https://jsonplaceholder.typicode.com/posts'
|
256
|
+
method => 'post'
|
257
|
+
body => {
|
258
|
+
title => 'foo'
|
259
|
+
body => 'bar'
|
260
|
+
userId => "%{message}"
|
261
|
+
}
|
262
|
+
headers => {
|
263
|
+
'Content-Type' => 'application/json'
|
264
|
+
}
|
265
|
+
}
|
266
|
+
json => true
|
267
|
+
target => 'rest'
|
268
|
+
}
|
269
|
+
}
|
270
|
+
CONFIG
|
271
|
+
end
|
272
|
+
|
273
|
+
sample('message' => '42') do
|
274
|
+
expect(subject).to include('rest')
|
275
|
+
expect(subject.get('rest')).to include('id')
|
276
|
+
expect(subject.get('[rest][userId]')).to eq(42)
|
277
|
+
expect(subject.get('rest')).to_not include('fallback')
|
278
|
+
end
|
279
|
+
end
|
280
|
+
describe 'Set to Rest Filter Post with body sprintf nested params' do
|
281
|
+
let(:config) do <<-CONFIG
|
282
|
+
filter {
|
283
|
+
rest {
|
284
|
+
request => {
|
285
|
+
url => 'https://jsonplaceholder.typicode.com/posts'
|
286
|
+
method => 'post'
|
287
|
+
body => {
|
288
|
+
key1 => [
|
289
|
+
{
|
290
|
+
"filterType" => "text"
|
291
|
+
"text" => "salmon"
|
292
|
+
"boolean" => false
|
293
|
+
},
|
294
|
+
{
|
295
|
+
"filterType" => "unique"
|
296
|
+
}
|
297
|
+
]
|
298
|
+
key2 => [
|
299
|
+
{
|
300
|
+
"message" => "123%{message}"
|
301
|
+
"boolean" => true
|
302
|
+
}
|
303
|
+
]
|
304
|
+
key3 => [
|
305
|
+
{
|
306
|
+
"text" => "%{message}123"
|
307
|
+
"filterType" => "text"
|
308
|
+
"number" => 44
|
309
|
+
},
|
310
|
+
{
|
311
|
+
"filterType" => "unique"
|
312
|
+
"null" => nil
|
313
|
+
}
|
314
|
+
]
|
315
|
+
userId => "%{message}"
|
316
|
+
}
|
317
|
+
headers => {
|
318
|
+
'Content-Type' => 'application/json'
|
319
|
+
}
|
320
|
+
}
|
321
|
+
target => 'rest'
|
322
|
+
}
|
323
|
+
}
|
324
|
+
CONFIG
|
325
|
+
end
|
326
|
+
|
327
|
+
sample('message' => '42') do
|
328
|
+
expect(subject).to include('rest')
|
329
|
+
expect(subject.get('rest')).to include('key1')
|
330
|
+
expect(subject.get('[rest][key1][0][boolean]')).to eq('false')
|
331
|
+
expect(subject.get('[rest][key1][1][filterType]')).to eq('unique')
|
332
|
+
expect(subject.get('[rest][key2][0][message]')).to eq('12342')
|
333
|
+
expect(subject.get('[rest][key2][0][boolean]')).to eq('true')
|
334
|
+
expect(subject.get('[rest][key3][0][text]')).to eq('42123')
|
335
|
+
expect(subject.get('[rest][key3][0][filterType]')).to eq('text')
|
336
|
+
expect(subject.get('[rest][key3][0][number]')).to eq(44)
|
337
|
+
expect(subject.get('[rest][key3][1][filterType]')).to eq('unique')
|
338
|
+
expect(subject.get('[rest][key3][1][null]')).to eq('nil')
|
339
|
+
expect(subject.get('[rest][userId]')).to eq(42)
|
340
|
+
expect(subject.get('rest')).to_not include('fallback')
|
341
|
+
end
|
342
|
+
end
|
343
|
+
describe 'fallback' do
|
344
|
+
let(:config) do <<-CONFIG
|
345
|
+
filter {
|
346
|
+
rest {
|
347
|
+
request => {
|
348
|
+
url => 'http://jsonplaceholder.typicode.com/users/0'
|
349
|
+
}
|
350
|
+
json => true
|
351
|
+
fallback => {
|
352
|
+
'fallback1' => true
|
353
|
+
'fallback2' => true
|
354
|
+
}
|
355
|
+
target => 'rest'
|
356
|
+
}
|
357
|
+
}
|
358
|
+
CONFIG
|
359
|
+
end
|
360
|
+
|
361
|
+
sample('message' => 'some text') do
|
362
|
+
expect(subject).to include('rest')
|
363
|
+
expect(subject.get('rest')).to include('fallback1')
|
364
|
+
expect(subject.get('rest')).to include('fallback2')
|
365
|
+
expect(subject.get('rest')).to_not include('id')
|
366
|
+
end
|
367
|
+
end
|
368
|
+
describe 'empty target exception' do
|
369
|
+
let(:config) do <<-CONFIG
|
370
|
+
filter {
|
371
|
+
rest {
|
372
|
+
request => {
|
373
|
+
url => 'http://jsonplaceholder.typicode.com/users/0'
|
374
|
+
}
|
375
|
+
json => true
|
376
|
+
fallback => {
|
377
|
+
'fallback1' => true
|
378
|
+
'fallback2' => true
|
379
|
+
}
|
380
|
+
target => ''
|
381
|
+
}
|
382
|
+
}
|
383
|
+
CONFIG
|
384
|
+
end
|
385
|
+
sample('message' => 'some text') do
|
386
|
+
expect { subject }.to raise_error(LogStash::ConfigurationError)
|
387
|
+
end
|
388
|
+
end
|
389
|
+
describe 'http client throws exception' do
|
390
|
+
let(:config) do <<-CONFIG
|
391
|
+
filter {
|
392
|
+
rest {
|
393
|
+
request => {
|
394
|
+
url => 'invalid_url'
|
395
|
+
}
|
396
|
+
target => 'rest'
|
397
|
+
}
|
398
|
+
}
|
399
|
+
CONFIG
|
400
|
+
end
|
401
|
+
sample('message' => 'some text') do
|
402
|
+
expect(subject).to_not include('rest')
|
403
|
+
expect(subject.get('tags')).to include('_restfailure')
|
404
|
+
end
|
405
|
+
end
|
406
|
+
end
|
metadata
ADDED
@@ -0,0 +1,118 @@
|
|
1
|
+
--- !ruby/object:Gem::Specification
|
2
|
+
name: logstash-filter-rest2
|
3
|
+
version: !ruby/object:Gem::Version
|
4
|
+
version: 0.5.3
|
5
|
+
platform: ruby
|
6
|
+
authors:
|
7
|
+
- Lucas Henning
|
8
|
+
- Gandalf Buscher
|
9
|
+
- Boris Gorbylev
|
10
|
+
autorequire:
|
11
|
+
bindir: bin
|
12
|
+
cert_chain: []
|
13
|
+
date: 2017-07-04 00:00:00.000000000 Z
|
14
|
+
dependencies:
|
15
|
+
- !ruby/object:Gem::Dependency
|
16
|
+
requirement: !ruby/object:Gem::Requirement
|
17
|
+
requirements:
|
18
|
+
- - ">="
|
19
|
+
- !ruby/object:Gem::Version
|
20
|
+
version: '1.60'
|
21
|
+
- - "<="
|
22
|
+
- !ruby/object:Gem::Version
|
23
|
+
version: '2.99'
|
24
|
+
name: logstash-core-plugin-api
|
25
|
+
prerelease: false
|
26
|
+
type: :runtime
|
27
|
+
version_requirements: !ruby/object:Gem::Requirement
|
28
|
+
requirements:
|
29
|
+
- - ">="
|
30
|
+
- !ruby/object:Gem::Version
|
31
|
+
version: '1.60'
|
32
|
+
- - "<="
|
33
|
+
- !ruby/object:Gem::Version
|
34
|
+
version: '2.99'
|
35
|
+
- !ruby/object:Gem::Dependency
|
36
|
+
requirement: !ruby/object:Gem::Requirement
|
37
|
+
requirements:
|
38
|
+
- - ">="
|
39
|
+
- !ruby/object:Gem::Version
|
40
|
+
version: 2.2.4
|
41
|
+
- - "<"
|
42
|
+
- !ruby/object:Gem::Version
|
43
|
+
version: 5.0.0
|
44
|
+
name: logstash-mixin-http_client
|
45
|
+
prerelease: false
|
46
|
+
type: :runtime
|
47
|
+
version_requirements: !ruby/object:Gem::Requirement
|
48
|
+
requirements:
|
49
|
+
- - ">="
|
50
|
+
- !ruby/object:Gem::Version
|
51
|
+
version: 2.2.4
|
52
|
+
- - "<"
|
53
|
+
- !ruby/object:Gem::Version
|
54
|
+
version: 5.0.0
|
55
|
+
- !ruby/object:Gem::Dependency
|
56
|
+
requirement: !ruby/object:Gem::Requirement
|
57
|
+
requirements:
|
58
|
+
- - ">="
|
59
|
+
- !ruby/object:Gem::Version
|
60
|
+
version: '0'
|
61
|
+
- - "<"
|
62
|
+
- !ruby/object:Gem::Version
|
63
|
+
version: 2.0.0
|
64
|
+
name: logstash-devutils
|
65
|
+
prerelease: false
|
66
|
+
type: :development
|
67
|
+
version_requirements: !ruby/object:Gem::Requirement
|
68
|
+
requirements:
|
69
|
+
- - ">="
|
70
|
+
- !ruby/object:Gem::Version
|
71
|
+
version: '0'
|
72
|
+
- - "<"
|
73
|
+
- !ruby/object:Gem::Version
|
74
|
+
version: 2.0.0
|
75
|
+
description: This gem is a logstash plugin required to be installed on top of the
|
76
|
+
Logstash core pipeline using $LS_HOME/bin/logstash-plugin install logstash-filter-rest2.
|
77
|
+
This gem is not a stand-alone program
|
78
|
+
email: ekho@ekho.name
|
79
|
+
executables: []
|
80
|
+
extensions: []
|
81
|
+
extra_rdoc_files: []
|
82
|
+
files:
|
83
|
+
- CHANGELOG.md
|
84
|
+
- CONTRIBUTORS
|
85
|
+
- Gemfile
|
86
|
+
- LICENSE
|
87
|
+
- README.md
|
88
|
+
- lib/logstash/filters/rest.rb
|
89
|
+
- logstash-filter-rest.gemspec
|
90
|
+
- spec/filters/rest_spec.rb
|
91
|
+
homepage: https://github.com/ekho/logstash-filter-rest/
|
92
|
+
licenses:
|
93
|
+
- Apache-2.0
|
94
|
+
metadata:
|
95
|
+
logstash_plugin: 'true'
|
96
|
+
logstash_group: filter
|
97
|
+
post_install_message:
|
98
|
+
rdoc_options: []
|
99
|
+
require_paths:
|
100
|
+
- lib
|
101
|
+
required_ruby_version: !ruby/object:Gem::Requirement
|
102
|
+
requirements:
|
103
|
+
- - ">="
|
104
|
+
- !ruby/object:Gem::Version
|
105
|
+
version: '0'
|
106
|
+
required_rubygems_version: !ruby/object:Gem::Requirement
|
107
|
+
requirements:
|
108
|
+
- - ">="
|
109
|
+
- !ruby/object:Gem::Version
|
110
|
+
version: '0'
|
111
|
+
requirements: []
|
112
|
+
rubyforge_project:
|
113
|
+
rubygems_version: 2.6.11
|
114
|
+
signing_key:
|
115
|
+
specification_version: 4
|
116
|
+
summary: This filter requests data from a RESTful Web Service.
|
117
|
+
test_files:
|
118
|
+
- spec/filters/rest_spec.rb
|