ruby-grafana-reporter 0.2.0 → 0.4.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.
Files changed (80) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +105 -86
  3. data/bin/ruby-grafana-reporter +5 -5
  4. data/lib/VERSION.rb +3 -2
  5. data/lib/grafana/abstract_datasource.rb +136 -0
  6. data/lib/grafana/dashboard.rb +21 -23
  7. data/lib/grafana/errors.rb +8 -1
  8. data/lib/grafana/grafana.rb +61 -65
  9. data/lib/grafana/grafana_alerts_datasource.rb +57 -0
  10. data/lib/grafana/grafana_annotations_datasource.rb +56 -0
  11. data/lib/grafana/grafana_property_datasource.rb +25 -0
  12. data/lib/grafana/graphite_datasource.rb +50 -0
  13. data/lib/grafana/image_rendering_datasource.rb +44 -0
  14. data/lib/grafana/panel.rb +9 -3
  15. data/lib/grafana/prometheus_datasource.rb +45 -0
  16. data/lib/grafana/sql_datasource.rb +71 -0
  17. data/lib/grafana/unsupported_datasource.rb +7 -0
  18. data/lib/grafana/variable.rb +3 -2
  19. data/lib/grafana/webrequest.rb +71 -0
  20. data/lib/grafana_reporter/abstract_query.rb +359 -0
  21. data/lib/grafana_reporter/abstract_report.rb +119 -17
  22. data/lib/grafana_reporter/alerts_table_query.rb +44 -0
  23. data/lib/grafana_reporter/annotations_table_query.rb +43 -0
  24. data/lib/grafana_reporter/application/application.rb +49 -297
  25. data/lib/grafana_reporter/application/webservice.rb +49 -14
  26. data/lib/grafana_reporter/asciidoctor/alerts_table_include_processor.rb +90 -0
  27. data/lib/grafana_reporter/asciidoctor/annotations_table_include_processor.rb +89 -0
  28. data/lib/grafana_reporter/asciidoctor/panel_image_block_macro.rb +77 -0
  29. data/lib/grafana_reporter/asciidoctor/panel_image_inline_macro.rb +79 -0
  30. data/lib/grafana_reporter/asciidoctor/panel_property_inline_macro.rb +73 -0
  31. data/lib/grafana_reporter/asciidoctor/panel_query_table_include_processor.rb +99 -0
  32. data/lib/grafana_reporter/asciidoctor/panel_query_value_inline_macro.rb +93 -0
  33. data/lib/grafana_reporter/asciidoctor/processor_mixin.rb +64 -0
  34. data/lib/grafana_reporter/asciidoctor/report.rb +47 -76
  35. data/lib/grafana_reporter/asciidoctor/show_environment_include_processor.rb +46 -0
  36. data/lib/grafana_reporter/asciidoctor/show_help_include_processor.rb +35 -0
  37. data/lib/grafana_reporter/asciidoctor/sql_table_include_processor.rb +92 -0
  38. data/lib/grafana_reporter/asciidoctor/sql_value_inline_macro.rb +88 -0
  39. data/lib/grafana_reporter/asciidoctor/value_as_variable_include_processor.rb +90 -0
  40. data/lib/grafana_reporter/configuration.rb +108 -43
  41. data/lib/grafana_reporter/console_configuration_wizard.rb +311 -0
  42. data/lib/grafana_reporter/demo_report_wizard.rb +101 -0
  43. data/lib/grafana_reporter/erb/report.rb +43 -0
  44. data/lib/grafana_reporter/errors.rb +41 -0
  45. data/lib/grafana_reporter/help.rb +443 -0
  46. data/lib/grafana_reporter/logger/{two_way_logger.rb → two_way_delegate_logger.rb} +1 -1
  47. data/lib/grafana_reporter/panel_image_query.rb +29 -0
  48. data/lib/grafana_reporter/panel_property_query.rb +22 -0
  49. data/lib/grafana_reporter/query_value_query.rb +79 -0
  50. data/lib/grafana_reporter/report_webhook.rb +35 -0
  51. data/lib/ruby_grafana_extension.rb +8 -0
  52. data/lib/{ruby-grafana-reporter.rb → ruby_grafana_reporter.rb} +13 -0
  53. metadata +47 -43
  54. data/lib/grafana/abstract_panel_query.rb +0 -22
  55. data/lib/grafana/abstract_query.rb +0 -132
  56. data/lib/grafana/abstract_sql_query.rb +0 -51
  57. data/lib/grafana/panel_image_query.rb +0 -52
  58. data/lib/grafana_reporter/asciidoctor/alerts_table_query.rb +0 -104
  59. data/lib/grafana_reporter/asciidoctor/annotations_table_query.rb +0 -99
  60. data/lib/grafana_reporter/asciidoctor/errors.rb +0 -40
  61. data/lib/grafana_reporter/asciidoctor/extensions/alerts_table_include_processor.rb +0 -92
  62. data/lib/grafana_reporter/asciidoctor/extensions/annotations_table_include_processor.rb +0 -91
  63. data/lib/grafana_reporter/asciidoctor/extensions/panel_image_block_macro.rb +0 -69
  64. data/lib/grafana_reporter/asciidoctor/extensions/panel_image_inline_macro.rb +0 -68
  65. data/lib/grafana_reporter/asciidoctor/extensions/panel_property_inline_macro.rb +0 -61
  66. data/lib/grafana_reporter/asciidoctor/extensions/panel_query_table_include_processor.rb +0 -78
  67. data/lib/grafana_reporter/asciidoctor/extensions/panel_query_value_inline_macro.rb +0 -73
  68. data/lib/grafana_reporter/asciidoctor/extensions/processor_mixin.rb +0 -20
  69. data/lib/grafana_reporter/asciidoctor/extensions/show_environment_include_processor.rb +0 -43
  70. data/lib/grafana_reporter/asciidoctor/extensions/show_help_include_processor.rb +0 -202
  71. data/lib/grafana_reporter/asciidoctor/extensions/sql_table_include_processor.rb +0 -70
  72. data/lib/grafana_reporter/asciidoctor/extensions/sql_value_inline_macro.rb +0 -66
  73. data/lib/grafana_reporter/asciidoctor/extensions/value_as_variable_include_processor.rb +0 -61
  74. data/lib/grafana_reporter/asciidoctor/panel_first_value_query.rb +0 -34
  75. data/lib/grafana_reporter/asciidoctor/panel_image_query.rb +0 -25
  76. data/lib/grafana_reporter/asciidoctor/panel_property_query.rb +0 -44
  77. data/lib/grafana_reporter/asciidoctor/panel_table_query.rb +0 -38
  78. data/lib/grafana_reporter/asciidoctor/query_mixin.rb +0 -310
  79. data/lib/grafana_reporter/asciidoctor/sql_first_value_query.rb +0 -37
  80. data/lib/grafana_reporter/asciidoctor/sql_table_query.rb +0 -39
@@ -1,70 +0,0 @@
1
- # frozen_string_literal: true
2
-
3
- module GrafanaReporter
4
- module Asciidoctor
5
- module Extensions
6
- # Implements the hook
7
- # include::grafana_sql_table:<datasource_id>[<options>]
8
- #
9
- # Returns the results of the SQL query as a asciidoctor table.
10
- #
11
- # == Used document parameters
12
- # +grafana_default_instance+ - name of grafana instance, 'default' if not specified
13
- #
14
- # +from+ - 'from' time for the sql query
15
- #
16
- # +to+ - 'to' time for the sql query
17
- #
18
- # All other variables starting with +var-+ will be used to replace grafana templating strings
19
- # in the given SQL query.
20
- #
21
- # == Supported options
22
- # +sql+ - sql statement (*mandatory*)
23
- #
24
- # +instance+ - name of grafana instance, 'default' if not specified
25
- #
26
- # +from+ - 'from' time for the sql query
27
- #
28
- # +to+ - 'to' time for the sql query
29
- #
30
- # +format+ - see {QueryMixin#format_columns}
31
- #
32
- # +replace_values+ - see {QueryMixin#replace_values}
33
- #
34
- # +filter_columns+ - see {QueryMixin#filter_columns}
35
- class SqlTableIncludeProcessor < ::Asciidoctor::Extensions::IncludeProcessor
36
- include ProcessorMixin
37
-
38
- # :nodoc:
39
- def handles?(target)
40
- target.start_with? 'grafana_sql_table:'
41
- end
42
-
43
- # :nodoc:
44
- def process(doc, reader, target, attrs)
45
- return if @report.cancel
46
-
47
- @report.next_step
48
- instance = attrs['instance'] || doc.attr('grafana_default_instance') || 'default'
49
- @report.logger.debug("Processing SqlTableIncludeProcessor (instance: #{instance},"\
50
- " datasource: #{target.split(':')[1]}, sql: #{attrs['sql']})")
51
- query = SqlTableQuery.new(attrs['sql'], target.split(':')[1])
52
- query.merge_hash_variables(doc.attributes, attrs)
53
- @report.logger.debug("from: #{query.from}, to: #{query.to}")
54
-
55
- begin
56
- reader.unshift_lines query.execute(@report.grafana(instance))
57
- rescue GrafanaReporterError => e
58
- @report.logger.error(e.message)
59
- reader.unshift_line "|#{e.message}"
60
- rescue StandardError => e
61
- @report.logger.fatal(e.message)
62
- reader.unshift_line "|#{e.message}"
63
- end
64
-
65
- reader
66
- end
67
- end
68
- end
69
- end
70
- end
@@ -1,66 +0,0 @@
1
- # frozen_string_literal: true
2
-
3
- module GrafanaReporter
4
- module Asciidoctor
5
- module Extensions
6
- # Implements the hook
7
- # grafana_sql_value:<datasource_id>[<options>]
8
- #
9
- # Returns the first value of the resulting SQL query.
10
- #
11
- # == Used document parameters
12
- # +grafana_default_instance+ - name of grafana instance, 'default' if not specified
13
- #
14
- # +from+ - 'from' time for the sql query
15
- #
16
- # +to+ - 'to' time for the sql query
17
- #
18
- # All other variables starting with +var-+ will be used to replace grafana templating strings
19
- # in the given SQL query.
20
- #
21
- # == Supported options
22
- # +sql+ - sql statement (*mandatory*)
23
- #
24
- # +instance+ - name of grafana instance, 'default' if not specified
25
- #
26
- # +from+ - 'from' time for the sql query
27
- #
28
- # +to+ - 'to' time for the sql query
29
- #
30
- # +format+ - see {QueryMixin#format_columns}
31
- #
32
- # +replace_values+ - see {QueryMixin#replace_values}
33
- #
34
- # +filter_columns+ - see {QueryMixin#filter_columns}
35
- class SqlValueInlineMacro < ::Asciidoctor::Extensions::InlineMacroProcessor
36
- include ProcessorMixin
37
- use_dsl
38
-
39
- named :grafana_sql_value
40
-
41
- # @see GrafanaReporter::Asciidoctor::SqlFirstValueQuery
42
- def process(parent, target, attrs)
43
- return if @report.cancel
44
-
45
- @report.next_step
46
- instance = attrs['instance'] || parent.document.attr('grafana_default_instance') || 'default'
47
- @report.logger.debug("Processing SqlValueInlineMacro (instance: #{instance}, datasource: #{target},"\
48
- " sql: #{attrs['sql']})")
49
- query = SqlFirstValueQuery.new(attrs['sql'], target)
50
- query.merge_hash_variables(parent.document.attributes, attrs)
51
- @report.logger.debug("from: #{query.from}, to: #{query.to}")
52
-
53
- begin
54
- create_inline(parent, :quoted, query.execute(@report.grafana(instance)))
55
- rescue GrafanaReporterError => e
56
- @report.logger.error(e.message)
57
- create_inline(parent, :quoted, e.message)
58
- rescue StandardError => e
59
- @report.logger.fatal(e.message)
60
- create_inline(parent, :quoted, e.message)
61
- end
62
- end
63
- end
64
- end
65
- end
66
- end
@@ -1,61 +0,0 @@
1
- # frozen_string_literal: true
2
-
3
- require_relative 'processor_mixin'
4
-
5
- module GrafanaReporter
6
- module Asciidoctor
7
- module Extensions
8
- # TODO: add documentation
9
- class ValueAsVariableIncludeProcessor < ::Asciidoctor::Extensions::IncludeProcessor
10
- include ProcessorMixin
11
-
12
- # :nodoc:
13
- def handles?(target)
14
- target.start_with? 'grafana_value_as_variable'
15
- end
16
-
17
- # :nodoc:
18
- def process(doc, reader, target, attrs)
19
- return if @report.cancel
20
-
21
- # do NOT increase step, as this is done by sub processor
22
- # @report.next_step
23
-
24
- call_attr = attrs.delete('call')
25
- call, target = call_attr.split(':') if call_attr
26
- attribute = attrs.delete('variable_name')
27
- @report.logger.debug("Processing ValueAsVariableIncludeProcessor (call: #{call}, target: #{target},"\
28
- " variable_name: #{attribute}, attrs: #{attrs})")
29
- if !call || !attribute
30
- @report.logger.error("Missing mandatory attribute 'call' or 'variable_name'.")
31
- return reader
32
- end
33
-
34
- # TODO: remove dirty hack to allow the document as parameter for other processors
35
- def doc.document
36
- self
37
- end
38
-
39
- # TODO: properly show error messages also in document
40
- ext = doc.extensions.find_inline_macro_extension(call) if doc.extensions.inline_macros?
41
- if !ext
42
- @report.logger.error("Could not find inline macro extension for '#{call}'.")
43
- else
44
- @report.logger.debug('ValueAsVariableIncludeProcessor: Calling sub-method.')
45
- item = ext.process_method.call(doc, target, attrs)
46
- if !item.text.to_s.empty?
47
- result = ":#{attribute}: #{item.text}"
48
- @report.logger.debug("ValueAsVariableIncludeProcessor: Adding '#{result}' to document.")
49
- reader.unshift_line(result)
50
- else
51
- @report.logger.debug("ValueAsVariableIncludeProcessor: Not adding variable '#{attribute}',"\
52
- ' as query result was empty.')
53
- end
54
- end
55
-
56
- reader
57
- end
58
- end
59
- end
60
- end
61
- end
@@ -1,34 +0,0 @@
1
- # frozen_string_literal: true
2
-
3
- require_relative 'sql_first_value_query'
4
-
5
- module GrafanaReporter
6
- module Asciidoctor
7
- # (see SqlFirstValueQuery)
8
- #
9
- # The SQL query as well as the datasource configuration are thereby captured from a
10
- # {Grafana::Panel}.
11
- class PanelFirstValueQuery < SqlFirstValueQuery
12
- include QueryMixin
13
-
14
- # (see PanelTableQuery#initialize)
15
- def initialize(panel, query_letter)
16
- super(nil, nil)
17
- @panel = panel
18
- @query_letter = query_letter
19
- extract_dashboard_variables(@panel.dashboard)
20
- end
21
-
22
- # (see PanelTableQuery#pre_process)
23
- def pre_process(grafana)
24
- @sql = @panel.query(@query_letter)
25
- # resolve datasource name
26
- @datasource = @panel.field('datasource')
27
- @datasource_id = grafana.datasource_id(@datasource)
28
- super(grafana)
29
- @from = translate_date(@from, @variables['grafana-report-timestamp'], false)
30
- @to = translate_date(@to, @variables['grafana-report-timestamp'], true)
31
- end
32
- end
33
- end
34
- end
@@ -1,25 +0,0 @@
1
- # frozen_string_literal: true
2
-
3
- module GrafanaReporter
4
- module Asciidoctor
5
- # This class is used to create an image out of a {Grafana::Panel}.
6
- class PanelImageQuery < Grafana::PanelImageQuery
7
- include QueryMixin
8
-
9
- # Sets the proper render variables.
10
- def pre_process(grafana)
11
- super
12
- @from = translate_date(@from, @variables['grafana-report-timestamp'], false)
13
- @to = translate_date(@to, @variables['grafana-report-timestamp'], true)
14
- # rename "render-" variables
15
- @variables.transform_keys! { |k| k.gsub(/^render-/, '') }
16
- end
17
-
18
- # Returns the body of the http query, which contains the raw image.
19
- def post_process
20
- super
21
- @result = @result.body
22
- end
23
- end
24
- end
25
- end
@@ -1,44 +0,0 @@
1
- # frozen_string_literal: true
2
-
3
- module GrafanaReporter
4
- module Asciidoctor
5
- # This class is used to query properties from a {Grafana::Panel}, such as +description+,
6
- # +title+ etc.
7
- class PanelPropertyQuery < ::Grafana::AbstractPanelQuery
8
- include QueryMixin
9
-
10
- # @param panel [Grafana::Panel] panel object, for which the property shall be retrieved
11
- # @param property [String] queried property, e.g. +title+
12
- def initialize(panel, property)
13
- super(panel)
14
- @property = property
15
- end
16
-
17
- # Overrides the default method, as the query does not have to run against a SQL table,
18
- # but rather against the panel model.
19
- # @param grafana [Grafana::Grafana] grafana instance against which the panel property is queried
20
- # @return [String] fetched property
21
- def execute(grafana)
22
- return @result unless @result.nil?
23
-
24
- pre_process(grafana)
25
- @result = panel.field(@property)
26
- post_process
27
- @result
28
-
29
- # TODO: handle text (markdown and similar) properly
30
- end
31
-
32
- # Prepare query. Mainly here nothing special has to take place.
33
- def pre_process(_grafana)
34
- @from = nil
35
- @to = nil
36
- end
37
-
38
- # Replaces variables in the property field, if any are available.
39
- def post_process
40
- @result = replace_variables(@result, grafana_variables)
41
- end
42
- end
43
- end
44
- end
@@ -1,38 +0,0 @@
1
- # frozen_string_literal: true
2
-
3
- require_relative 'sql_table_query'
4
-
5
- module GrafanaReporter
6
- module Asciidoctor
7
- # (see SqlTableQuery)
8
- #
9
- # The SQL query as well as the datasource configuration are thereby captured from a
10
- # {Grafana::Panel}.
11
- class PanelTableQuery < SqlTableQuery
12
- include QueryMixin
13
-
14
- # @param panel [Grafana::Panel] panel which contains the query
15
- # @param query_letter [String] letter of the query within the panel, which shall be used, e.g. +C+
16
- def initialize(panel, query_letter)
17
- super(nil, nil)
18
- @panel = panel
19
- @query_letter = query_letter
20
- extract_dashboard_variables(@panel.dashboard)
21
- end
22
-
23
- # Retrieves the SQL query and the configured datasource from the panel.
24
- # @see Grafana::AbstractSqlQuery#pre_process
25
- # @param grafana [Grafana::Grafana] grafana instance against which the query shall be executed
26
- # @return [void]
27
- def pre_process(grafana)
28
- @sql = @panel.query(@query_letter)
29
- # resolve datasource name
30
- @datasource = @panel.field('datasource')
31
- @datasource_id = grafana.datasource_id(@datasource)
32
- super(grafana)
33
- @from = translate_date(@from, @variables['grafana-report-timestamp'], false)
34
- @to = translate_date(@to, @variables['grafana-report-timestamp'], true)
35
- end
36
- end
37
- end
38
- end
@@ -1,310 +0,0 @@
1
- module GrafanaReporter
2
- module Asciidoctor
3
- # This mixin contains several common methods, which can be used within the queries.
4
- module QueryMixin
5
- # Merges the given hashes to the current object by using the {Grafana::AbstractQuery#merge_variables} method.
6
- # It respects the priorities of the hashes and the object and allows only valid variables to be passed.
7
- # @param document_hash [Hash] variables from report template level
8
- # @param item_hash [Hash] variables from item configuration level, i.e. specific call, which may override document
9
- # @return [void]
10
- def merge_hash_variables(document_hash, item_hash)
11
- merge_variables(document_hash.select { |k, _v| k =~ /^var-/ || k == 'grafana-report-timestamp' }.transform_values { |item| ::Grafana::Variable.new(item) })
12
- # TODO: add documentation for transpose, column_divider and row_divider
13
- merge_variables(item_hash.select { |k, _v| k =~ /^var-/ || k =~ /^render-/ || k =~ /filter_columns|format|replace_values_.*|transpose|column_divider|row_divider/ }.transform_values { |item| ::Grafana::Variable.new(item) })
14
- # TODO: add documentation for timeout and grafana-default-timeout
15
- self.timeout = item_hash['timeout'] || document_hash['grafana-default-timeout'] || timeout
16
- self.from = item_hash['from'] || document_hash['from'] || from
17
- self.to = item_hash['to'] || document_hash['to'] || to
18
- end
19
-
20
- # Formats the SQL results returned from grafana to an easier to use format.
21
- #
22
- # The result is being formatted as stated below:
23
- #
24
- # {
25
- # :header => [column_title_1, column_title_2],
26
- # :content => [
27
- # [row_1_column_1, row_1_column_2],
28
- # [row_2_column_1, row_2_column_2]
29
- # ]
30
- # }
31
- # @param raw_result [Hash] query result hash from grafana
32
- # @return [Hash] sql result formatted as stated above
33
- # TODO: support series query results properly
34
- def preformat_sql_result(raw_result)
35
- results = {}
36
- results.default = []
37
-
38
- JSON.parse(raw_result)['results'].each_value do |query_result|
39
- if query_result.key?('error')
40
- results[:header] = results[:header] << ['SQL Error']
41
- results[:content] = [[query_result['error']]]
42
- elsif query_result['tables']
43
- query_result['tables'].each do |table|
44
- results[:header] = results[:header] << table['columns'].map { |header| header['text'] }
45
- results[:content] = table['rows']
46
- end
47
- else
48
- # TODO: add test for series results
49
- results[:header] = 'time'
50
- query_result['series'].each do |table|
51
- results[:header] << table[:name]
52
- results[:content] = []
53
- content_position = results[:header].length - 1
54
- table[:points].each do |point|
55
- result = []
56
- result << point[1]
57
- (content_position - 1).times { result << nil }
58
- result << point[0]
59
- results[:content][0] << result
60
- end
61
- end
62
- end
63
- end
64
-
65
- results
66
- end
67
-
68
- # Transposes the given result.
69
- #
70
- # NOTE: Only the +:content+ of the given result hash is transposed. The +:header+ is ignored.
71
- #
72
- # @param result [Hash] preformatted sql hash, (see {#preformat_sql_result})
73
- # @param transpose_variable [Grafana::Variable] true, if the result hash shall be transposed
74
- # @return [Hash] transposed query result
75
- def transpose(result, transpose_variable)
76
- return result unless transpose_variable
77
- return result unless transpose_variable.raw_value == 'true'
78
-
79
- result[:content] = result[:content].transpose
80
-
81
- result
82
- end
83
-
84
- # Filters columns out of the query result.
85
- #
86
- # Multiple columns may be filtered. Therefore the column titles have to be named in the
87
- # {Grafana::Variable#raw_value} and have to be separated by +,+ (comma).
88
- # @param result [Hash] preformatted sql hash, (see {#preformat_sql_result})
89
- # @param filter_columns_variable [Grafana::Variable] column names, which shall be removed in the query result
90
- # @return [Hash] filtered query result
91
- def filter_columns(result, filter_columns_variable)
92
- return result unless filter_columns_variable
93
-
94
- filter_columns = filter_columns_variable.raw_value
95
- filter_columns.split(',').each do |filter_column|
96
- pos = result[:header][0].index(filter_column)
97
-
98
- unless pos.nil?
99
- result[:header][0].delete_at(pos)
100
- result[:content].each { |row| row.delete_at(pos) }
101
- end
102
- end
103
-
104
- result
105
- end
106
-
107
- # Uses the {Kernel#format} method to format values in the query results.
108
- #
109
- # The formatting will be applied separately for every column. Therefore the column formats have to be named
110
- # in the {Grafana::Variable#raw_value} and have to be separated by +,+ (comma). If no value is specified for
111
- # a column, no change will happen.
112
- # @param result [Hash] preformatted sql hash, (see {#preformat_sql_result})
113
- # @param formats [Grafana::Variable] formats, which shall be applied to the columns in the query result
114
- # @return [Hash] formatted query result
115
- # TODO: make sure that caught errors are also visible in logger
116
- def format_columns(result, formats)
117
- return result unless formats
118
-
119
- formats.text.split(',').each_index do |i|
120
- format = formats.text.split(',')[i]
121
- next if format.empty?
122
-
123
- result[:content].map do |row|
124
- next unless row.length > i
125
-
126
- begin
127
- row[i] = format % row[i] if row[i]
128
- rescue StandardError => e
129
- row[i] = e.message
130
- end
131
- end
132
- end
133
- result
134
- end
135
-
136
- # Used to replace values in a query result according given configurations.
137
- #
138
- # The given variables will be applied to an appropriate column, depending
139
- # on the naming of the variable. The variable name ending specifies the column,
140
- # e.g. a variable named +replace_values_2+ will be applied to the second column.
141
- #
142
- # The {Grafana::Variable#text} needs to contain the replace specification.
143
- # Multiple replacements can be specified by separating them with +,+. If a
144
- # literal comma is needed, it can be escaped with a backslash: +\\,+.
145
- #
146
- # The rule will be separated from the replacement text with a colon +:+.
147
- # If a literal colon is wanted, it can be escaped with a backslash: +\\:+.
148
- #
149
- # Examples:
150
- # - Basic string replacement
151
- # MyTest:ThisValue
152
- # will replace all occurences of the text 'MyTest' with 'ThisValue'.
153
- # - Number comparison
154
- # <=10:OK
155
- # will replace all values smaller or equal to 10 with 'OK'.
156
- # - Regular expression
157
- # ^[^ ]\\+ (\d+)$:\1 is the answer
158
- # will replace all values matching the pattern, e.g. 'answerToAllQuestions 42' to
159
- # '42 is the answer'. Important to know: the regular expressions always have to start
160
- # with +^+ and end with +$+, i.e. the expression itself always has to match
161
- # the whole content in one field.
162
- # @param result [Hash] preformatted query result (see {#preformat_sql_result}.
163
- # @param configs [Array<Grafana::Variable>] one variable for replacing values in one column
164
- # @return [Hash] query result with replaced values
165
- # TODO: make sure that caught errors are also visible in logger
166
- def replace_values(result, configs)
167
- return result if configs.empty?
168
-
169
- configs.each do |key, formats|
170
- cols = key.split('_')[2..-1].map(&:to_i)
171
-
172
- formats.text.split(/(?<!\\),/).each_index do |j|
173
- format = formats.text.split(/(?<!\\),/)[j]
174
-
175
- arr = format.split(/(?<!\\):/)
176
- raise MalformedReplaceValuesStatementError, format if arr.length != 2
177
-
178
- k = arr[0]
179
- v = arr[1]
180
- k.gsub!(/\\([:,])/, '\1')
181
- v.gsub!(/\\([:,])/, '\1')
182
- result[:content].map do |row|
183
- (row.length - 1).downto 0 do |i|
184
- if cols.include?(i + 1) || cols.empty?
185
-
186
- # handle regular expressions
187
- if k.start_with?('^') && k.end_with?('$')
188
- begin
189
- row[i] = row[i].to_s.gsub(/#{k}/, v) if row[i].to_s =~ /#{k}/
190
- rescue StandardError => e
191
- row[i] = e.message
192
- end
193
-
194
- # handle value comparisons
195
- elsif (match = k.match(/^ *(?<operator>[<>]=?|<>|=) *(?<number>[+-]?\d+(?:\.\d+)?)$/))
196
- skip = false
197
- begin
198
- val = Float(row[i])
199
- rescue StandardError
200
- # value cannot be converted to number, simply ignore it as the comparison does not fit here
201
- skip = true
202
- end
203
-
204
- unless skip
205
- begin
206
- op = match[:operator].gsub(/^=$/, '==').gsub(/^<>$/, '!=')
207
- if val.public_send(op.to_sym, Float(match[:number]))
208
- row[i] = if v.include?('\\1')
209
- v.gsub(/\\1/, row[i].to_s)
210
- else
211
- v
212
- end
213
- end
214
- rescue StandardError => e
215
- row[i] = e.message
216
- end
217
- end
218
-
219
- # handle as normal comparison
220
- elsif row[i].to_s == k
221
- row[i] = v
222
- end
223
- end
224
- end
225
- end
226
- end
227
- end
228
-
229
- result
230
- end
231
-
232
- # Used to translate the relative date strings used by grafana, e.g. +now-5d/w+ to the
233
- # correct timestamp. Reason is that grafana does this in the frontend, which we have
234
- # to emulate here for the reporter.
235
- #
236
- # Additionally providing this function the +report_time+ assures that all queries
237
- # rendered within one report will use _exactly_ the same timestamp in those relative
238
- # times, i.e. there shouldn't appear any time differences, no matter how long the
239
- # report is running.
240
- # @param orig_date [String] time string provided by grafana, usually +from+ or +to+.
241
- # @param report_time [Grafana::Variable] report start time
242
- # @param is_to_time [Boolean] true, if the time should be calculated for +to+, false if it shall be
243
- # calculated for +from+
244
- # @return [String] translated date as timestamp string
245
- def translate_date(orig_date, report_time, is_to_time)
246
- report_time ||= Variable.new(Time.now.to_s)
247
- return (DateTime.parse(report_time.raw_value).to_time.to_i * 1000).to_s unless orig_date
248
- return orig_date if orig_date =~ /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$/
249
- return orig_date if orig_date =~ /^\d+$/
250
-
251
- # replace grafana from and to values using now, now-2d etc.
252
- date_splitted = orig_date.match(%r{^(?<now>now)(?:-(?<sub_count>\d+)?(?<sub_unit>[smhdwMy]?))?(?:/(?<fit>[smhdwMy]))?$})
253
- raise TimeRangeUnknownError, orig_date unless date_splitted
254
-
255
- date = DateTime.parse(report_time.raw_value)
256
- # substract specified time
257
- count = 1
258
- count = date_splitted[:sub_count].to_i if date_splitted[:sub_count]
259
- case date_splitted[:sub_unit]
260
- when 's'
261
- date = (date.to_time - (count * 1)).to_datetime
262
- when 'm'
263
- date = (date.to_time - (count * 60)).to_datetime
264
- when 'h'
265
- date = (date.to_time - (count * 60 * 60)).to_datetime
266
- when 'd'
267
- date = date.prev_day(count)
268
- when 'w'
269
- date = date.prev_day(count * 7)
270
- when 'M'
271
- date = date.prev_month(count)
272
- when 'y'
273
- date = date.prev_year(count)
274
- end
275
-
276
- # fit to specified time frame
277
- case date_splitted[:fit]
278
- when 's'
279
- date = DateTime.new(date.year, date.month, date.day, date.hour, date.min, date.sec, date.zone)
280
- date = (date.to_time + 1).to_datetime if is_to_time
281
- when 'm'
282
- date = DateTime.new(date.year, date.month, date.day, date.hour, date.min, 0, date.zone)
283
- date = (date.to_time + 60).to_datetime if is_to_time
284
- when 'h'
285
- date = DateTime.new(date.year, date.month, date.day, date.hour, 0, 0, date.zone)
286
- date = (date.to_time + 60 * 60).to_datetime if is_to_time
287
- when 'd'
288
- date = DateTime.new(date.year, date.month, date.day, 0, 0, 0, date.zone)
289
- date = date.next_day(1) if is_to_time
290
- when 'w'
291
- date = DateTime.new(date.year, date.month, date.day, 0, 0, 0, date.zone)
292
- date = if date.wday.zero?
293
- date.prev_day(7)
294
- else
295
- date.prev_day(date.wday - 1)
296
- end
297
- date = date.next_day(7) if is_to_time
298
- when 'M'
299
- date = DateTime.new(date.year, date.month, 1, 0, 0, 0, date.zone)
300
- date = date.next_month if is_to_time
301
- when 'y'
302
- date = DateTime.new(date.year, 1, 1, 0, 0, 0, date.zone)
303
- date = date.next_year if is_to_time
304
- end
305
-
306
- (date.to_time.to_i * 1000).to_s
307
- end
308
- end
309
- end
310
- end