Add stat service

lib/esp.rb

@@ -89,4 +89,5 @@ class Suppression
   autoload :StatCustomSignature, File.expand_path(File.dirname(__FILE__) + '/esp/resources/stat_custom_signature')
   autoload :StatSignature, File.expand_path(File.dirname(__FILE__) + '/esp/resources/stat_signature')
   autoload :StatRegion, File.expand_path(File.dirname(__FILE__) + '/esp/resources/stat_region')
+  autoload :StatService, File.expand_path(File.dirname(__FILE__) + '/esp/resources/stat_service')
 end

lib/esp/resources/stat.rb

@@ -10,6 +10,10 @@ class Stat < ESP::Resource
     # The stats for each region associated with this stat object.
     has_many :regions, class_name: 'ESP::StatRegion'
 
+    ##
+    # The stats for each service associated with this stat object.
+    has_many :services, class_name: 'ESP::StatService'
+
     ##
     # The stats for each signature associated with this stat object.
     has_many :signatures, class_name: 'ESP::StatSignature'

lib/esp/resources/stat_service.rb

@@ -0,0 +1,121 @@
+module ESP
+  class StatService < ESP::Resource
+    include ESP::StatTotals
+
+    # The service these stats are for.
+    belongs_to :service, class_name: 'ESP::Service'
+
+    # Returns a paginated collection of service stats for the given stat_id
+    # Convenience method to use instead of ::find since a stat_id is required to return service stats.
+    #
+    # ==== Parameter
+    #
+    # +stat_id+ | Required | The ID of the stat to list service stats for
+    #
+    # ==== Example
+    #   stats = ESP::StatService.for_stat(1194)
+    def self.for_stat(stat_id = nil)
+      fail ArgumentError, "You must supply a stat id." unless stat_id.present?
+      from = "#{prefix}stats/#{stat_id}/services.json"
+      find(:all, from: from)
+    end
+
+    # Find a StatService by id
+    #
+    # ==== Parameter
+    #
+    # +id+ | Required | The ID of the service stat to retrieve
+    #
+    # :call-seq:
+    #  find(id)
+    def self.find(*arguments)
+      scope = arguments.slice!(0)
+      options = (arguments.slice!(0) || {}).with_indifferent_access
+      return super(scope, options) if scope.is_a?(Numeric) || options[:from].present?
+      params = options.fetch(:params, {}).with_indifferent_access
+      stat_id = params.delete(:stat_id)
+      for_stat(stat_id)
+    end
+
+    # :singleton-method: create
+    # Not Implemented. You cannot create a Stat.
+
+    # :method: save
+    # Not Implemented. You cannot create or update a Stat.
+
+    # :method: destroy
+    # Not Implemented. You cannot delete a Stat.
+
+    # :section: 'total' rollup methods
+
+    # :method: total
+
+    # :method: total_pass
+
+    # :method: total_fail
+
+    # :method: total_warn
+
+    # :method: total_error
+
+    # :method: total_info
+
+    # :method: total_new_1h_pass
+
+    # :method: total_new_1h_fail
+
+    # :method: total_new_1h_warn
+
+    # :method: total_new_1h_error
+
+    # :method: total_new_1h_info
+
+    # :method: total_new_1d_pass
+
+    # :method: total_new_1d_fail
+
+    # :method: total_new_1d_warn
+
+    # :method: total_new_1d_error
+
+    # :method: total_new_1d_info
+
+    # :method: total_new_1w_pass
+
+    # :method: total_new_1w_fail
+
+    # :method: total_new_1w_error
+
+    # :method: total_new_1w_info
+
+    # :method: total_new_1w_warn
+
+    # :method: total_old_fail
+
+    # :method: total_old_pass
+
+    # :method: total_old_warn
+
+    # :method: total_old_error
+
+    # :method: total_old_info
+
+    # :method: total_suppressed
+
+    # :method: total_suppressed_pass
+
+    # :method: total_suppressed_fail
+
+    # :method: total_suppressed_warn
+
+    # :method: total_suppressed_error
+
+    # :method: total_new_1h
+
+    # :method: total_new_1d
+
+    # :method: total_new_1w
+
+    # :method: total_old
+  end
+end

rdoc/ActiveResource.html

@@ -120,6 +120,8 @@ <h3 class="section-header">Class and Module Index</h3>
 
     <li><a href="./ESP/StatRegion.html">ESP::StatRegion</a>
 
+    <li><a href="./ESP/StatService.html">ESP::StatService</a>
+
     <li><a href="./ESP/StatSignature.html">ESP::StatSignature</a>
 
     <li><a href="./ESP/SubOrganization.html">ESP::SubOrganization</a>

rdoc/ActiveResource/Formats.html

@@ -116,6 +116,8 @@ <h3 class="section-header">Class and Module Index</h3>
 
     <li><a href="../ESP/StatRegion.html">ESP::StatRegion</a>
 
+    <li><a href="../ESP/StatService.html">ESP::StatService</a>
+
     <li><a href="../ESP/StatSignature.html">ESP::StatSignature</a>
 
     <li><a href="../ESP/SubOrganization.html">ESP::SubOrganization</a>

rdoc/ActiveResource/PaginatedCollection.html

@@ -164,6 +164,8 @@ <h3 class="section-header">Class and Module Index</h3>
 
     <li><a href="../ESP/StatRegion.html">ESP::StatRegion</a>
 
+    <li><a href="../ESP/StatService.html">ESP::StatService</a>
+
     <li><a href="../ESP/StatSignature.html">ESP::StatSignature</a>
 
     <li><a href="../ESP/SubOrganization.html">ESP::SubOrganization</a>

rdoc/ESP.html

@@ -66,6 +66,7 @@ <h3 class="section-header">Defined In</h3>
     <li>lib/esp/resources/stat.rb
     <li>lib/esp/resources/stat_custom_signature.rb
     <li>lib/esp/resources/stat_region.rb
+    <li>lib/esp/resources/stat_service.rb
     <li>lib/esp/resources/stat_signature.rb
     <li>lib/esp/resources/sub_organization.rb
     <li>lib/esp/resources/suppression.rb
@@ -165,6 +166,8 @@ <h3 class="section-header">Class and Module Index</h3>
 
     <li><a href="./ESP/StatRegion.html">ESP::StatRegion</a>
 
+    <li><a href="./ESP/StatService.html">ESP::StatService</a>
+
     <li><a href="./ESP/StatSignature.html">ESP::StatSignature</a>
 
     <li><a href="./ESP/SubOrganization.html">ESP::SubOrganization</a>

rdoc/ESP/Alert.html

@@ -158,6 +158,8 @@ <h3 class="section-header">Class and Module Index</h3>
 
     <li><a href="../ESP/StatRegion.html">ESP::StatRegion</a>
 
+    <li><a href="../ESP/StatService.html">ESP::StatService</a>
+
     <li><a href="../ESP/StatSignature.html">ESP::StatSignature</a>
 
     <li><a href="../ESP/SubOrganization.html">ESP::SubOrganization</a>

rdoc/ESP/CloudTrailEvent.html

@@ -138,6 +138,8 @@ <h3 class="section-header">Class and Module Index</h3>
 
     <li><a href="../ESP/StatRegion.html">ESP::StatRegion</a>
 
+    <li><a href="../ESP/StatService.html">ESP::StatService</a>
+
     <li><a href="../ESP/StatSignature.html">ESP::StatSignature</a>
 
     <li><a href="../ESP/SubOrganization.html">ESP::SubOrganization</a>

rdoc/ESP/ContactRequest.html

@@ -138,6 +138,8 @@ <h3 class="section-header">Class and Module Index</h3>
 
     <li><a href="../ESP/StatRegion.html">ESP::StatRegion</a>
 
+    <li><a href="../ESP/StatService.html">ESP::StatService</a>
+
     <li><a href="../ESP/StatSignature.html">ESP::StatSignature</a>
 
     <li><a href="../ESP/SubOrganization.html">ESP::SubOrganization</a>

rdoc/ESP/CustomSignature.html

@@ -150,6 +150,8 @@ <h3 class="section-header">Class and Module Index</h3>
 
     <li><a href="../ESP/StatRegion.html">ESP::StatRegion</a>
 
+    <li><a href="../ESP/StatService.html">ESP::StatService</a>
+
     <li><a href="../ESP/StatSignature.html">ESP::StatSignature</a>
 
     <li><a href="../ESP/SubOrganization.html">ESP::SubOrganization</a>

rdoc/ESP/Dashboard.html

@@ -138,6 +138,8 @@ <h3 class="section-header">Class and Module Index</h3>
 
     <li><a href="../ESP/StatRegion.html">ESP::StatRegion</a>
 
+    <li><a href="../ESP/StatService.html">ESP::StatService</a>
+
     <li><a href="../ESP/StatSignature.html">ESP::StatSignature</a>
 
     <li><a href="../ESP/SubOrganization.html">ESP::SubOrganization</a>

rdoc/ESP/ExternalAccount.html

@@ -148,6 +148,8 @@ <h3 class="section-header">Class and Module Index</h3>
 
     <li><a href="../ESP/StatRegion.html">ESP::StatRegion</a>
 
+    <li><a href="../ESP/StatService.html">ESP::StatService</a>
+
     <li><a href="../ESP/StatSignature.html">ESP::StatSignature</a>
 
     <li><a href="../ESP/SubOrganization.html">ESP::SubOrganization</a>

rdoc/ESP/Organization.html

@@ -152,6 +152,8 @@ <h3 class="section-header">Class and Module Index</h3>
 
     <li><a href="../ESP/StatRegion.html">ESP::StatRegion</a>
 
+    <li><a href="../ESP/StatService.html">ESP::StatService</a>
+
     <li><a href="../ESP/StatSignature.html">ESP::StatSignature</a>
 
     <li><a href="../ESP/SubOrganization.html">ESP::SubOrganization</a>

rdoc/ESP/Region.html

@@ -140,6 +140,8 @@ <h3 class="section-header">Class and Module Index</h3>
 
     <li><a href="../ESP/StatRegion.html">ESP::StatRegion</a>
 
+    <li><a href="../ESP/StatService.html">ESP::StatService</a>
+
     <li><a href="../ESP/StatSignature.html">ESP::StatSignature</a>
 
     <li><a href="../ESP/SubOrganization.html">ESP::SubOrganization</a>

rdoc/ESP/Report.html

@@ -150,6 +150,8 @@ <h3 class="section-header">Class and Module Index</h3>
 
     <li><a href="../ESP/StatRegion.html">ESP::StatRegion</a>
 
+    <li><a href="../ESP/StatService.html">ESP::StatService</a>
+
     <li><a href="../ESP/StatSignature.html">ESP::StatSignature</a>
 
     <li><a href="../ESP/SubOrganization.html">ESP::SubOrganization</a>

rdoc/ESP/Service.html

@@ -140,6 +140,8 @@ <h3 class="section-header">Class and Module Index</h3>
 
     <li><a href="../ESP/StatRegion.html">ESP::StatRegion</a>
 
+    <li><a href="../ESP/StatService.html">ESP::StatService</a>
+
     <li><a href="../ESP/StatSignature.html">ESP::StatSignature</a>
 
     <li><a href="../ESP/SubOrganization.html">ESP::SubOrganization</a>

rdoc/ESP/Signature.html

@@ -146,6 +146,8 @@ <h3 class="section-header">Class and Module Index</h3>
 
     <li><a href="../ESP/StatRegion.html">ESP::StatRegion</a>
 
+    <li><a href="../ESP/StatService.html">ESP::StatService</a>
+
     <li><a href="../ESP/StatSignature.html">ESP::StatSignature</a>
 
     <li><a href="../ESP/SubOrganization.html">ESP::SubOrganization</a>