summaryrefslogtreecommitdiff
path: root/spec/lib/grafana/validator_spec.rb
blob: 603e27fd0c0ea3010d8a3d6f1189d3f1c4217831 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
# frozen_string_literal: true

require 'spec_helper'

describe Grafana::Validator do
  let(:grafana_dashboard) { JSON.parse(fixture_file('grafana/simplified_dashboard_response.json'), symbolize_names: true) }
  let(:datasource) { JSON.parse(fixture_file('grafana/datasource_response.json'), symbolize_names: true) }
  let(:panel) { grafana_dashboard[:dashboard][:panels].first }

  let(:query_params) do
    {
      from: '1570397739557',
      to: '1570484139557',
      panelId: '8',
      'var-instance': 'localhost:9121'
    }
  end

  describe 'validate!' do
    shared_examples_for 'processing error' do |message|
      it 'raises a processing error' do
        expect { subject }
          .to raise_error(::Grafana::Validator::Error, message)
      end
    end

    subject { described_class.new(grafana_dashboard, datasource, panel, query_params).validate! }

    it 'does not raise an error' do
      expect { subject }.not_to raise_error
    end

    context 'when query param "from" is not specified' do
      before do
        query_params.delete(:from)
      end

      it_behaves_like 'processing error', 'Grafana query parameters must include from and to.'
    end

    context 'when query param "to" is not specified' do
      before do
        query_params.delete(:to)
      end

      it_behaves_like 'processing error', 'Grafana query parameters must include from and to.'
    end

    context 'when the panel is not provided' do
      let(:panel) { nil }

      it_behaves_like 'processing error', 'Panel type must be a line graph.'
    end

    context 'when the panel is not a graph' do
      before do
        panel[:type] = 'singlestat'
      end

      it_behaves_like 'processing error', 'Panel type must be a line graph.'
    end

    context 'when the panel is not a line graph' do
      before do
        panel[:lines] = false
      end

      it_behaves_like 'processing error', 'Panel type must be a line graph.'
    end

    context 'when the query dashboard includes undefined variables' do
      before do
        query_params.delete(:'var-instance')
      end

      it_behaves_like 'processing error', 'All Grafana variables must be defined in the query parameters.'
    end

    context 'when the expression contains unsupported global variables' do
      before do
        grafana_dashboard[:dashboard][:panels][0][:targets][0][:expr] = 'sum(important_metric[$__interval_ms])'
      end

      it_behaves_like 'processing error', "Prometheus must not include #{described_class::UNSUPPORTED_GRAFANA_GLOBAL_VARS}"
    end

    context 'when the datasource is not proxyable' do
      before do
        datasource[:access] = 'not-proxy'
      end

      it_behaves_like 'processing error', 'Only Prometheus datasources with proxy access in Grafana are supported.'
    end

    # Skipping datasource validation allows for checks to be
    # run without a secondary call to Grafana API
    context 'when the datasource is not provided' do
      let(:datasource) { nil }

      it 'does not raise an error' do
        expect { subject }.not_to raise_error
      end
    end
  end

  describe 'valid?' do
    subject { described_class.new(grafana_dashboard, datasource, panel, query_params).valid? }

    context 'with valid arguments' do
      it { is_expected.to be true }
    end

    context 'with invalid arguments' do
      let(:query_params) { {} }

      it { is_expected.to be false }
    end
  end
end