dogapi-demo 0.1.0

data/lib/dogapi-demo/metric.rb

@@ -0,0 +1,34 @@
+require 'net/http'
+
+require 'rubygems'
+require 'multi_json'
+
+module DogapiDemo
+
+  # <b>DEPRECATED:</b> Going forward, use the V1 services. This legacy service will be
+  # removed in an upcoming release.
+  class MetricService < DogapiDemo::Service
+
+    API_VERSION = "1.0.0"
+
+    # <b>DEPRECATED:</b> Going forward, use the V1 services. This legacy service will be
+    # removed in an upcoming release.
+    def submit(api_key, scope, metric, points)
+      warn "[DEPRECATION] DogapiDemo::MetricService.submit() has been deprecated in favor of the newer V1 services"
+      series = [{
+        :host    =>  scope.host,
+        :device  =>  scope.device,
+        :metric  =>  metric,
+        :points  =>  points.map { |p| [p[0].to_i, p[1]] }
+      }]
+
+      params = {
+        :api_key      =>  api_key,
+        :api_version  =>  API_VERSION,
+        :series       =>  series.to_json
+      }
+
+      request Net::HTTP::Post, '/series/submit', params
+    end
+  end
+end

data/lib/dogapi-demo/v1.rb

@@ -0,0 +1,13 @@
+require 'dogapi-demo/v1/event'
+require 'dogapi-demo/v1/metric'
+require 'dogapi-demo/v1/tag'
+require 'dogapi-demo/v1/comment'
+require 'dogapi-demo/v1/search'
+require 'dogapi-demo/v1/dash'
+require 'dogapi-demo/v1/alert'
+require 'dogapi-demo/v1/user'
+require 'dogapi-demo/v1/snapshot'
+require 'dogapi-demo/v1/embed'
+require 'dogapi-demo/v1/screenboard'
+require 'dogapi-demo/v1/monitor'
+require 'dogapi-demo/v1/service_check'

data/lib/dogapi-demo/v1/alert.rb

@@ -0,0 +1,112 @@
+require 'dogapi-demo'
+
+module DogapiDemo
+  class V1 # for namespacing
+
+    class AlertService < DogapiDemo::APIService
+
+      API_VERSION = "v1"
+
+      def alert(query, options = {})
+        begin
+          params = {
+            :api_key => @api_key,
+            :application_key => @application_key
+          }
+
+          body = {
+            'query' => query,
+          }.merge options
+
+          request(Net::HTTP::Post, "/api/#{API_VERSION}/alert", params, body, true)
+        rescue Exception => e
+          suppress_error_if_silent e
+        end
+      end
+
+      def update_alert(alert_id, query, options)
+        begin
+          params = {
+            :api_key => @api_key,
+            :application_key => @application_key
+          }
+
+          body = {
+            'query' => query,
+          }.merge options
+
+          request(Net::HTTP::Put, "/api/#{API_VERSION}/alert/#{alert_id}", params, body, true)
+        rescue Exception => e
+          suppress_error_if_silent e
+        end
+      end
+
+      def get_alert(alert_id)
+        begin
+          params = {
+            :api_key => @api_key,
+            :application_key => @application_key
+          }
+
+          request(Net::HTTP::Get, "/api/#{API_VERSION}/alert/#{alert_id}", params, nil, false)
+        rescue Exception => e
+          suppress_error_if_silent e
+        end
+      end
+
+      def delete_alert(alert_id)
+        begin
+          params = {
+            :api_key => @api_key,
+            :application_key => @application_key
+          }
+
+          request(Net::HTTP::Delete, "/api/#{API_VERSION}/alert/#{alert_id}", params, nil, false)
+        rescue Exception => e
+          suppress_error_if_silent e
+        end
+      end
+
+      def get_all_alerts()
+        begin
+          params = {
+            :api_key => @api_key,
+            :application_key => @application_key
+          }
+
+          request(Net::HTTP::Get, "/api/#{API_VERSION}/alert", params, nil, false)
+        rescue Exception => e
+          suppress_error_if_silent e
+        end
+      end
+
+      def mute_alerts()
+        begin
+          params = {
+            :api_key => @api_key,
+            :application_key => @application_key
+          }
+
+          request(Net::HTTP::Post, "/api/#{API_VERSION}/mute_alerts", params, nil, false)
+        rescue Exception => e
+          suppress_error_if_silent e
+        end
+      end
+
+      def unmute_alerts()
+        begin
+          params = {
+            :api_key => @api_key,
+            :application_key => @application_key
+          }
+
+          request(Net::HTTP::Post, "/api/#{API_VERSION}/unmute_alerts", params, nil, false)
+        rescue Exception => e
+          suppress_error_if_silent e
+        end
+      end
+
+    end
+
+  end
+end

data/lib/dogapi-demo/v1/comment.rb

@@ -0,0 +1,62 @@
+require 'dogapi-demo'
+
+module DogapiDemo
+  class V1 # for namespacing
+
+    class CommentService < DogapiDemo::APIService
+
+      API_VERSION = "v1"
+
+      # Submit a comment.
+      def comment(message, options = {})
+        begin
+          params = {
+            :api_key => @api_key,
+            :application_key => @application_key
+          }
+
+          body = {
+            'message' => message,
+          }.merge options
+
+          request(Net::HTTP::Post, "/api/#{API_VERSION}/comments", params, body, true)
+        rescue Exception => e
+          suppress_error_if_silent e
+        end
+      end
+
+      # Update a comment.
+      def update_comment(comment_id, options = {})
+        begin
+          params = {
+            :api_key => @api_key,
+            :application_key => @application_key
+          }
+
+          if options.empty?
+            raise "Must update something."
+          end
+
+          request(Net::HTTP::Put, "/api/#{API_VERSION}/comments/#{comment_id}", params, options, true)
+        rescue Exception => e
+          suppress_error_if_silent e
+        end
+      end
+
+      def delete_comment(comment_id)
+        begin
+          params = {
+            :api_key => @api_key,
+            :application_key => @application_key
+          }
+
+          request(Net::HTTP::Delete, "/api/#{API_VERSION}/comments/#{comment_id}", params, nil, false)
+        rescue Exception => e
+          suppress_error_if_silent e
+        end
+      end
+
+    end
+
+  end
+end

data/lib/dogapi-demo/v1/dash.rb

@@ -0,0 +1,94 @@
+require 'dogapi-demo'
+
+module DogapiDemo
+  class V1 # for namespacing
+
+    class DashService < DogapiDemo::APIService
+
+      API_VERSION = "v1"
+
+      def create_dashboard(title, description, graphs, template_variables = nil)
+
+        begin
+          params = {
+            :api_key => @api_key,
+            :application_key => @application_key
+          }
+
+          body = {
+            :title => title,
+            :description => description,
+            :graphs => graphs,
+            :template_variables => (template_variables or [])
+          }
+
+          request(Net::HTTP::Post, "/api/#{API_VERSION}/dash", params, body, true)
+        rescue Exception => e
+          suppress_error_if_silent e
+        end
+      end
+
+      def update_dashboard(dash_id, title, description, graphs, template_variables=nil)
+
+        begin
+          params = {
+            :api_key => @api_key,
+            :application_key => @application_key
+          }
+
+          body = {
+            :title => title,
+            :description => description,
+            :graphs => graphs,
+            :template_variables => (template_variables or [])
+          }
+
+          request(Net::HTTP::Put, "/api/#{API_VERSION}/dash/#{dash_id}", params, body, true)
+        rescue Exception => e
+          suppress_error_if_silent e
+        end
+      end
+
+      def get_dashboard(dash_id)
+        begin
+          params = {
+            :api_key => @api_key,
+            :application_key => @application_key
+          }
+
+          request(Net::HTTP::Get, "/api/#{API_VERSION}/dash/#{dash_id}", params, nil, false)
+        rescue Exception => e
+          suppress_error_if_silent e
+        end
+      end
+
+      def get_dashboards
+        begin
+          params = {
+            :api_key => @api_key,
+            :application_key => @application_key
+          }
+
+          request(Net::HTTP::Get, "/api/#{API_VERSION}/dash", params, nil, false)
+        rescue Exception => e
+          suppress_error_if_silent e
+        end
+      end
+
+      def delete_dashboard(dash_id)
+        begin
+          params = {
+            :api_key => @api_key,
+            :application_key => @application_key
+          }
+
+          request(Net::HTTP::Delete, "/api/#{API_VERSION}/dash/#{dash_id}", params, nil, false)
+        rescue Exception => e
+          suppress_error_if_silent e
+        end
+      end
+
+    end
+
+  end
+end

data/lib/dogapi-demo/v1/embed.rb

@@ -0,0 +1,106 @@
+require 'dogapi-demo'
+
+module DogapiDemo
+  class V1 # for namespacing
+
+    # ================
+    #    EMBED API 
+    # ================
+    class EmbedService < DogapiDemo::APIService
+
+      API_VERSION = "v1"
+
+      # Get all embeds for the API user's org
+      def get_all_embeds()
+        begin
+          params = {
+            :api_key => @api_key,
+            :application_key => @application_key
+          }
+
+          request(Net::HTTP::Get, "/api/#{API_VERSION}/graph/embed", params, nil, false)
+        rescue Exception => e
+          suppress_error_if_silent e
+        end
+      end
+
+      # Get a specific embed
+      #
+      # :embed_id       => String: embed token for a specific embed
+      # :size           => String: "small", "medium"(defualt), "large", or "xlarge". 
+      # :legend         => String: "yes" or "no"(default)
+      # :template_vars  => String: variable name => variable value (any number of template vars)
+      def get_embed(embed_id, description= {})
+        begin
+          # Initialize parameters and merge with description
+          params = {
+            :api_key => @api_key,
+            :application_key => @application_key,
+          }.merge(description)
+
+          request(Net::HTTP::Get, "/api/#{API_VERSION}/graph/embed/#{embed_id}", params, nil, false)
+        rescue Exception => e
+          suppress_error_if_silent e
+        end
+      end
+
+      # Create an embeddable graph
+      #
+      # :graph_json  => JSON: graph definition
+      # :timeframe   => String: representing the interval of the graph. Default is "1_hour"
+      # :size        => String: representing the size of the graph. Default is "medium".
+      # :legend      => String: flag representing whether a legend is displayed. Default is "no".
+      # :title       => String: represents title of the graph. Default is "Embed created through API."
+      def create_embed(graph_json, description= {})
+        begin
+          params = {
+            :api_key => @api_key,
+            :application_key => @application_key
+          }
+
+          body = {
+            :graph_json => graph_json,
+          }.merge(description)
+
+          request(Net::HTTP::Post, "/api/#{API_VERSION}/graph/embed", params, body, true)
+        rescue Exception => e
+          suppress_error_if_silent e
+        end
+      end
+
+      # Enable a specific embed
+      #
+      # :embed_id  => String: embed token for a specific embed
+      def enable_embed(embed_id)
+        begin
+          params = {
+            :api_key => @api_key,
+            :application_key => @application_key
+          }
+
+          request(Net::HTTP::Get, "/api/#{API_VERSION}/graph/embed/#{embed_id}/enable", params, nil, false)
+        rescue Exception => e
+          suppress_error_if_silent e
+        end
+      end
+
+      # Revoke a specific embed
+      #
+      # :embed_id  => String: embed token for a specific embed
+      def revoke_embed(embed_id)
+        begin
+          params = {
+            :api_key => @api_key,
+            :application_key => @application_key
+          }
+
+          request(Net::HTTP::Get, "/api/#{API_VERSION}/graph/embed/#{embed_id}/revoke", params, nil, false)
+        rescue Exception => e
+          suppress_error_if_silent e
+        end
+      end
+
+    end
+
+  end
+end

data/lib/dogapi-demo/v1/event.rb

@@ -0,0 +1,101 @@
+require 'dogapi-demo'
+
+module DogapiDemo
+  class V1 # for namespacing
+
+    # Event-specific client affording more granular control than the simple DogapiDemo::Client
+    class EventService < DogapiDemo::APIService
+
+      API_VERSION = "v1"
+      MAX_BODY_LENGTH = 4000
+      MAX_TITLE_LENGTH = 100
+
+      # Records an Event with no duration
+      def post(event, scope=nil)
+        begin
+          scope = scope || DogapiDemo::Scope.new()
+          params = {
+            :api_key => @api_key
+          }
+
+          body = event.to_hash.merge({
+            :title => event.msg_title[0..MAX_TITLE_LENGTH - 1],
+            :text => event.msg_text[0..MAX_BODY_LENGTH - 1],
+            :date_happened => event.date_happened.to_i,
+            :host => scope.host,
+            :device => scope.device,
+            :aggregation_key => event.aggregation_key.to_s
+          })
+
+          request(Net::HTTP::Post, '/api/v1/events', params, body, true)
+        rescue Exception => e
+          if @silent
+            warn e
+            return -1, {}
+          else
+            raise e
+          end
+        end
+      end
+
+      def get(id)
+        begin
+          params = {
+            :api_key => @api_key,
+            :application_key => @application_key
+          }
+
+          request(Net::HTTP::Get, '/api/' + API_VERSION + '/events/' + id.to_s, params, nil, false)
+        rescue Exception => e
+          if @silent
+            warn e
+            return -1, {}
+          else
+            raise e
+          end
+        end
+      end
+
+      def stream(start, stop, options = {})
+        begin
+          defaults = {
+            :priority => nil,
+            :sources => nil,
+            :tags => nil
+          }
+          options = defaults.merge(options)
+
+          params = {
+            :api_key => @api_key,
+            :application_key => @application_key,
+
+            :start => start.to_i,
+            :end => stop.to_i
+          }
+
+          if options[:priority]
+            params[:priority] = options[:priority]
+          end
+          if options[:sources]
+            params[:sources] = options[:sources]
+          end
+          if options[:tags]
+            tags = options[:tags]
+            params[:tags] = tags.kind_of?(Array) ? tags.join(",") : tags
+          end
+
+          request(Net::HTTP::Get, '/api/' + API_VERSION + '/events', params, nil, false)
+        rescue Exception => e
+          if @silent
+            warn e
+            return -1, {}
+          else
+            raise e
+          end
+        end
+      end
+
+    end
+
+  end
+end