Add support to query time series points via dog.get_points(from, to, query)

.gitignore

@@ -7,3 +7,4 @@
 Gemfile.lock
 doc/
 pkg/
+.idea

README.rdoc

@@ -119,3 +119,25 @@ data point you will need to pass a list of +Time+, +float+ pairs, instead of a s
     dog = Dogapi::Client.new(api_key)
 
     dog.emit_points('some.metric.name', [[t1, val1], [t2, val2], [t3, val3]], :host => "my_host", :device => "my_device")
+
+
+== Get points from a Datadog metric
+
+    require 'rubygems'
+    require 'dogapi'
+
+    api_key = "abcd123"
+    application_key = "brec1252"
+
+    dog = Dogapi::Client.new(api_key, application_key)
+
+    # get points from the last hour
+    from = Time.now - 3600
+    to = Time.now
+
+    query = 'sum:metric.count{*}.as_count()'
+
+    dog.get_points(from, to, query)
+
+
+

lib/dogapi/facade.rb

@@ -91,6 +91,16 @@ def emit_points(metric, points, options = {})
       @metric_svc.submit(metric, points, scope, options)
     end
 
+    # Get a set of points by query between from and to
+    #
+    # +from+ The seconds since the unix epoch <tt>[Time, Integer]</tt>
+    # +to+ The seconds since the unix epoch <tt>[Time, Integer]</tt>
+    # +query+ The query string <tt>[String]</tt>
+    #
+    def get_points(from, to, query)
+      @metric_svc.get(from, to, query)
+    end
+
     def batch_metrics()
       @metric_svc.switch_to_batched
       begin

lib/dogapi/v1/metric.rb

@@ -8,6 +8,27 @@ class MetricService < Dogapi::APIService
 
       API_VERSION = "v1"
 
+      def get(from, to, query)
+        begin
+          params = {
+              :api_key => @api_key,
+              :application_key => @application_key,
+
+              from: from.to_i,
+              to: to.to_i,
+              query: query
+          }
+          request(Net::HTTP::Get, '/api/' + API_VERSION + '/query', params, nil, false)
+        rescue Exception => e
+          if @silent
+            warn e
+            return -1, {}
+          else
+            raise e
+          end
+        end
+      end
+
       def upload(metrics)
         begin
           params = {