@@ -12,11 +12,12 @@ module Agents |
||
12 | 12 |
|
13 | 13 |
form_configurable :url |
14 | 14 |
form_configurable :disable_redirect_follow, type: :array, values: ['true', 'false'] |
15 |
+ form_configurable :headers_to_save |
|
15 | 16 |
|
16 | 17 |
description <<-MD |
17 |
- The HttpStatusAgent will check a url and emit the resulting HTTP status code with the time that it waited for a reply. |
|
18 |
+ The HttpStatusAgent will check a url and emit the resulting HTTP status code with the time that it waited for a reply. Additionally, it will optionally emit the value of one or more specified headers. |
|
18 | 19 |
|
19 |
- Specify a `Url` and the Http Status Agent will produce an event with the http status code. |
|
20 |
+ Specify a `Url` and the Http Status Agent will produce an event with the HTTP status code. If you specify one or more `Headers to save` (comma-delimited) as well, that header or headers' value(s) will be included in the event. |
|
20 | 21 |
|
21 | 22 |
The `disable redirect follow` option causes the Agent to not follow HTTP redirects. For example, setting this to `true` will cause an agent that receives a 301 redirect to `http://yahoo.com` to return a status of 301 instead of following the redirect and returning 200. |
22 | 23 |
MD |
@@ -26,8 +27,11 @@ module Agents |
||
26 | 27 |
|
27 | 28 |
{ |
28 | 29 |
"url": "...", |
29 |
- "status": "..." |
|
30 |
- "elapsed_time": "..." |
|
30 |
+ "status": "...", |
|
31 |
+ "elapsed_time": "...", |
|
32 |
+ "headers": { |
|
33 |
+ "...": "..." |
|
34 |
+ } |
|
31 | 35 |
} |
32 | 36 |
MD |
33 | 37 |
|
@@ -46,29 +50,47 @@ module Agents |
||
46 | 50 |
errors.add(:base, "a url must be specified") unless options['url'].present? |
47 | 51 |
end |
48 | 52 |
|
53 |
+ def header_array(str) |
|
54 |
+ (str || '').split(',').map(&:strip) |
|
55 |
+ end |
|
56 |
+ |
|
49 | 57 |
def check |
50 |
- check_this_url interpolated[:url] |
|
58 |
+ check_this_url interpolated[:url], header_array(interpolated[:headers_to_save]) |
|
51 | 59 |
end |
52 | 60 |
|
53 | 61 |
def receive(incoming_events) |
54 | 62 |
incoming_events.each do |event| |
55 | 63 |
interpolate_with(event) do |
56 |
- check_this_url interpolated[:url] |
|
64 |
+ check_this_url interpolated[:url], header_array(interpolated[:headers_to_save]) |
|
57 | 65 |
end |
58 | 66 |
end |
59 | 67 |
end |
60 | 68 |
|
61 | 69 |
private |
62 | 70 |
|
63 |
- def check_this_url(url) |
|
71 |
+ def check_this_url(url, local_headers) |
|
72 |
+ # Track time |
|
64 | 73 |
measured_result = TimeTracker.track { ping(url) } |
74 |
+ |
|
75 |
+ payload = { 'url' => url, 'response_received' => false, 'elapsed_time' => measured_result.elapsed_time } |
|
76 |
+ |
|
77 |
+ # Deal with failures |
|
65 | 78 |
if measured_result.result |
66 |
- create_event payload: { 'url' => url, 'status' => measured_result.status.to_s, 'response_received' => true, 'elapsed_time' => measured_result.elapsed_time } |
|
79 |
+ payload.merge!({ 'response_received' => true, 'status' => measured_result.status.to_s }) |
|
80 |
+ # Deal with headers |
|
81 |
+ if local_headers.present? |
|
82 |
+ header_results = measured_result.result.headers.select {|header, value| local_headers.include?(header)} |
|
83 |
+ # Fill in headers that we wanted, but weren't returned |
|
84 |
+ local_headers.each { |header| header_results[header] = nil unless header_results.has_key?(header) } |
|
85 |
+ payload.merge!({ 'headers' => header_results }) |
|
86 |
+ end |
|
87 |
+ create_event payload: payload |
|
67 | 88 |
memory['last_status'] = measured_result.status.to_s |
68 | 89 |
else |
69 |
- create_event payload: { 'url' => url, 'response_received' => false, 'elapsed_time' => measured_result.elapsed_time } |
|
90 |
+ create_event payload: payload |
|
70 | 91 |
memory['last_status'] = nil |
71 | 92 |
end |
93 |
+ |
|
72 | 94 |
end |
73 | 95 |
|
74 | 96 |
def ping(url) |
@@ -7,6 +7,7 @@ describe 'HttpStatusAgent' do |
||
7 | 7 |
a.service = services(:generic) |
8 | 8 |
a.user = users(:jane) |
9 | 9 |
a.options['url'] = 'http://google.com' |
10 |
+ a.options['headers_to_save'] = 'Server' |
|
10 | 11 |
a.save! |
11 | 12 |
|
12 | 13 |
def a.interpolate_with(e, &block) |
@@ -76,11 +77,12 @@ describe 'HttpStatusAgent' do |
||
76 | 77 |
before do |
77 | 78 |
|
78 | 79 |
def agent.interpolated |
79 |
- @interpolated ||= { :url => SecureRandom.uuid } |
|
80 |
+ @interpolated ||= { :url => SecureRandom.uuid, :headers_to_save => '' } |
|
80 | 81 |
end |
81 | 82 |
|
82 |
- def agent.check_this_url url |
|
83 |
+ def agent.check_this_url url, local_headers |
|
83 | 84 |
@url = url |
85 |
+ @local_headers = local_headers |
|
84 | 86 |
end |
85 | 87 |
|
86 | 88 |
def agent.checked_url |
@@ -103,10 +105,12 @@ describe 'HttpStatusAgent' do |
||
103 | 105 |
let(:successful_url) { SecureRandom.uuid } |
104 | 106 |
|
105 | 107 |
let(:status_code) { 200 } |
108 |
+ let(:header) { SecureRandom.uuid } |
|
109 |
+ let(:header_value) { SecureRandom.uuid } |
|
106 | 110 |
|
107 | 111 |
let(:event_with_a_successful_ping) do |
108 |
- agent.faraday.set(successful_url, Struct.new(:status).new(status_code)) |
|
109 |
- Event.new.tap { |e| e.payload = { url: successful_url } } |
|
112 |
+ agent.faraday.set(successful_url, Struct.new(:status, :headers).new(status_code, {})) |
|
113 |
+ Event.new.tap { |e| e.payload = { url: successful_url, headers_to_save: "" } } |
|
110 | 114 |
end |
111 | 115 |
|
112 | 116 |
let(:events) do |
@@ -138,6 +142,11 @@ describe 'HttpStatusAgent' do |
||
138 | 142 |
expect(agent.the_created_events[0][:payload]['elapsed_time']).not_to be_nil |
139 | 143 |
end |
140 | 144 |
|
145 |
+ it "should not return a header" do |
|
146 |
+ agent.receive events |
|
147 |
+ expect(agent.the_created_events[0][:payload]['headers']).to be_nil |
|
148 |
+ end |
|
149 |
+ |
|
141 | 150 |
describe "but the status code is not 200" do |
142 | 151 |
let(:status_code) { 500 } |
143 | 152 |
|
@@ -160,8 +169,8 @@ describe 'HttpStatusAgent' do |
||
160 | 169 |
describe "but the ping returns a status code of 0" do |
161 | 170 |
|
162 | 171 |
let(:event_with_a_successful_ping) do |
163 |
- agent.faraday.set(successful_url, Struct.new(:status).new(0)) |
|
164 |
- Event.new.tap { |e| e.payload = { url: successful_url } } |
|
172 |
+ agent.faraday.set(successful_url, Struct.new(:status, :headers).new(0, {})) |
|
173 |
+ Event.new.tap { |e| e.payload = { url: successful_url, headers_to_save: "" } } |
|
165 | 174 |
end |
166 | 175 |
|
167 | 176 |
it "should create one event" do |
@@ -190,8 +199,8 @@ describe 'HttpStatusAgent' do |
||
190 | 199 |
describe "but the ping returns a status code of -1" do |
191 | 200 |
|
192 | 201 |
let(:event_with_a_successful_ping) do |
193 |
- agent.faraday.set(successful_url, Struct.new(:status).new(-1)) |
|
194 |
- Event.new.tap { |e| e.payload = { url: successful_url } } |
|
202 |
+ agent.faraday.set(successful_url, Struct.new(:status, :headers).new(-1, {})) |
|
203 |
+ Event.new.tap { |e| e.payload = { url: successful_url, headers_to_save: "" } } |
|
195 | 204 |
end |
196 | 205 |
|
197 | 206 |
it "should create one event" do |
@@ -214,7 +223,7 @@ describe 'HttpStatusAgent' do |
||
214 | 223 |
describe "and with one event with a failing ping" do |
215 | 224 |
|
216 | 225 |
let(:failing_url) { SecureRandom.uuid } |
217 |
- let(:event_with_a_failing_ping) { Event.new.tap { |e| e.payload = { url: failing_url } } } |
|
226 |
+ let(:event_with_a_failing_ping) { Event.new.tap { |e| e.payload = { url: failing_url, headers_to_save: "" } } } |
|
218 | 227 |
|
219 | 228 |
let(:events) do |
220 | 229 |
[event_with_a_successful_ping, event_with_a_failing_ping] |
@@ -249,6 +258,39 @@ describe 'HttpStatusAgent' do |
||
249 | 258 |
|
250 | 259 |
end |
251 | 260 |
|
261 |
+ describe "with a header specified" do |
|
262 |
+ let(:event_with_a_successful_ping) do |
|
263 |
+ agent.faraday.set(successful_url, Struct.new(:status, :headers).new(status_code, {header => header_value})) |
|
264 |
+ Event.new.tap { |e| e.payload = { url: successful_url, headers_to_save: header } } |
|
265 |
+ end |
|
266 |
+ |
|
267 |
+ it "should return the header value" do |
|
268 |
+ agent.receive events |
|
269 |
+ expect(agent.the_created_events[0][:payload]['headers']).not_to be_nil |
|
270 |
+ expect(agent.the_created_events[0][:payload]['headers'][header]).to eq(header_value) |
|
271 |
+ end |
|
272 |
+ |
|
273 |
+ end |
|
274 |
+ |
|
275 |
+ describe "with existing and non-existing headers specified" do |
|
276 |
+ let(:nonexistant_header) { SecureRandom.uuid } |
|
277 |
+ |
|
278 |
+ let(:event_with_a_successful_ping) do |
|
279 |
+ agent.faraday.set(successful_url, Struct.new(:status, :headers).new(status_code, {header => header_value})) |
|
280 |
+ Event.new.tap { |e| e.payload = { url: successful_url, headers_to_save: header + "," + nonexistant_header } } |
|
281 |
+ end |
|
282 |
+ |
|
283 |
+ it "should return the existing header's value" do |
|
284 |
+ agent.receive events |
|
285 |
+ expect(agent.the_created_events[0][:payload]['headers'][header]).to eq(header_value) |
|
286 |
+ end |
|
287 |
+ |
|
288 |
+ it "should return nil for the nonexistant header" do |
|
289 |
+ agent.receive events |
|
290 |
+ expect(agent.the_created_events[0][:payload]['headers'][nonexistant_header]).to be_nil |
|
291 |
+ end |
|
292 |
+ |
|
293 |
+ end |
|
252 | 294 |
end |
253 | 295 |
|
254 | 296 |
describe "validations" do |