ruby-grafana-reporter 0.1.7 → 0.4.0

data/lib/grafana/grafana_alerts_datasource.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+module Grafana
+  # Implements the datasource interface to grafana alerts.
+  class GrafanaAlertsDatasource < AbstractDatasource
+    # +:raw_query+ needs to contain a Hash with the following structure:
+    #
+    #   {
+    #     dashboardId: Dashboard ID as String or nil
+    #     panelId:     Panel ID as String or nil
+    #     columns:
+    #     limit:
+    #     query:
+    #     state:
+    #     folderId:
+    #     dashboardQuery:
+    #     dashboardTag:
+    #   }
+    # @see AbstractDatasource#request
+    def request(query_description)
+      webrequest = query_description[:prepared_request]
+      webrequest.relative_url = "/api/alerts#{url_parameters(query_description)}"
+
+      result = webrequest.execute(query_description[:timeout])
+
+      json = JSON.parse(result.body)
+
+      content = []
+      begin
+        json.each { |item| content << item.fetch_values(*query_description[:raw_query]['columns'].split(',')) }
+      rescue KeyError => e
+        raise MalformedAttributeContentError.new(e.message, 'columns', query_description[:raw_query]['columns'])
+      end
+
+      result = {}
+      result[:header] = [query_description[:raw_query]['columns'].split(',')]
+      result[:content] = content
+
+      result
+    end
+
+    private
+
+    def url_parameters(query_desc)
+      url_vars = {}
+      url_vars.merge!(query_desc[:raw_query].select do |k, _v|
+        k =~ /^(?:limit|dashboardId|panelId|query|state|folderId|dashboardQuery|dashboardTag)/
+      end)
+      url_vars['from'] = query_desc[:from] if query_desc[:from]
+      url_vars['to'] = query_desc[:to] if query_desc[:to]
+      url_params = URI.encode_www_form(url_vars.map { |k, v| [k, v.to_s] })
+      return '' if url_params.empty?
+
+      "?#{url_params}"
+    end
+  end
+end

data/lib/grafana/grafana_annotations_datasource.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+module Grafana
+  # Implements the datasource interface to grafana annotations.
+  class GrafanaAnnotationsDatasource < AbstractDatasource
+    # +:raw_query+ needs to contain a Hash with the following structure:
+    #
+    #   {
+    #     dashboardId: Dashboard ID as String or nil
+    #     panelId:     Panel ID as String or nil
+    #     columns:
+    #     limit:
+    #     alertId:
+    #     userId:
+    #     type:
+    #     tags:
+    #   }
+    # @see AbstractDatasource#request
+    def request(query_description)
+      webrequest = query_description[:prepared_request]
+      webrequest.relative_url = "/api/annotations#{url_parameters(query_description)}"
+
+      result = webrequest.execute(query_description[:timeout])
+
+      json = JSON.parse(result.body)
+
+      content = []
+      begin
+        json.each { |item| content << item.fetch_values(*query_description[:raw_query]['columns'].split(',')) }
+      rescue KeyError => e
+        raise MalformedAttributeContentError.new(e.message, 'columns', query_description[:raw_query]['columns'])
+      end
+
+      result = {}
+      result[:header] = [query_description[:raw_query]['columns'].split(',')]
+      result[:content] = content
+
+      result
+    end
+
+    private
+
+    def url_parameters(query_desc)
+      url_vars = {}
+      url_vars.merge!(query_desc[:raw_query].select do |k, _v|
+        k =~ /^(?:limit|alertId|dashboardId|panelId|userId|type|tags)/
+      end)
+      url_vars['from'] = query_desc[:from] if query_desc[:from]
+      url_vars['to'] = query_desc[:to] if query_desc[:to]
+      url_params = URI.encode_www_form(url_vars.map { |k, v| [k, v.to_s] })
+      return '' if url_params.empty?
+
+      "?#{url_params}"
+    end
+  end
+end

data/lib/grafana/grafana_property_datasource.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Grafana
+  # Implements the datasource interface to grafana model properties.
+  class GrafanaPropertyDatasource < AbstractDatasource
+    # +:raw_query+ needs to contain a Hash with the following structure:
+    #
+    #   {
+    #     property_name: Name of the queried property as String
+    #     panel:         {Panel} object to query
+    #   }
+    # @see AbstractDatasource#request
+    def request(query_description)
+      raise MissingSqlQueryError if query_description[:raw_query].nil?
+
+      panel = query_description[:raw_query][:panel]
+      property_name = query_description[:raw_query][:property_name]
+
+      {
+        header: [query_description[:raw_query][:property_name]],
+        content: [replace_variables(panel.field(property_name), query_description[:variables])]
+      }
+    end
+  end
+end

data/lib/grafana/graphite_datasource.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module Grafana
+  # Implements the interface to graphite datasources.
+  class GraphiteDatasource < AbstractDatasource
+    # +:raw_query+ needs to contain a Graphite query as String
+    # @see AbstractDatasource#request
+    def request(query_description)
+      raise MissingSqlQueryError if query_description[:raw_query].nil?
+
+      request = {
+        body: URI.encode_www_form('from': DateTime.strptime(query_description[:from], '%Q').strftime('%H:%M_%Y%m%d'),
+                                  'until': DateTime.strptime(query_description[:to], '%Q').strftime('%H:%M_%Y%m%d'),
+                                  'format': 'json',
+                                  'target': replace_variables(query_description[:raw_query], query_description[:variables])),
+        content_type: 'application/x-www-form-urlencoded',
+        request: Net::HTTP::Post
+      }
+
+      webrequest = query_description[:prepared_request]
+      webrequest.relative_url = "/api/datasources/proxy/#{id}/render"
+      webrequest.options.merge!(request)
+
+      result = webrequest.execute(query_description[:timeout])
+      preformat_response(result.body)
+    end
+
+    # @see AbstractDatasource#raw_query_from_panel_model
+    def raw_query_from_panel_model(panel_query_target)
+      panel_query_target['target']
+    end
+
+    private
+
+    # @see AbstractDatasource#preformat_response
+    def preformat_response(response_body)
+      # TODO: support multiple metrics as return types
+      {
+        header: %w[value time],
+        content: JSON.parse(response_body).first['datapoints']
+      }
+    end
+  end
+end

data/lib/grafana/image_rendering_datasource.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module Grafana
+  # Implements the interface to image rendering datasources.
+  class ImageRenderingDatasource < AbstractDatasource
+    # +:raw_query+ needs to contain a Hash with the following structure:
+    #
+    #   {
+    #     panel: {Panel} which shall be rendered
+    #   }
+    # @see AbstractDatasource#request
+    def request(query_description)
+      webrequest = query_description[:prepared_request]
+      webrequest.relative_url = query_description[:raw_query][:panel].render_url + url_params(query_description)
+      webrequest.options.merge!({ accept: 'image/png' })
+
+      result = webrequest.execute
+
+      { header: ['image'], content: [result.body] }
+    end
+
+    private
+
+    def url_params(query_desc)
+      url_vars = query_desc[:variables].select { |k, _v| k =~ /^(?:timeout|height|width|theme|fullscreen|var-.+)$/ }
+      url_vars = default_vars.merge(url_vars)
+      url_vars['from'] = Variable.new(query_desc[:from])
+      url_vars['to'] = Variable.new(query_desc[:to])
+      result = URI.encode_www_form(url_vars.map { |k, v| [k, v.raw_value.to_s] })
+
+      return '' if result.empty?
+
+      "&#{result}"
+    end
+
+    def default_vars
+      {
+        'fullscreen' => Variable.new(true),
+        'theme' => Variable.new('light'),
+        'timeout' => Variable.new(60)
+      }
+    end
+  end
+end

data/lib/grafana/panel.rb

@@ -1,39 +1,47 @@
-module Grafana
-  # Representation of one specific panel in a {Dashboard} instance.
-  class Panel
-    # @return [Dashboard] parent {Dashboard} object
-    attr_reader :dashboard
-
-    # @param model [Hash] converted JSON Hash of the panel
-    # @param dashboard [Dashboard] parent {Dashboard} object
-    def initialize(model, dashboard)
-      @model = model
-      @dashboard = dashboard
-    end
-
-    # @return [String] content of the requested field or +''+ if not found
-    def field(field)
-      return @model[field] if @model.key?(field)
-
-      ''
-    end
-
-    # @return [String] panel ID
-    def id
-      @model['id']
-    end
-
-    # @return [String] SQL query string for the requested query letter
-    def query(query_letter)
-      query_item = @model['targets'].select { |item| item['refId'].to_s == query_letter.to_s }.first
-      raise QueryLetterDoesNotExistError.new(query_letter, self) if query_item.nil?
-
-      query_item['rawSql']
-    end
-
-    # @return [String] relative rendering URL for the panel, to create an image out of it
-    def render_url
-      "/render/d-solo/#{@dashboard.id}?panelId=#{@model['id']}"
-    end
-  end
-end
+# frozen_string_literal: true
+
+module Grafana
+  # Representation of one specific panel in a {Dashboard} instance.
+  class Panel
+    # @return [Dashboard] parent {Dashboard} object
+    attr_reader :dashboard
+    attr_reader :model
+
+    # @param model [Hash] converted JSON Hash of the panel
+    # @param dashboard [Dashboard] parent {Dashboard} object
+    def initialize(model, dashboard)
+      @model = model
+      @dashboard = dashboard
+    end
+
+    # @return [String] content of the requested field or +''+ if not found
+    def field(field)
+      return @model[field] if @model.key?(field)
+
+      ''
+    end
+
+    # @return [String] panel ID
+    def id
+      @model['id']
+    end
+
+    # @return [Datasource] datasource object specified for the current panel
+    def datasource
+      dashboard.grafana.datasource_by_name(@model['datasource'])
+    end
+
+    # @return [String] query string for the requested query letter
+    def query(query_letter)
+      query_item = @model['targets'].select { |item| item['refId'].to_s == query_letter.to_s }.first
+      raise QueryLetterDoesNotExistError.new(query_letter, self) unless query_item
+
+      datasource.raw_query_from_panel_model(query_item)
+    end
+
+    # @return [String] relative rendering URL for the panel, to create an image out of it
+    def render_url
+      "/render/d-solo/#{@dashboard.id}?panelId=#{@model['id']}"
+    end
+  end
+end

data/lib/grafana/prometheus_datasource.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+module Grafana
+  # Implements the interface to Prometheus datasources.
+  class PrometheusDatasource < AbstractDatasource
+    # +:raw_query+ needs to contain a Prometheus query as String
+    # @see AbstractDatasource#request
+    def request(query_description)
+      raise MissingSqlQueryError if query_description[:raw_query].nil?
+
+      url = "/api/datasources/proxy/#{id}/api/v1/query_range?"\
+            "start=#{query_description[:from]}&end=#{query_description[:to]}"\
+            "&query=#{replace_variables(query_description[:raw_query], query_description[:variables])}"
+
+      webrequest = query_description[:prepared_request]
+      webrequest.relative_url = url
+      webrequest.options.merge!({ request: Net::HTTP::Get })
+
+      result = webrequest.execute(query_description[:timeout])
+      preformat_response(result.body)
+    end
+
+    # @see AbstractDatasource#raw_query_from_panel_model
+    def raw_query_from_panel_model(panel_query_target)
+      panel_query_target['expr']
+    end
+
+    private
+
+    # @see AbstractDatasource#preformat_response
+    def preformat_response(response_body)
+      # TODO: support multiple metrics as return types
+      {
+        header: %w[time value],
+        content: JSON.parse(response_body)['data']['result'].first['values']
+      }
+    end
+  end
+end

data/lib/grafana/sql_datasource.rb

@@ -0,0 +1,65 @@
+# frozen_string_literal: true
+
+module Grafana
+  # Implements the interface to all SQL based datasources (tested with PostgreSQL and MariaDB/MySQL).
+  class SqlDatasource < AbstractDatasource
+    # +:raw_query+ needs to contain a SQL query as String in the respective database dialect
+    # @see AbstractDatasource#request
+    def request(query_description)
+      raise MissingSqlQueryError if query_description[:raw_query].nil?
+
+      sql = replace_variables(query_description[:raw_query], query_description[:variables])
+      request = {
+        body: {
+          from: query_description[:from],
+          to: query_description[:to],
+          queries: [rawSql: prepare_sql(sql), datasourceId: id, format: 'table']
+        }.to_json,
+        request: Net::HTTP::Post
+      }
+
+      webrequest = query_description[:prepared_request]
+      webrequest.relative_url = '/api/tsdb/query'
+      webrequest.options.merge!(request)
+
+      result = webrequest.execute(query_description[:timeout])
+      preformat_response(result.body)
+    end
+
+    # @see AbstractDatasource#raw_query_from_panel_model
+    def raw_query_from_panel_model(panel_query_target)
+      panel_query_target['rawSql']
+    end
+
+    private
+
+    def preformat_response(response_body)
+      results = {}
+      results.default = []
+
+      JSON.parse(response_body)['results'].each_value do |query_result|
+        if query_result.key?('error')
+          results[:header] = results[:header] << ['SQL Error']
+          results[:content] = [[query_result['error']]]
+
+        elsif query_result['tables']
+          query_result['tables'].each do |table|
+            results[:header] = results[:header] << table['columns'].map { |header| header['text'] }
+            results[:content] = table['rows']
+          end
+
+        end
+      end
+
+      results
+    end
+
+    def prepare_sql(sql)
+      # remove comments in query
+      sql.gsub!(/--[^\r\n]*(?:[\r\n]+|$)/, ' ')
+      sql.gsub!(/\r\n/, ' ')
+      sql.gsub!(/\n/, ' ')
+      sql
+    end
+  end
+end

data/lib/grafana/variable.rb

@@ -1,259 +1,218 @@
-module Grafana
-  # This class contains a representation of
-  # {https://grafana.com/docs/grafana/latest/variables/templates-and-variables grafana variables},
-  # aka grafana templates.
-  #
-  # The main need therefore rises in order to replace variables properly in different
-  # texts, e.g. SQL statements or results.
-  class Variable
-    attr_reader :name, :text, :raw_value
-
-    # @param config_or_value [Hash, Object] configuration hash of a variable out of an {Dashboard} instance or a value of any kind.
-    def initialize(config_or_value)
-      if config_or_value.is_a? Hash
-        @config = config_or_value
-        @name = @config['name']
-        unless @config['current'].nil?
-          @raw_value = @config['current']['value']
-          @text = @config['current']['text']
-        end
-      else
-        @config = {}
-        @raw_value = config_or_value
-        @text = config_or_value.to_s
-      end
-    end
-
-    # Returns the stored value formatted according the given format.
-    #
-    # Supported formats are: +csv+, +distributed+, +doublequote+, +json+, +percentencode+, +pipe+, +raw+, +regex+, +singlequote+, +sqlstring+, +lucene+, +date+ or +glob+ (default)
-    #
-    # For details see {https://grafana.com/docs/grafana/latest/variables/advanced-variable-format-options Grafana Advanced variable format options}.
-    #
-    # For details of +date+ format, see {https://grafana.com/docs/grafana/latest/variables/variable-types/global-variables/#__from-and-__to}. Please note that input for +date+ format is unixtime in milliseconds.
-    #
-    # @param format [String] desired format
-    # @return [String] value of stored variable according the specified format
-    def value_formatted(format = '')
-      value = @raw_value
-
-      # handle value 'All' properly
-      # TODO fix check for selection of All properly
-      if value == 'All' or @text == 'All'
-        if !@config['options'].empty?
-          value = @config['options'].map { |item| item['value'] }
-        elsif !@config['query'].empty?
-          # TODO: replace variables in this query, too
-          return @config['query']
-          # TODO handle 'All' value properly for query attributes
-        else
-          # TODO how to handle All selection properly at this point?
-        end
-      end
-
-      case format
-      when 'csv'
-        return value.join(',').to_s if multi?
-
-        value.to_s
-
-      when 'distributed'
-        return value.join(",#{name}=") if multi?
-
-        value
-      when 'doublequote'
-        if multi?
-          value = value.map { |item| "\"#{item.gsub(/[\\]/, '\\\\').gsub(/"/, '\\"')}\"" }
-          return value.join(',')
-        end
-        "\"#{value.gsub(/"/, '\\"')}\""
-
-      when 'json'
-        if multi?
-          value = value.map { |item| "\"#{item.gsub(/["\\]/, '\\\\' + '\0')}\"" }
-          return "[#{value.join(',')}]"
-        end
-        "\"#{value.gsub(/"/, '\\"')}\""
-
-      when 'percentencode'
-        value = "{#{value.join(',')}}" if multi?
-        ERB::Util.url_encode(value)
-
-      when 'pipe'
-        return value.join('|') if multi?
-
-        value
-
-      when 'raw'
-        return "{#{value.join(',')}}" if multi?
-
-        value
-
-      when 'regex'
-        if multi?
-          value = value.map { |item| item.gsub(%r{[/$\.\|\\]}, '\\\\' + '\0') }
-          return "(#{value.join('|')})"
-        end
-        value.gsub(%r{[/$\.\|\\]}, '\\\\' + '\0')
-
-      when 'singlequote'
-        if multi?
-          value = value.map { |item| "'#{item.gsub(/[']/, '\\\\' + '\0')}'" }
-          return value.join(',')
-        end
-        "'#{value.gsub(/[']/, '\\\\' + '\0')}'"
-
-      when 'sqlstring'
-        if multi?
-          value = value.map { |item| "'#{item.gsub(/'/, "''")}'" }
-          return value.join(',')
-        end
-        "'#{value.gsub(/'/, "''")}'"
-
-      when 'lucene'
-        if multi?
-          value = value.map { |item| "\"#{item.gsub(%r{[" |=/\\]}, '\\\\' + '\0')}\"" }
-          return "(#{value.join(' OR ')})"
-        end
-        value.gsub(%r{[" |=/\\]}, '\\\\' + '\0')
-
-      when /^date(?:[:](?<format>.*))?$/
-        #TODO validate how grafana handles multivariables with date format
-        get_date_formatted(value, $1)
-
-      when ''
-        # default
-        if multi?
-          value = value.map { |item| "'#{item.gsub(/'/, "''")}'" }
-          return value.join(',')
-        end
-        value.gsub(/'/, "''")
-
-      else
-        # glob and all unknown
-	#TODO add check for array value properly for all cases
-        return "{#{value.join(',')}}" if multi? and value.is_a?(Array)
-
-        value
-      end
-    end
-
-    # @return [Boolean] true, if the value can contain multiple selections, i.e. is an Array
-    def multi?
-      return @config['multi'] unless @config['multi'].nil?
-
-      @raw_value.is_a? Array
-    end
-
-    # @return [Object] raw value of the variable
-    def raw_value=(new_val)
-      @raw_value = new_val
-      @raw_value = @raw_value.to_s unless @raw_value.is_a?(Array)
-      new_text = @raw_value
-      if @config['options']
-        val = @config['options'].select { |item| item['value'] == @raw_value }
-        new_text = val.first['text'] unless val.empty?
-      end
-      @text = new_text
-    end
-
-    private
-
-    # Realize time formatting according
-    # {https://grafana.com/docs/grafana/latest/variables/variable-types/global-variables/#__from-and-__to}
-    # and {https://momentjs.com/docs/#/displaying/}.
-    def get_date_formatted(value, format)
-      return (Float(value) / 1000).to_i.to_s if format == 'seconds'
-      return Time.at((Float(value) / 1000).to_i).utc.iso8601(3) if !format or format == 'iso'
-
-      # build array of known matches
-      matches = []
-      work_string = format
-      while work_string.length > 0
-        tmp = work_string.scan(/^(?:M{1,4}|D{1,4}|d{1,4}|e|E|w{1,2}|W{1,2}|Y{4}|Y{2}|A|a|H{1,2}|h{1,2}|k{1,2}|m{1,2}|s{1,2}|S+|X)/)
-        unless tmp.empty?
-          matches << tmp[0]
-          work_string.delete_prefix!(tmp[0])
-        else
-          matches << work_string[0]
-          work_string.delete_prefix!(work_string[0])
-        end
-      end
-
-      #TODO move case when to hash
-      format_string = ""
-      matches.each do |match|
-        format_string += case match
-          when 'M'
-            '%-m'
-          when 'MM'
-            '%m'
-          when 'MMM'
-            '%b'
-          when 'MMMM'
-            '%B'
-          when 'D'
-            '%-d'
-          when 'DD'
-            '%d'
-          when 'DDD'
-            '%-j'
-          when 'DDDD'
-            '%j'
-          when 'YY'
-            '%y'
-          when 'YYYY'
-            '%Y'
-          when 'd'
-            '%w'
-          when 'ddd'
-            '%a'
-          when 'dddd'
-            '%A'
-          when 'e'
-            '%w'
-          when 'E'
-            '%u'
-          when 'w'
-            '%-U'
-          when 'ww'
-            '%U'
-          when 'W'
-            '%-V'
-          when 'WW'
-            '%V'
-          when 'YY'
-            '%y'
-          when 'YYYY'
-            '%Y'
-          when 'A'
-            '%p'
-          when 'a'
-            '%P'
-          when 'H'
-            '%-H'
-          when 'HH'
-            '%H'
-          when 'h'
-            '%-I'
-          when 'hh'
-            '%I'
-          when 'm'
-            '%-M'
-          when 'mm'
-            '%M'
-          when 's'
-            '%-S'
-          when 'ss'
-            '%S'
-          when 'X'
-            '%s'
-          else
-            match
-          end
-      end
-
-      Time.at((Float(value) / 1000).to_i).strftime(format_string)
-    end
-  end
-end
+# frozen_string_literal: true
+
+module Grafana
+  # This class contains a representation of
+  # {https://grafana.com/docs/grafana/latest/variables/templates-and-variables grafana variables},
+  # aka grafana templates.
+  #
+  # The main need therefore rises in order to replace variables properly in different
+  # texts, e.g. SQL statements or results.
+  class Variable
+    attr_reader :name, :text, :raw_value
+
+    # Translation table to support {https://momentjs.com/docs/#/displaying/}.
+    DATE_MATCHES = { 'M' => '%-m', 'MM' => '%m', 'MMM' => '%b',  'MMMM' => '%B',
+                     'D' => '%-d', 'DD' => '%d', 'DDD' => '%-j', 'DDDD' => '%j',
+                     'd' => '%w',                'ddd' => '%a',  'dddd' => '%A',
+                     'YY' => '%y', 'YYYY' => '%Y',
+                     'h' => '%-I', 'hh' => '%I',
+                     'H' => '%-H', 'HH' => '%H',
+                     'm' => '%-M', 'mm' => '%M',
+                     's' => '%-S', 'ss' => '%S',
+                     'w' => '%-U', 'ww' => '%U',
+                     'W' => '%-V', 'WW' => '%V',
+                     'a' => '%P',
+                     'A' => '%p',
+                     'e' => '%w',
+                     'E' => '%u',
+                     'X' => '%s' }.freeze
+
+    # @param config_or_value [Hash, Object] configuration hash of a variable out of an {Dashboard} instance
+    #  or a value of any kind.
+    def initialize(config_or_value)
+      if config_or_value.is_a? Hash
+        @config = config_or_value
+        @name = @config['name']
+        unless @config['current'].nil?
+          @raw_value = @config['current']['value']
+          @text = @config['current']['text']
+        end
+      else
+        @config = {}
+        @raw_value = config_or_value
+        @text = config_or_value.to_s
+      end
+    end
+
+    # Returns the stored value formatted according the given format.
+    #
+    # Supported formats are: +csv+, +distributed+, +doublequote+, +json+, +percentencode+, +pipe+, +raw+,
+    # +regex+, +singlequote+, +sqlstring+, +lucene+, +date+ or +glob+ (default)
+    #
+    # For details see {https://grafana.com/docs/grafana/latest/variables/advanced-variable-format-options
+    # Grafana Advanced variable format options}.
+    #
+    # For details of +date+ format, see
+    # {https://grafana.com/docs/grafana/latest/variables/variable-types/global-variables/#__from-and-__to
+    # Grafana global variables $__from and $__to}.
+    # Please note that input for +date+ format is unixtime in milliseconds.
+    #
+    # @param format [String] desired format
+    # @return [String] value of stored variable according the specified format
+    def value_formatted(format = '')
+      value = @raw_value
+
+      # handle value 'All' properly
+      # TODO: fix check for selection of All properly
+      if (value == 'All') || (@text == 'All')
+        if !@config['options'].empty?
+          value = @config['options'].map { |item| item['value'] }
+        elsif !@config['query'].empty?
+          # TODO: replace variables in this query, too
+          return @config['query']
+          # TODO: handle 'All' value properly for query attributes
+        else
+          # TODO: how to handle All selection properly at this point?
+        end
+      end
+
+      case format
+      when 'csv'
+        return value.join(',').to_s if multi?
+
+        value.to_s
+
+      when 'distributed'
+        return value.join(",#{name}=") if multi?
+
+        value
+      when 'doublequote'
+        if multi?
+          value = value.map { |item| "\"#{item.gsub(/\\/, '\\\\').gsub(/"/, '\\"')}\"" }
+          return value.join(',')
+        end
+        "\"#{value.gsub(/"/, '\\"')}\""
+
+      when 'json'
+        if multi?
+          value = value.map { |item| "\"#{item.gsub(/["\\]/, '\\\\\0')}\"" }
+          return "[#{value.join(',')}]"
+        end
+        "\"#{value.gsub(/"/, '\\"')}\""
+
+      when 'percentencode'
+        value = "{#{value.join(',')}}" if multi?
+        ERB::Util.url_encode(value)
+
+      when 'pipe'
+        return value.join('|') if multi?
+
+        value
+
+      when 'raw'
+        return "{#{value.join(',')}}" if multi?
+
+        value
+
+      when 'regex'
+        if multi?
+          value = value.map { |item| item.gsub(%r{[/$.|\\]}, '\\\\\0') }
+          return "(#{value.join('|')})"
+        end
+        value.gsub(%r{[/$.|\\]}, '\\\\\0')
+
+      when 'singlequote'
+        if multi?
+          value = value.map { |item| "'#{item.gsub(/'/, '\\\\\0')}'" }
+          return value.join(',')
+        end
+        "'#{value.gsub(/'/, '\\\\\0')}'"
+
+      when 'sqlstring'
+        if multi?
+          value = value.map { |item| "'#{item.gsub(/'/, "''")}'" }
+          return value.join(',')
+        end
+        "'#{value.gsub(/'/, "''")}'"
+
+      when 'lucene'
+        if multi?
+          value = value.map { |item| "\"#{item.gsub(%r{[" |=/\\]}, '\\\\\0')}\"" }
+          return "(#{value.join(' OR ')})"
+        end
+        value.gsub(%r{[" |=/\\]}, '\\\\\0')
+
+      when /^date(?::(?<format>.*))?$/
+        # TODO: validate how grafana handles multivariables with date format
+        get_date_formatted(value, Regexp.last_match(1))
+
+      when ''
+        # default
+        if multi?
+          value = value.map { |item| "'#{item.gsub(/'/, "''")}'" }
+          return value.join(',')
+        end
+        value.gsub(/'/, "''")
+
+      else
+        # glob and all unknown
+        # TODO add check for array value properly for all cases
+        return "{#{value.join(',')}}" if multi? && value.is_a?(Array)
+
+        value
+      end
+    end
+
+    # @return [Boolean] true, if the value can contain multiple selections, i.e. is an Array
+    def multi?
+      return @config['multi'] unless @config['multi'].nil?
+
+      @raw_value.is_a? Array
+    end
+
+    # @return [Object] raw value of the variable
+    def raw_value=(new_val)
+      @raw_value = new_val
+      @raw_value = @raw_value.to_s unless @raw_value.is_a?(Array)
+      new_text = @raw_value
+      if @config['options']
+        val = @config['options'].select { |item| item['value'] == @raw_value }
+        new_text = val.first['text'] unless val.empty?
+      end
+      @text = new_text
+    end
+
+    private
+
+    # Realize time formatting according
+    # {https://grafana.com/docs/grafana/latest/variables/variable-types/global-variables/#__from-and-__to}
+    # and {https://momentjs.com/docs/#/displaying/}.
+    def get_date_formatted(value, format)
+      return (Float(value) / 1000).to_i.to_s if format == 'seconds'
+      return Time.at((Float(value) / 1000).to_i).utc.iso8601(3) if !format || (format == 'iso')
+
+      # build array of known matches
+      matches = []
+      work_string = format
+      until work_string.empty?
+        tmp = work_string.scan(/^(?:M{1,4}|D{1,4}|d{1,4}|e|E|w{1,2}|W{1,2}|Y{4}|Y{2}|A|a|H{1,2}|
+                                    h{1,2}|k{1,2}|m{1,2}|s{1,2}|S+|X)/x)
+        if tmp.empty?
+          matches << work_string[0]
+          work_string.sub!(/^#{work_string[0]}/, '')
+        else
+          matches << tmp[0]
+          work_string.sub!(/^#{tmp[0]}/, '')
+        end
+      end
+
+      format_string = ''.dup
+      matches.each do |match|
+        replacement = DATE_MATCHES[match]
+        format_string << (replacement || match)
+      end
+
+      Time.at((Float(value) / 1000).to_i).strftime(format_string)
+    end
+  end
+end