aws-sdk-cloudwatch 0.0.4

data/lib/aws/cloud_watch.rb

@@ -0,0 +1,31 @@
+# Copyright 2012 Inscitiv
+# 
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+# 
+#     http://www.apache.org/licenses/LICENSE-2.0
+# 
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require 'aws/core'
+require 'aws/cloud_watch/config'
+
+module AWS
+  class CloudWatch
+    AWS::register_autoloads(self, 'aws/cloud_watch') do
+      autoload :Client, 'client'
+      autoload :Errors, 'errors'
+      autoload :Metric, 'metric'
+      autoload :MetricBase, 'metric_base'
+      autoload :MetricCollection, 'metric_collection'
+      autoload :Request, 'request'
+    end
+
+    include Core::ServiceInterface
+  end
+end

data/lib/aws/cloud_watch/client.rb

@@ -0,0 +1,56 @@
+# Copyright 2012 Inscitiv
+# 
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+# 
+#     http://www.apache.org/licenses/LICENSE-2.0
+# 
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require 'aws/core'
+require 'aws/core/option_grammar/double'
+require 'yaml'
+
+module AWS
+  class CloudWatch
+    
+    class Client < Core::Client
+      
+      # this is copied from 'aws/core/client'; it's needed,
+      # otherwise it searches in the original gem directory
+      def self.api_config
+        config_file = 
+          File.dirname(File.dirname(__FILE__)) + 
+          "/api_config/#{service_name}-#{self::API_VERSION}.yml"
+        YAML.load(File.read(config_file))
+      end
+      
+      API_VERSION = '2010-08-01'
+      
+      extend Core::Client::QueryXML
+      
+      CACHEABLE_REQUESTS = Set[
+        # TODO
+      ]
+      
+      define_client_method :delete_alarms, 'DeleteAlarms'
+      define_client_method :describe_alarm_history, 'DescribeAlarmHistory'
+      define_client_method :describe_alarms, 'DescribeAlarms'
+      define_client_method :describe_alarms_for_metric, 'DescribeAlarmsForMetric'
+      define_client_method :disable_alarm_actions, 'DisableAlarmActions'
+      define_client_method :enable_alarm_actions, 'EnableAlarmActions'
+      define_client_method :get_metric_statistics, 'GetMetricStatistics'
+      define_client_method :list_metrics, 'ListMetrics'
+      define_client_method :put_metric_alarm, 'PutMetricAlarm'
+      define_client_method :put_metric_data, 'PutMetricData'
+      define_client_method :set_alarm_state, 'SetAlarmState'
+    
+    end
+    
+  end
+end

data/lib/aws/cloud_watch/config.rb

@@ -0,0 +1,19 @@
+# Copyright 2012 Inscitiv
+# 
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+# 
+#     http://www.apache.org/licenses/LICENSE-2.0
+# 
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+AWS::Core::Configuration.module_eval do
+
+  add_service 'CloudWatch', 'cloud_watch', 'monitoring.us-east-1.amazonaws.com'
+
+end

data/lib/aws/cloud_watch/ec2.rb

@@ -0,0 +1,58 @@
+# Copyright 2012 Inscitiv
+# 
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+# 
+#     http://www.apache.org/licenses/LICENSE-2.0
+# 
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require 'aws/cloud_watch'
+require 'aws/ec2'
+
+module AWS
+  class CloudWatch
+    module EC2
+
+      def metrics
+        @metrics ||= MetricCollection.new :namespace => 'AWS/EC2', :instance_id => id, :config => config
+      end
+      
+      def cpu_utilization *args
+          metric = metrics['CPUUtilization']
+          if args.length == 0
+            metric
+          else
+            metric.average *args
+          end
+      end
+      
+      def method_missing name, *args
+        if [:disk_read_ops, :disk_write_ops, :network_out, :disk_read_bytes, :network_in, :disk_write_bytes].include?(name)
+          metric = metrics[name]
+          if args.length == 0
+            metric
+          else
+            metric.sum *args
+          end
+        else
+          super
+        end
+      end
+
+    end
+  end
+end
+
+require 'aws/ec2/resource'
+require 'aws/ec2/tagged_item'
+require 'aws/ec2/instance'
+
+AWS::EC2::Instance.class_eval do
+  include AWS::CloudWatch::EC2
+end

data/lib/aws/cloud_watch/errors.rb

@@ -0,0 +1,23 @@
+# Copyright 2012 Inscitiv
+# 
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+# 
+#     http://www.apache.org/licenses/LICENSE-2.0
+# 
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+module AWS
+  class CloudWatch
+    module Errors
+      
+      extend Core::LazyErrorClasses
+
+    end
+  end
+end

data/lib/aws/cloud_watch/metric.rb

@@ -0,0 +1,97 @@
+# Copyright 2012 Inscitiv
+# 
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+# 
+#     http://www.apache.org/licenses/LICENSE-2.0
+# 
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require 'aws/core/inflection'
+require 'time'
+
+module AWS
+  class CloudWatch
+    class Metric < MetricBase
+      
+      attr_accessor :unit
+
+      def options
+        super.merge(unit ? {:unit => unit} : {})
+      end
+      
+      def attr_names
+        super + [:unit]
+      end
+      
+      MAX_RECORDS = 1440
+      
+      def get statistics, period, range = Time.now, opts = {}
+        statistics = [statistics] unless statistics.kind_of? Array
+        unless range.kind_of? Range
+          range = (range - period)..range
+          single_point = true
+        else
+          single_point = false
+        end
+        single_point &&= statistics.length == 1
+        
+        def get_batch statistics, period, range, opts
+          options = self.options.merge({
+            :end_time => range.end.getutc.iso8601,
+            :start_time => range.begin.getutc.iso8601,
+            :period => period.to_i,
+            :statistics => statistics.map { |s| camel_case(s) } })
+          options[:unit] = camel_case(opts[:unit]) if opts[:unit]
+          return [] if options[:end_time] == options[:start_time]
+          
+          data = client.get_metric_statistics(options).datapoints
+        end
+        
+        if single_point
+          data = get_batch statistics, period, range, opts
+          
+          if data.length == 0
+            return nil
+          else
+            return data[0][statistics[0]]
+          end
+        end
+        
+        return [] if range.begin + period > range.end
+
+        max_period = MAX_RECORDS * period / statistics.length
+        
+        ranges = [range]
+        while (ranges[-1].end - ranges[-1].begin) > max_period
+          range = ranges.pop
+          pivot = range.begin + max_period
+          ranges.push range.begin..pivot
+          ranges.push pivot..range.end
+        end
+        
+        ranges.map{|range| get_batch statistics, period, range, opts}.flatten.sort{|a, b| a[:timestamp] <=> b[:timestamp]}
+      end
+      
+      def method_missing name, *args
+        if [:average, :sum, :sample_count, :maximum, :minimum].include?(name)
+          data = get name, *args
+          if data.kind_of? Array
+            data.each do |point|
+              point[:value] = point[name]
+            end
+          end
+          data
+        else
+          super
+        end
+      end
+      
+    end
+  end
+end

data/lib/aws/cloud_watch/metric_base.rb

@@ -0,0 +1,100 @@
+# Copyright 2012 Inscitiv
+# 
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+# 
+#     http://www.apache.org/licenses/LICENSE-2.0
+# 
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require 'aws/core/inflection'
+
+module AWS
+  class CloudWatch
+    
+    # @private
+    class MetricBase
+      include Core::Model
+      
+      def initialize options
+        super
+        @dimensions = {}
+        set_attributes options
+      end
+      
+      def set_attributes attrs
+        attrs.keys.each do |k|
+          key = k
+          key = :name if key == :metric_name
+          if key.kind_of? Symbol
+            send("#{key}=", attrs[k]) unless key == :config
+          else
+            dimensions[key] = attrs[k]
+          end
+        end
+      end
+      
+      attr_accessor :name, :namespace
+      attr_reader :dimensions
+      
+      def dimensions= value
+        if value.kind_of? Array
+          hash = {}
+          value.each do |entry|
+            hash[entry[:name]] = entry[:value]
+          end
+          value = hash
+        end
+        
+        @dimensions = value
+      end
+      
+      def attr_names
+        [:dimensions, :name, :namespace]
+      end
+      
+      def method_missing name, *args
+        if args.length == 1 && name.to_s =~ /^(.*)=/ then
+          @dimensions[$1.to_sym] = args[0]
+        else
+          super
+        end
+      end
+      
+      def options
+        opts = !dimensions.empty? ? {:dimensions => 
+              dimensions.keys.map {|key|
+              { :name => camel_case(key),
+                :value => dimensions[key] }}
+          } : {}
+
+        opts[:metric_name] = name if name
+        opts[:namespace] = namespace if namespace
+        opts
+      end
+
+      def camel_case s
+        Core::Inflection.class_name s.to_s
+      end
+
+      def to_sym s
+        Core::Inflection.ruby_name(s.to_s).to_sym
+      end
+
+      def inspect
+        attrs = []
+        attr_names.each do |attr|
+          val = self.send attr
+          attrs << "#{attr}:#{val.inspect}" if val
+        end
+        
+        "<#{self::class} #{attrs.join ' '}>"
+      end
+    end
+  end
+end

data/lib/aws/cloud_watch/metric_collection.rb

@@ -0,0 +1,48 @@
+# Copyright 2012 Inscitiv
+# 
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+# 
+#     http://www.apache.org/licenses/LICENSE-2.0
+# 
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+module AWS
+  class CloudWatch
+    class MetricCollection < MetricBase
+      
+      include Enumerable
+      
+      def each &block
+
+        next_token = nil
+
+        begin
+          
+          list_options = options.merge(next_token ? { :next_token => next_token } : {})
+          response = client.list_metrics(list_options)
+
+          response.metrics.each do |t|
+            metric = Metric.new(t.merge :config => config)
+            yield(metric)
+          end
+
+        end while(next_token = response.data[:next_token])
+        nil
+
+      end
+      
+      def get_by_name name
+        Metric.new(options.merge(:name => camel_case(name), :config => config))
+      end
+      
+      alias_method :[], :get_by_name
+      
+    end
+  end
+end

data/lib/aws/cloud_watch/request.rb

@@ -0,0 +1,30 @@
+# Copyright 2012 Inscitiv
+# 
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+# 
+#     http://www.apache.org/licenses/LICENSE-2.0
+# 
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+module AWS
+  class CloudWatch
+    
+    # @private
+    class Request < Core::Http::Request
+      
+      include Core::Signature::Version4
+      
+      def service
+        'monitoring'
+      end
+      
+    end
+    
+  end
+end