scout_api 0.9.0

data/lib/scout_api/metric_proxy.rb

@@ -0,0 +1,112 @@
+# This class works similar to Ruby on Rails' AssociationProxy, providing a nice interface to metrics
+# from owner objects in Scout (ex: Server, Group, Plugin).
+# See http://stackoverflow.com/questions/1529606/how-do-rails-association-methods-work for background
+# 
+# Example usage:
+# group.metrics => all metrics associated with the group
+# server.metrics.average('idle') => average value of all metrics w/name 'idle' associated with the server
+class Scout::MetricProxy
+  instance_methods.each { |m| undef_method m unless m =~ /(^__|^nil\?$|^send$|proxy_|^object_id$|is\_a\?)/ }
+  attr_reader :owner
+  
+  def initialize(owner) #:nodoc:
+    @owner = owner
+    @avg_calc = Scout::MetricCalculation.new(self,:AVG)
+    @min_calc = Scout::MetricCalculation.new(self,:MIN)
+    @max_calc = Scout::MetricCalculation.new(self,:MAX)
+  end
+  
+  # Calculate the average value of the metric w/<tt>:name => metric_name</tt> associated with the proxy owner (Group, Server, or Plugin).
+  #
+  # See Metric#average for options.
+  #
+  # @return [Hash]
+  def average(options)
+    @avg_calc.metric_name = metric_from_options(options)
+    @avg_calc.options = options
+    @avg_calc
+  end
+  alias avg average
+  
+  # Calculate the minimum value of the metric w/<tt>:name => metric_name</tt> associated with the proxy owner (Group, Server, or Plugin).
+  #
+  # See Metric#average for options.
+  #
+  # @return [Hash]
+  def minimum(options)
+    @min_calc.metric_name = metric_from_options(options)
+    @min_calc.options = options    
+    @min_calc
+  end
+  alias min minimum
+  
+  # Calculate the maximum value of the metric w/<tt>:name => metric_name</tt> associated with the proxy owner (Group, Server, or Plugin).
+  #
+  # See Metric#average for options.
+  #
+  # @return [Hash]
+  def maximum(options)
+    @max_calc.metric_name = metric_from_options(options)
+    @max_calc.options = options    
+    @max_calc
+  end
+  alias max maximum
+  
+  # Find all metrics w/ <tt>:name => metric_name</tt> associated with the proxy owner (Group, Server, or Plugin).
+  #
+  # Example:
+  #
+  # <tt>server.metrics.all(:name => 'request_rate')</tt> => returns all metrics on +server+ w/the name 'request_rate'.
+  #
+  # @return [Array] An array of [Scout::Metric] objects
+  def all(options = nil)
+    metric_name = options[:name] if options
+    Scout::Metric.all(
+      owner_key_value.merge!(:name => metric_name)
+    )
+  end
+  
+  def load_target #:nodoc:
+    @target = find_target
+  end
+  
+  def find_target #:nodoc:
+    if @owner.is_a?(Scout::Plugin) # plugin already has metric info
+      @owner.descriptor_hash.map { |d| Scout::Metric.new(d) }
+    else
+      Scout::Metric.all(owner_key_value)
+    end
+  end
+  
+  private
+  
+  # Ensures that a metric name is provided in the +options+ Hash. 
+  # If one isn't provided, a Scout::Error is raised.
+  #
+  # @return [String]
+  def metric_from_options(options)
+    metric_name = options[:name]
+    raise Scout::Error, "The name of the metric is required (:name => metric_name)" if metric_name.blank?
+    metric_name
+  end
+  
+  def owner_key_value
+   { (@owner.class.to_s.sub('Scout::','').downcase+'_ids').to_sym => @owner.id}
+  end
+  
+  def method_missing(method, *args)
+    if load_target
+      unless @target.respond_to?(method)
+        message = "undefined method `#{method.to_s}' for \"#{@target}\":#{@target.class.to_s}"
+        raise NoMethodError, message
+      end
+
+      if block_given?
+        @target.send(method, *args)  { |*block_args| yield(*block_args) }
+      else
+        @target.send(method, *args)
+      end
+    end
+  end
+  
+end

data/lib/scout_api/person.rb

@@ -0,0 +1,3 @@
+class Scout::Person < Hashie::Mash
+
+end

data/lib/scout_api/plugin.rb

@@ -0,0 +1,61 @@
+class Scout::Plugin < Hashie::Mash
+  attr_accessor :server
+  
+  # Retrieve metric information. See Scout::Metric#average for a list of options for the calculation
+  # methods (average, minimum, maximum).
+  # 
+  # Examples:
+  # 
+  # * <tt>Scout::Plugin.metrics => All metrics associated with this plugin.</tt>
+  # * <tt>Scout::Plugin.metrics.all(:name => 'mem_used') => Metrics with name =~ 'mem_used' on this plugin.</tt>
+  # * <tt>Scout::Plugin.metrics.average(:name => 'mem_used') => Average value of metrics with name =~ 'mem_used' on this plugin.</tt> 
+  # * <tt>Scout::Plugin.metrics.maximum(:name => 'mem_used')</tt>
+  # * <tt>Scout::Plugin.metrics.minimum(:name => 'mem_used')</tt>
+  # * <tt>Scout::Plugin.metrics.average(:name => 'request_rate', :aggregate => true) => Sum metrics, then take average</tt>
+  # * <tt>Scout::Plugin.metrics.average(:name => 'request_rate', :start => Time.now.utc-5*3600, :end => Time.now.utc-2*3600) => Retrieve data starting @ 5 hours ago ending at 2 hours ago</tt>
+  # * <tt>Scout::Plugin.metrics.average(:name => 'mem_used').to_array => An array of time series values over the past hour.</tt> 
+  # * <tt>Scout::Plugin.metrics.average(:name => 'mem_used').to_sparkline => A Url to a Google Sparkline Chart.</tt>
+  attr_reader :metrics
+  
+  attr_reader :descriptor_hash #:nodoc:
+
+  def initialize(hash) #:nodoc:
+    if hash['descriptors'] && hash['descriptors']['descriptor']
+      @descriptor_hash = hash['descriptors']['descriptor']
+      hash.delete('descriptors')
+    end
+    @metrics = Scout::MetricProxy.new(self)
+    super(hash)
+  end
+
+  def email_subscribers
+    response = Scout::Account.get("/clients/#{server.id}/email_subscribers?plugin_id=#{id}")
+    doc = Nokogiri::HTML(response.body)
+
+    table = doc.css('table.list').first
+    user_rows = table.css('tr')[1..-1] # skip first row, which is headings
+
+    user_rows.map do |row|
+      name_td, receiving_notifications_td = *row.css('td')
+
+      name = name_td.content.gsub(/[\t\n]/, '')
+      checked = receiving_notifications_td.css('input').attribute('checked')
+      receiving_notifications = checked && checked.value == 'checked'
+      Hashie::Mash.new :name => name, :receiving_notifications => receiving_notifications
+    end
+  end
+
+  def triggers
+    response = Scout::Account.get("/clients/#{server.id}/triggers.xml?plugin_id=#{id}")
+    response['triggers'].map { |trigger| decorate_with_server_and_plugin(Scout::Trigger.new(trigger)) }
+  end
+
+protected
+
+  def decorate_with_server_and_plugin(hashie) #:nodoc:
+    hashie.server = self.server
+    hashie.plugin = self
+    hashie
+  end
+
+end

data/lib/scout_api/server.rb

@@ -0,0 +1,165 @@
+class Scout::Server < Hashie::Mash
+  # Retrieve metric information. See Scout::Metric#average for a list of options for the calculation
+  # methods (average, minimum, maximum).
+  # 
+  # Examples:
+  # 
+  # * <tt>Scout::Server.metrics => All metrics associated with this server.</tt>
+  # * <tt>Scout::Server.metrics.all(:name => 'mem_used') => Metrics with name =~ 'mem_used' on this server.</tt>
+  # * <tt>Scout::Server.metrics.average(:name => 'mem_used') => Average value of metrics with name =~ 'mem_used' on this server.</tt> 
+  # * <tt>Scout::Server.metrics.maximum(:name => 'mem_used')</tt>
+  # * <tt>Scout::Server.metrics.minimum(:name => 'mem_used')</tt>
+  # * <tt>Scout::Server.metrics.average(:name => 'request_rate', :aggregate => true) => Sum metrics, then take average</tt>
+  # * <tt>Scout::Server.metrics.average(:name => 'request_rate', :start => Time.now.utc-5*3600, :end => Time.now.utc-2*3600) => Retrieve data starting @ 5 hours ago ending at 2 hours ago</tt>
+  # * <tt>Scout::Server.metrics.average(:name => 'mem_used').to_array => An array of time series values over the past hour.</tt> 
+  # * <tt>Scout::Server.metrics.average(:name => 'mem_used').to_sparkline => A Url to a Google Sparkline Chart.</tt>
+  attr_reader :metrics
+  
+  def initialize(hash) #:nodoc:
+    if hash['active_alerts']
+      @alert_hash = hash['active_alerts']
+      hash.delete('active_alerts')
+    end
+    @metrics = Scout::MetricProxy.new(self)
+    super(hash)
+  end
+
+  # Finds the first server that meets the given conditions. Possible parameter formats:
+  # 
+  # * <tt>Scout::Server.first</tt>
+  # * <tt>Scout::Server.first(1)</tt>
+  # * <tt>Scout::Server.first(:name => 'db slaves')</tt>
+  # * <tt>Scout::Server.first(:host => 'web*.geocities')</tt>
+  #
+  #
+  # For the <tt>:name</tt> and <tt>:host</tt> options, a {MySQL-formatted Regex}[http://dev.mysql.com/doc/refman/5.0/en/regexp.html] can be used.
+  # 
+  # @return [Scout::Server]
+  def self.first(id_or_options = nil)
+    if id_or_options.nil?
+      response = Scout::Account.get("/clients.xml?limit=1")
+      Scout::Server.new(response['clients'].first)
+    elsif id_or_options.is_a?(Hash)
+      if name=id_or_options[:name]
+        response = Scout::Account.get("/clients.xml?name=#{CGI.escape(name)}")
+        raise Scout::Error, 'Not Found' if response['clients'].nil?
+        Scout::Server.new(response['clients'].first)
+      elsif host=id_or_options[:host]
+        response = Scout::Account.get("/clients.xml?host=#{CGI.escape(host)}")
+        raise Scout::Error, 'Not Found' if response['clients'].nil?
+        Scout::Server.new(response['clients'].first)
+      else
+        raise Scout::Error, "Invalid finder condition"
+      end
+    elsif id_or_options.is_a?(Fixnum)
+      response = Scout::Account.get("/clients/#{id_or_options}.xml")
+      Scout::Server.new(response['client'])
+    elsif id_or_options.is_a?(String)
+      warn "Server#first(hostname) will be deprecated. Use Server#first(:host => hostname)"
+      response = Scout::Account.get("/clients.xml?host=#{CGI.escape(id_or_options)}")
+      raise Scout::Error, 'Not Found' if response['clients'].nil?
+      Scout::Server.new(response['clients'].first)
+    else
+      raise Scout::Error, "Invalid finder condition"
+    end
+  end
+  
+  # Finds all servers that meets the given conditions. Possible parameter formats:
+  # 
+  # * <tt>Scout::Server.all(:name => 'db slaves')</tt>
+  # * <tt>Scout::Server.all(:host => 'web*.geocities')</tt>
+  #
+  # For the <tt>:name</tt> and <tt>:host</tt> options, a {MySQL-formatted Regex}[http://dev.mysql.com/doc/refman/5.0/en/regexp.html] can be used.
+  # 
+  # @return [Array] An array of Scout::Server objects
+  def self.all(options = {})
+    if name=options[:name]
+      response = Scout::Account.get("/clients.xml?name=#{CGI.escape(name)}")
+    elsif host=options[:host]
+      response = Scout::Account.get("/clients.xml?host=#{CGI.escape(host)}")
+    elsif options.empty?
+      response = Scout::Account.get("/clients.xml")
+    else
+      raise Scout::Error, "Invalid finder condition"
+    end
+    response['clients'] ? response['clients'].map { |client| Scout::Server.new(client) } : Array.new
+  end
+  
+  # Creates a new server. If an error occurs, a [Scout::Error] is raised.
+  #
+  # An optional existing server id can be used as a template:
+  # <tt>Scout::Server.create('web server 12',:id => 99999)</tt>
+  #
+  # @return [Scout::Server]
+  def self.create(name,options = {})
+    id = options[:id]
+    response = Scout::Account.post("/#{Scout::Account.param}/clients.xml", 
+    :query => {:client => {:name => name, :copy_plugins_from_client_id => id}, :api_version => Scout::VERSION})
+    
+    raise Scout::Error, response['errors']['error'] if response['errors']
+    
+    first(response.headers['id'].first.to_i)
+  end
+  
+  # Delete a server by <tt>id</tt>. If an error occurs, a [Scout::Error] is raised.
+  #
+  # @return [true]
+  def self.delete(id)
+    response = Scout::Account.delete("/#{Scout::Account.param}/clients/#{id}.xml?api_version=#{Scout::VERSION}")
+
+    if response.headers['status'].first.match('404')
+      raise Scout::Error, "Server Not Found"
+    elsif !response.headers['status'].first.match('200')
+      raise Scout::Error, "An error occured"
+    else
+      return true
+    end
+  end
+
+  # Active alerts for this server
+  #
+  # @return [Array] An array of Scout::Alert objects
+  def active_alerts
+    @active_alerts ||= @alert_hash.map { |a| decorate_with_server(Scout::Alert.new(a)) }
+  end
+
+  # Recent alerts for this server
+  #
+  # @return [Array] An array of Scout::Alert objects
+  def alerts
+    response = Scout::Account.get("/clients/#{self.id}/activities.xml")
+    response['alerts'].map { |alert| decorate_with_server(Scout::Alert.new(alert)) }
+  end
+
+  # Details about all plugins for this server
+  #
+  # @return [Array] An array of Scout::Plugin objects
+  def plugins
+    response = Scout::Account.get("/clients/#{self.id}/plugins.xml")
+    response['plugins'].map { |plugin| decorate_with_server(Scout::Plugin.new(plugin)) }
+  end
+
+  # Details about a specific plugin
+  #
+  # @return [Scout::Plugin]
+  def plugin(id)
+    response = Scout::Account.get("/clients/#{self.id}/plugins/#{id}.xml")
+    decorate_with_server(Scout::Plugin.new(response['plugin']))
+  end
+
+  # Details about all triggers for this server
+  #
+  # @return [Array] An array of Scout::Trigger objects
+  def triggers
+    response = Scout::Account.get("/clients/#{self.id}/triggers.xml")
+    response['triggers'].map { |trigger| decorate_with_server(Scout::Trigger.new(trigger)) }
+  end
+
+protected
+
+  def decorate_with_server(hashie) #:nodoc:
+    hashie.server = self
+    hashie
+  end
+
+end

data/lib/scout_api/trigger.rb

@@ -0,0 +1,11 @@
+class Scout::Trigger < Hashie::Mash
+  attr_writer :server, :plugin
+  
+  def server
+    @server ||= Scout::Server.first(id)
+  end
+
+  def plugin
+    @plugin ||= server.plugin(plugin_id)
+  end
+end

data/lib/scout_api/version.rb

@@ -0,0 +1,3 @@
+module Scout
+  VERSION = '0.9.0'
+end

data/lib/scout_api.rb

@@ -0,0 +1,22 @@
+require 'rubygems'
+require 'hashie'
+require 'httparty'
+require 'nokogiri'
+require 'cgi'
+require 'scout_api/version'
+require 'scout_api/account'
+require 'scout_api/server'
+require 'scout_api/plugin'
+require 'scout_api/trigger'
+require 'scout_api/alert'
+require 'scout_api/group.rb'
+require 'scout_api/metric.rb'
+require 'scout_api/person'
+require 'scout_api/metric_proxy'
+require 'scout_api/metric_calculation'
+
+
+module Scout
+  class Error < RuntimeError
+  end
+end

data/scout_scout.gemspec

@@ -0,0 +1,86 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{scout_scout}
+  s.version = "0.0.6"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Jesse Newland"]
+  s.date = %q{2011-04-10}
+  s.description = %q{API wrapper for scout.com}
+  s.email = %q{jnewland@gmail.com}
+  s.extra_rdoc_files = [
+    "LICENSE",
+    "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+    "Gemfile",
+    "Gemfile.lock",
+    "LICENSE",
+    "README.rdoc",
+    "Rakefile",
+    "lib/scout_scout.rb",
+    "lib/scout_scout/alert.rb",
+    "lib/scout_scout/cluster.rb",
+    "lib/scout_scout/descriptor.rb",
+    "lib/scout_scout/metric.rb",
+    "lib/scout_scout/person.rb",
+    "lib/scout_scout/plugin.rb",
+    "lib/scout_scout/server.rb",
+    "lib/scout_scout/trigger.rb",
+    "lib/scout_scout/version.rb",
+    "scout_scout.gemspec",
+    "spec/fixtures/activities.xml",
+    "spec/fixtures/client.xml",
+    "spec/fixtures/client_by_hostname.xml",
+    "spec/fixtures/clients.xml",
+    "spec/fixtures/data.xml",
+    "spec/fixtures/descriptors.xml",
+    "spec/fixtures/plugin_data.xml",
+    "spec/fixtures/plugins.xml",
+    "spec/fixtures/triggers.xml",
+    "spec/scout_scout_spec.rb",
+    "spec/spec.opts",
+    "spec/spec_helper.rb"
+  ]
+  s.homepage = %q{http://github.com/jnewland/scout_scout}
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.4.2}
+  s.summary = %q{API wrapper for scout.com}
+  s.test_files = [
+    "spec/scout_scout_spec.rb",
+    "spec/spec_helper.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<hashie>, ["~> 0.1.8"])
+      s.add_runtime_dependency(%q<httparty>, ["~> 0.5.0"])
+      s.add_runtime_dependency(%q<nokogiri>, [">= 0"])
+      s.add_development_dependency(%q<rspec>, ["~> 1.3.0"])
+      s.add_development_dependency(%q<fakeweb>, [">= 0"])
+      s.add_development_dependency(%q<jeweler>, ["~> 1.5.0"])
+    else
+      s.add_dependency(%q<hashie>, ["~> 0.1.8"])
+      s.add_dependency(%q<httparty>, ["~> 0.5.0"])
+      s.add_dependency(%q<nokogiri>, [">= 0"])
+      s.add_dependency(%q<rspec>, ["~> 1.3.0"])
+      s.add_dependency(%q<fakeweb>, [">= 0"])
+      s.add_dependency(%q<jeweler>, ["~> 1.5.0"])
+    end
+  else
+    s.add_dependency(%q<hashie>, ["~> 0.1.8"])
+    s.add_dependency(%q<httparty>, ["~> 0.5.0"])
+    s.add_dependency(%q<nokogiri>, [">= 0"])
+    s.add_dependency(%q<rspec>, ["~> 1.3.0"])
+    s.add_dependency(%q<fakeweb>, [">= 0"])
+    s.add_dependency(%q<jeweler>, ["~> 1.5.0"])
+  end
+end
+

data/test/alert_test.rb

@@ -0,0 +1,20 @@
+require File.expand_path('../test_helper.rb', __FILE__)
+
+class AlertTest < Test::Unit::TestCase
+  def setup
+    @scout = Scout::Account.new('account', 'username', 'password')
+    @scout.stub_get('activities.xml')
+    @scout.stub_get('clients/24331.xml', 'client.xml')
+  end
+
+  def test_server
+    activities = @scout.alerts
+    assert activities.first.server.is_a?(Scout::Server)
+  end
+  
+  def test_plugin
+    @scout.stub_get('clients/13431/plugins/122761.xml', 'plugin_data.xml')
+    activities = @scout.alerts
+    assert activities.first.plugin.is_a?(Scout::Plugin)
+  end
+end

data/test/fixtures/activities.xml

@@ -0,0 +1,33 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<alerts type="array">
+  <alert>
+    <body nil="true"></body>
+    <client-id type="integer">24331</client-id>
+    <email-viewed-at type="datetime" nil="true"></email-viewed-at>
+    <id type="integer">35793021</id>
+    <last-repeated-at type="datetime">2010-01-21T20:30:00-05:00</last-repeated-at>
+    <needs-sms type="integer">0</needs-sms>
+    <num-repeats type="integer">1</num-repeats>
+    <plugin-id type="integer">122761</plugin-id>
+    <sms-sent-at type="datetime" nil="true"></sms-sent-at>
+    <stopped-repeating-at type="datetime" nil="true"></stopped-repeating-at>
+    <time type="datetime">2010-01-21T20:30:00-05:00</time>
+    <trigger-id type="integer">101821</trigger-id>
+    <title> Passenger Global Queue Depth met or exceeded 1 , increasing to 2 for 30 minutes at 08:30PM </title>
+  </alert>
+  <alert>
+    <body nil="true"></body>
+    <client-id type="integer">22301</client-id>
+    <email-viewed-at type="datetime" nil="true"></email-viewed-at>
+    <id type="integer">35793011</id>
+    <last-repeated-at type="datetime">2010-01-21T20:30:00-05:00</last-repeated-at>
+    <needs-sms type="integer">0</needs-sms>
+    <num-repeats type="integer">1</num-repeats>
+    <plugin-id type="integer">122731</plugin-id>
+    <sms-sent-at type="datetime" nil="true"></sms-sent-at>
+    <stopped-repeating-at type="datetime" nil="true"></stopped-repeating-at>
+    <time type="datetime">2010-01-21T20:30:00-05:00</time>
+    <trigger-id type="integer">101731</trigger-id>
+    <title> Passenger Global Queue Depth met or exceeded 1 , increasing to 1 for 30 minutes at 08:30PM </title>
+  </alert>
+</alerts>

data/test/fixtures/client.xml

@@ -0,0 +1,22 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<client>
+  <checkin-interval type="integer">3</checkin-interval>
+  <checkup-status>OK</checkup-status>
+  <external-id nil="true"></external-id>
+  <id type="integer">13431</id>
+  <key>FOOBAR</key>
+  <last-checkin type="datetime">2010-01-21T20:35:01-05:00</last-checkin>
+  <last-ping type="datetime">2010-01-21T20:35:00-05:00</last-ping>
+  <name>foobar</name>
+  <num-checkins type="integer">20785</num-checkins>
+  <partner-id type="integer" nil="true"></partner-id>
+  <plan-updated-at type="datetime">2010-01-19T08:59:32-05:00</plan-updated-at>
+  <second-to-last-checkin type="datetime">2010-01-21T20:32:01-05:00</second-to-last-checkin>
+  <second-to-last-ping type="datetime">2010-01-21T20:32:00-05:00</second-to-last-ping>
+  <send-checkup-email type="boolean" nil="true"></send-checkup-email>
+  <send-checkup-sms type="boolean" nil="true"></send-checkup-sms>
+  <take-snapshots type="boolean">false</take-snapshots>
+  <hostname>foobar.com</hostname>
+  <version>3.2.6</version>
+<active-alerts type="array"/>
+</client>

data/test/fixtures/client_by_hostname.xml

@@ -0,0 +1,23 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<clients type="array">
+  <client>
+    <checkin-interval type="integer">3</checkin-interval>
+    <checkup-status>OK</checkup-status>
+    <external-id nil="true"></external-id>
+    <id type="integer">13431</id>
+    <key>FOOBAR</key>
+    <last-checkin type="datetime">2010-01-21T20:35:01-05:00</last-checkin>
+    <last-ping type="datetime">2010-01-21T20:35:00-05:00</last-ping>
+    <name>foobar</name>
+    <num-checkins type="integer">20785</num-checkins>
+    <partner-id type="integer" nil="true"></partner-id>
+    <plan-updated-at type="datetime">2010-01-19T08:59:32-05:00</plan-updated-at>
+    <second-to-last-checkin type="datetime">2010-01-21T20:32:01-05:00</second-to-last-checkin>
+    <second-to-last-ping type="datetime">2010-01-21T20:32:00-05:00</second-to-last-ping>
+    <send-checkup-email type="boolean" nil="true"></send-checkup-email>
+    <send-checkup-sms type="boolean" nil="true"></send-checkup-sms>
+    <take-snapshots type="boolean">false</take-snapshots>
+    <version>3.2.6</version>
+<active-alerts type="array"/>
+  </client>
+</clients>

data/test/fixtures/clients.xml

@@ -0,0 +1,59 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<clients type="array">
+    <client>
+      <checkin-interval type="integer">3</checkin-interval>
+      <checkup-status>OK</checkup-status>
+      <external-id nil="true"></external-id>
+      <id type="integer">13431</id>
+      <key>FOOBAR</key>
+      <last-checkin type="datetime">2010-01-21T20:35:01-05:00</last-checkin>
+      <last-ping type="datetime">2010-01-21T20:35:00-05:00</last-ping>
+      <name>foobar</name>
+      <num-checkins type="integer">20785</num-checkins>
+      <partner-id type="integer" nil="true"></partner-id>
+      <plan-updated-at type="datetime">2010-01-19T08:59:32-05:00</plan-updated-at>
+      <second-to-last-checkin type="datetime">2010-01-21T20:32:01-05:00</second-to-last-checkin>
+      <second-to-last-ping type="datetime">2010-01-21T20:32:00-05:00</second-to-last-ping>
+      <send-checkup-email type="boolean" nil="true"></send-checkup-email>
+      <send-checkup-sms type="boolean" nil="true"></send-checkup-sms>
+      <take-snapshots type="boolean">false</take-snapshots>
+      <hostname>foobar.com</hostname>
+      <version>3.2.6</version>
+  <active-alerts type="array"/>
+    </client>
+    <client>
+      <checkin-interval type="integer">3</checkin-interval>
+      <checkup-status>Failure</checkup-status>
+      <external-id nil="true"></external-id>
+      <id type="integer">22751</id>
+      <key>FOO2</key>
+      <last-checkin type="datetime">2010-01-15T07:33:59-05:00</last-checkin>
+      <last-ping type="datetime">2010-01-15T07:33:52-05:00</last-ping>
+      <name>foo2</name>
+      <num-checkins type="integer">4801</num-checkins>
+      <partner-id type="integer" nil="true"></partner-id>
+      <plan-updated-at type="datetime">2010-01-19T08:59:32-05:00</plan-updated-at>
+      <second-to-last-checkin type="datetime">2010-01-05T05:33:14-05:00</second-to-last-checkin>
+      <second-to-last-ping type="datetime">2010-01-05T05:33:03-05:00</second-to-last-ping>
+      <send-checkup-email type="boolean" nil="true"></send-checkup-email>
+      <send-checkup-sms type="boolean" nil="true"></send-checkup-sms>
+      <take-snapshots type="boolean">false</take-snapshots>
+      <hostname>foo2.com</hostname>
+      <version>5.0.3</version>
+  <active-alerts type="array">
+      <alert>
+          <body nil="true"></body>
+          <email-viewed-at type="datetime" nil="true"></email-viewed-at>
+          <id type="integer">34555661</id>
+          <last-repeated-at type="datetime">2010-01-05T06:00:00-05:00</last-repeated-at>
+          <needs-sms type="integer">0</needs-sms>
+          <num-repeats type="integer">2</num-repeats>
+          <plugin-id type="integer">112001</plugin-id>
+          <sms-sent-at type="datetime" nil="true"></sms-sent-at>
+          <time type="datetime">2010-01-05T05:00:00-05:00</time>
+          <trigger-id type="integer">88111</trigger-id>
+          <title> Passenger private total increased 1,133 MB (200%) from 566 MB to 1,699 MB from 04:00AM-05:00AM relative to 03:00AM-04:00AM and is still continuing as of 06:00AM (16 days so far) </title>
+      </alert>
+  </active-alerts>
+    </client>
+</clients>

data/test/fixtures/data.xml

@@ -0,0 +1,5 @@
+<data>
+  <value>31.10</value>
+  <label>Cpu last minute</label>
+  <units></units>
+</data>