require 'spec_helper' describe Gitlab::PrometheusClient do include PrometheusHelpers subject { described_class.new(RestClient::Resource.new('https://prometheus.example.com')) } describe '#ping' do it 'issues a "query" request to the API endpoint' do req_stub = stub_prometheus_request(prometheus_query_url('1'), body: prometheus_value_body('vector')) expect(subject.ping).to eq({ "resultType" => "vector", "result" => [{ "metric" => {}, "value" => [1488772511.004, "0.000041021495238095323"] }] }) expect(req_stub).to have_been_requested end end # This shared examples expect: # - query_url: A query URL # - execute_query: A query call shared_examples 'failure response' do context 'when request returns 400 with an error message' do it 'raises a Gitlab::PrometheusClient::Error error' do req_stub = stub_prometheus_request(query_url, status: 400, body: { error: 'bar!' }) expect { execute_query } .to raise_error(Gitlab::PrometheusClient::Error, 'bar!') expect(req_stub).to have_been_requested end end context 'when request returns 400 without an error message' do it 'raises a Gitlab::PrometheusClient::Error error' do req_stub = stub_prometheus_request(query_url, status: 400) expect { execute_query } .to raise_error(Gitlab::PrometheusClient::Error, 'Bad data received') expect(req_stub).to have_been_requested end end context 'when request returns 500' do it 'raises a Gitlab::PrometheusClient::Error error' do req_stub = stub_prometheus_request(query_url, status: 500, body: { message: 'FAIL!' }) expect { execute_query } .to raise_error(Gitlab::PrometheusClient::Error, '500 - {"message":"FAIL!"}') expect(req_stub).to have_been_requested end end context 'when request returns non json data' do it 'raises a Gitlab::PrometheusClient::Error error' do req_stub = stub_prometheus_request(query_url, status: 200, body: 'not json') expect { execute_query } .to raise_error(Gitlab::PrometheusClient::Error, 'Parsing response failed') expect(req_stub).to have_been_requested end end end describe 'failure to reach a provided prometheus url' do let(:prometheus_url) {"https://prometheus.invalid.example.com/api/v1/query?query=1"} shared_examples 'exceptions are raised' do it 'raises a Gitlab::PrometheusClient::Error error when a SocketError is rescued' do req_stub = stub_prometheus_request_with_exception(prometheus_url, SocketError) expect { subject } .to raise_error(Gitlab::PrometheusClient::Error, "Can't connect to #{prometheus_url}") expect(req_stub).to have_been_requested end it 'raises a Gitlab::PrometheusClient::Error error when a SSLError is rescued' do req_stub = stub_prometheus_request_with_exception(prometheus_url, OpenSSL::SSL::SSLError) expect { subject } .to raise_error(Gitlab::PrometheusClient::Error, "#{prometheus_url} contains invalid SSL data") expect(req_stub).to have_been_requested end it 'raises a Gitlab::PrometheusClient::Error error when a RestClient::Exception is rescued' do req_stub = stub_prometheus_request_with_exception(prometheus_url, RestClient::Exception) expect { subject } .to raise_error(Gitlab::PrometheusClient::Error, "Network connection error") expect(req_stub).to have_been_requested end end context 'ping' do subject { described_class.new(RestClient::Resource.new(prometheus_url)).ping } it_behaves_like 'exceptions are raised' end context 'proxy' do subject { described_class.new(RestClient::Resource.new(prometheus_url)).proxy('query', { query: '1' }) } it_behaves_like 'exceptions are raised' end end describe '#query' do let(:prometheus_query) { prometheus_cpu_query('env-slug') } let(:query_url) { prometheus_query_with_time_url(prometheus_query, Time.now.utc) } around do |example| Timecop.freeze { example.run } end context 'when request returns vector results' do it 'returns data from the API call' do req_stub = stub_prometheus_request(query_url, body: prometheus_value_body('vector')) expect(subject.query(prometheus_query)).to eq [{ "metric" => {}, "value" => [1488772511.004, "0.000041021495238095323"] }] expect(req_stub).to have_been_requested end end context 'when request returns matrix results' do it 'returns nil' do req_stub = stub_prometheus_request(query_url, body: prometheus_value_body('matrix')) expect(subject.query(prometheus_query)).to be_nil expect(req_stub).to have_been_requested end end context 'when request returns no data' do it 'returns []' do req_stub = stub_prometheus_request(query_url, body: prometheus_empty_body('vector')) expect(subject.query(prometheus_query)).to be_empty expect(req_stub).to have_been_requested end end it_behaves_like 'failure response' do let(:execute_query) { subject.query(prometheus_query) } end end describe '#series' do let(:query_url) { prometheus_series_url('series_name', 'other_service') } around do |example| Timecop.freeze { example.run } end it 'calls endpoint and returns list of series' do req_stub = stub_prometheus_request(query_url, body: prometheus_series('series_name')) expected = prometheus_series('series_name').deep_stringify_keys['data'] expect(subject.series('series_name', 'other_service')).to eq(expected) expect(req_stub).to have_been_requested end end describe '#label_values' do let(:query_url) { prometheus_label_values_url('__name__') } it 'calls endpoint and returns label values' do req_stub = stub_prometheus_request(query_url, body: prometheus_label_values) expected = prometheus_label_values.deep_stringify_keys['data'] expect(subject.label_values('__name__')).to eq(expected) expect(req_stub).to have_been_requested end end describe '#query_range' do let(:prometheus_query) { prometheus_memory_query('env-slug') } let(:query_url) { prometheus_query_range_url(prometheus_query) } around do |example| Timecop.freeze { example.run } end context 'when non utc time is passed' do let(:time_stop) { Time.now.in_time_zone("Warsaw") } let(:time_start) { time_stop - 8.hours } let(:query_url) { prometheus_query_range_url(prometheus_query, start: time_start.utc.to_f, stop: time_stop.utc.to_f) } it 'passed dates are properly converted to utc' do req_stub = stub_prometheus_request(query_url, body: prometheus_values_body('vector')) subject.query_range(prometheus_query, start: time_start, stop: time_stop) expect(req_stub).to have_been_requested end end context 'when a start time is passed' do let(:query_url) { prometheus_query_range_url(prometheus_query, start: 2.hours.ago) } it 'passed it in the requested URL' do req_stub = stub_prometheus_request(query_url, body: prometheus_values_body('vector')) subject.query_range(prometheus_query, start: 2.hours.ago) expect(req_stub).to have_been_requested end end context 'when request returns vector results' do it 'returns nil' do req_stub = stub_prometheus_request(query_url, body: prometheus_values_body('vector')) expect(subject.query_range(prometheus_query)).to be_nil expect(req_stub).to have_been_requested end end context 'when request returns matrix results' do it 'returns data from the API call' do req_stub = stub_prometheus_request(query_url, body: prometheus_values_body('matrix')) expect(subject.query_range(prometheus_query)).to eq([ { "metric" => {}, "values" => [[1488758662.506, "0.00002996364761904785"], [1488758722.506, "0.00003090239047619091"]] } ]) expect(req_stub).to have_been_requested end end context 'when request returns no data' do it 'returns []' do req_stub = stub_prometheus_request(query_url, body: prometheus_empty_body('matrix')) expect(subject.query_range(prometheus_query)).to be_empty expect(req_stub).to have_been_requested end end it_behaves_like 'failure response' do let(:execute_query) { subject.query_range(prometheus_query) } end end describe '.compute_step' do using RSpec::Parameterized::TableSyntax let(:now) { Time.now.utc } subject { described_class.compute_step(start, stop) } where(:time_interval_in_seconds, :step) do 0 | 60 10.hours | 60 10.hours + 1 | 61 # frontend options 30.minutes | 60 3.hours | 60 8.hours | 60 1.day | 144 3.days | 432 1.week | 1008 end with_them do let(:start) { now - time_interval_in_seconds } let(:stop) { now } it { is_expected.to eq(step) } end end describe 'proxy' do context 'get API' do let(:prometheus_query) { prometheus_cpu_query('env-slug') } let(:query_url) { prometheus_query_url(prometheus_query) } around do |example| Timecop.freeze { example.run } end context 'when response status code is 200' do it 'returns response object' do req_stub = stub_prometheus_request(query_url, body: prometheus_value_body('vector')) response = subject.proxy('query', { query: prometheus_query }) json_response = JSON.parse(response.body) expect(response.code).to eq(200) expect(json_response).to eq({ 'status' => 'success', 'data' => { 'resultType' => 'vector', 'result' => [{ "metric" => {}, "value" => [1488772511.004, "0.000041021495238095323"] }] } }) expect(req_stub).to have_been_requested end end context 'when response status code is not 200' do it 'returns response object' do req_stub = stub_prometheus_request(query_url, status: 400, body: { error: 'error' }) response = subject.proxy('query', { query: prometheus_query }) json_response = JSON.parse(response.body) expect(req_stub).to have_been_requested expect(response.code).to eq(400) expect(json_response).to eq('error' => 'error') end end context 'when RestClient::Exception is raised' do before do stub_prometheus_request_with_exception(query_url, RestClient::Exception) end it 'raises PrometheusClient::Error' do expect { subject.proxy('query', { query: prometheus_query }) }.to( raise_error(Gitlab::PrometheusClient::Error, 'Network connection error') ) end end end end end