Skip to content
A library for interacting with Scout (, a hosted server monitoring service. Query for metric data, manage servers, and more.
Find file
New pull request
#5 Compare This branch is 48 commits ahead of itsderek23:master.
Latest commit 6c0aaef Andre Lewis group queries are not supported in the scout API



A library for interacting with Scout, a hosted server monitoring service. Query for metric data, manage servers, and more.

Getting Started

Install the gem if you haven't already:

gem install scout_api

Require the gem and authenticate to get your Scout on (the example uses as the account URL):

require 'scout_api'
scout ='youraccountname', '', 'sekret')


You can query for the following high-level objects:

  • {Scout::Server}

  • {Scout::Metric}

Each of the classes have Rails-like finder methods. For example:

# all servers

# first server

# first metric with ID=1


Access your metric data stored in Scout. You can retrieve data for a specific metric or aggregated metrics. For example:

# average value of the metric with ID=1 over the past hour

# maximum rate of insert queries over the previous 24 hours
Scout::Server.first(:name => "DB Server").metrics.maximum(:name => 'inserts', 
:start =>*3600)*2,:end =>*3600) )

Server Management

Create and delete servers:

# create a server using the server with id=6 as the template.
Scout::Server.create('heavy metal',:id => 6) => <#Scout::Server>

# delete the server with id=10

Ruby Compatibility

scout_api has been tested against Ruby 1.8.7, and Ruby 1.9.2.

Note on Patches/Pull Requests

  • Fork the project.

  • Make your feature addition or bug fix.

  • Add tests for it. This is important so I don't break it in a future version unintentionally.

  • Commit, do not mess with rakefile, version, or history. (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)

  • Send me a pull request. Bonus points for topic branches.


Copyright © 2011 Jesse Newland, Derek Haynes. See LICENSE for details.

Something went wrong with that request. Please try again.