dogapi 1.4.3 → 1.5.0

data/README.rdoc

@@ -1,9 +1,13 @@
-= Ruby client for Datadog API v1.4.3
+= Ruby client for Datadog API v1.5.0
 
 The Ruby client is a library suitable for inclusion in existing Ruby projects or for development of standalone scripts. It provides an abstraction on top of Datadog's raw HTTP interface for reporting events and metrics.
 
 = What's new?
 
+== v1.5.0
+
+* Alerting API
+
 == v1.4.3
 
 * Fix bug with capistrano integration for capistrano 2.13.5 (thanks @ansel1)

data/lib/dogapi/facade.rb

@@ -32,6 +32,7 @@ module Dogapi
       @comment_svc = Dogapi::V1::CommentService.new(@api_key, @application_key, silent)
       @search_svc = Dogapi::V1::SearchService.new(@api_key, @application_key, silent)
       @dash_service = Dogapi::V1::DashService.new(@api_key, @application_key, silent)
+      @alert_svc = Dogapi::V1::AlertService.new(@api_key, @application_key, silent)
 
       @legacy_event_svc = Dogapi::EventService.new(@datadog_host)
     end
@@ -240,6 +241,38 @@ module Dogapi
       @dash_service.delete_dashboard(dash_id)
     end
 
+    #
+    # ALERTS
+    #
+
+    def alert(query, options={})
+      @alert_svc.alert(query, options)
+    end
+
+    def update_alert(alert_id, query, options={})
+      @alert_svc.update_alert(alert_id, query, options)
+    end
+
+    def get_alert(alert_id)
+      @alert_svc.get_alert(alert_id)
+    end
+
+    def delete_alert(alert_id)
+      @alert_svc.delete_alert(alert_id)
+    end
+
+    def get_all_alerts()
+      @alert_svc.get_all_alerts()
+    end
+
+    def mute_alerts()
+      @alert_svc.mute_alerts()
+    end
+
+    def unmute_alerts()
+      @alert_svc.unmute_alerts()
+    end
+
     private
 
     def override_scope(host, device)

data/lib/dogapi/v1.rb

@@ -4,3 +4,4 @@ require 'dogapi/v1/tag'
 require 'dogapi/v1/comment'
 require 'dogapi/v1/search'
 require 'dogapi/v1/dash'
+require 'dogapi/v1/alert'

data/lib/dogapi/v1/alert.rb

@@ -0,0 +1,112 @@
+require 'dogapi'
+
+module Dogapi
+  class V1 # for namespacing
+
+    class AlertService < Dogapi::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/tests/test_alerts.rb

@@ -0,0 +1,38 @@
+require 'dogapi'
+require 'time'
+require 'test_base.rb'
+
+class TestAlerts < Test::Unit::TestCase
+  include TestBase
+
+  def test_alerts
+    dog = Dogapi::Client.new(@api_key, @app_key)
+
+    query = 'sum(last_1d):sum:system.net.bytes_rcvd{host:host0} > 100'
+
+    alert_id = dog.alert(query)[1]['id']
+    status, alert = dog.get_alert(alert_id)
+    assert_equal alert['query'], query, alert['query']
+    assert_equal alert['silenced'], false, alert['silenced']
+
+    dog.update_alert(alert_id, query, :silenced => true)
+    status, alert = dog.get_alert(alert_id)
+    assert_equal alert['query'], query, alert['query']
+    assert_equal alert['silenced'], true, alert['silenced']
+
+    dog.delete_alert(alert_id)
+
+    query1 = 'sum(last_1d):sum:system.net.bytes_rcvd{host:host0} > 100'
+    query2 = 'sum(last_1d):sum:system.net.bytes_rcvd{host:host0} > 200'
+
+    alert_id1 = dog.alert(query1)[1]['id']
+    alert_id2 = dog.alert(query2)[1]['id']
+    status, alerts = dog.get_all_alerts()
+    alerts = alerts['alerts']
+    alert1 = alerts.select {|a| a['id'] == alert_id1}
+    alert2 = alerts.select {|a| a['id'] == alert_id2}
+    assert_equal alert1[0]['query'], query1, alert1
+    assert_equal alert2[0]['query'], query2, alert2
+
+  end
+end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: dogapi
 version: !ruby/object:Gem::Version 
-  hash: 1
-  prerelease: 
+  prerelease: false
   segments: 
   - 1
-  - 4
-  - 3
-  version: 1.4.3
+  - 5
+  - 0
+  segments_generated: true
+  version: 1.5.0
 platform: ruby
 authors: 
 - Datadog, Inc.
@@ -15,24 +15,24 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2012-11-01 00:00:00 Z
+date: 2012-11-06 00:00:00 -05:00
+default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
+  prerelease: false
   name: json
-  requirement: &id001 !ruby/object:Gem::Requirement 
-    none: false
+  type: :runtime
+  version_requirements: &id001 !ruby/object:Gem::Requirement 
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        hash: 1
         segments: 
         - 1
         - 5
         - 1
+        segments_generated: true
         version: 1.5.1
-  version_requirements: *id001
-  prerelease: false
-  type: :runtime
+  requirement: *id001
 description: 
 email: packages@datadoghq.com
 executables: []
@@ -48,6 +48,7 @@ files:
 - lib/dogapi/event.rb
 - lib/dogapi/facade.rb
 - lib/dogapi/metric.rb
+- lib/dogapi/v1/alert.rb
 - lib/dogapi/v1/comment.rb
 - lib/dogapi/v1/dash.rb
 - lib/dogapi/v1/event.rb
@@ -56,12 +57,14 @@ files:
 - lib/dogapi/v1/tag.rb
 - lib/dogapi/v1.rb
 - lib/dogapi.rb
+- tests/test_alerts.rb
 - tests/test_base.rb
 - tests/test_client.rb
 - tests/test_comments.rb
 - tests/test_dashes.rb
 - tests/test_search.rb
 - README.rdoc
+has_rdoc: true
 homepage: http://datadoghq.com/
 licenses: 
 - BSD
@@ -76,27 +79,25 @@ rdoc_options:
 require_paths: 
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement 
-  none: false
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
-      hash: 3
       segments: 
       - 0
+      segments_generated: true
       version: "0"
 required_rubygems_version: !ruby/object:Gem::Requirement 
-  none: false
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
-      hash: 3
       segments: 
       - 0
+      segments_generated: true
       version: "0"
 requirements: []
 
 rubyforge_project: 
-rubygems_version: 1.8.24
+rubygems_version: 1.3.6
 signing_key: 
 specification_version: 3
 summary: Ruby bindings for Datadog's API