Scout is an easy-to-use hosted server monitoring service. The scout Ruby gem reports metrics to our service. The agent runs plugins, configured via the Scout web interface, to monitor a server.
Ruby
Latest commit 78cf010 Jan 2, 2015 @composit composit update version
Failed to load latest commit information.
bin Removing = true to silence plugin warnings Apr 2, 2013
data
lib update version Jan 2, 2015
test support for realtime system metrics Mar 5, 2014
vendor
.gitignore
CHANGELOG.markdown
Gemfile update test dependencies Mar 3, 2014
LICENSE * renamed sspy to scout Oct 26, 2007
README.markdown updates for roles support. updated readme. Feb 5, 2013
Rakefile implemented realtime streaming Jan 6, 2012
scout.gemspec Add server_metrics version to debug log, require server_metrics 1.2.5 May 8, 2014

README.markdown

Scout Server Monitoring Agent

Scout is an easy-to-use hosted server monitoring service. The scout Ruby gem reports metrics to our service. The agent runs plugins, configured via the Scout web interface, to monitor a server. View a list of available plugins on our website and their source on Github.

Installing

Scout requires Ruby, and is installed via Ruby Gems:

$ gem install scout

First run from the command line:

$ scout KEY

KEY is the identification key assigned by your account at http://scoutapp.com. When run from the command line, scout should print "success." If not, run in verbose mode to see what the problem is:

$ scout KEY -v

Scout is normally run through cron

After you've successfully run Scout from the command line, you should configure it to run every minute via cron. This is how Scout is designed to run on an ongoing basis. Your contab will typically look like this:

* * * * *  deploy /usr/bin/scout KEY

... assuming you are using the global crontab, and "deploy" is the user running Scout.

For a full list of options:

$ scout --help

Troubleshooting

The scout troubleshoot command provides useful troubleshooting information (log of the last run, environment information, and the list of gems).

Extensive help is available via our website (http://scoutapp.com) and while installing the agent via the Scout web UI.

Local plugin testing:

$ scout [OPTIONS] test PATH_TO_PLUGIN [PLUGIN_OPTIONS]

PATH_TO_PLUGIN is the file system path to a Ruby file that contains a Scout plugin.

PLUGIN_OPTIONS are one or more options in the form:

key1=val1 key2=val2

These options will be used for the plugin run. Lean more about creating your own plugins.

Credits / Contact

Contact support@scoutapp.com with questions.

Primary maintainers: Andre Lewis (andre@scoutapp.com) and Derek Haynes (derek@scoutapp.com)

Many thanks to James Edward Gray II, Charles Brian Quinn, and Matt Todd for early work on the Scout agent!