Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Scout is a simple web monitoring and reporting client. It can connect to a plugin server, download plugins (written in Ruby) and run them on at specified intervals.
Ruby
Branch: master
Pull request Compare This branch is 218 commits behind scoutapp:master.

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
bin
data
lib
test
vendor/json_pure
.gitignore
AUTHORS
CHANGELOG
COPYING
INSTALL
LICENSE
README
Rakefile
TODO

README

= ReadMe

Scout by Highgroove Studios

== Description

The easier way to monitor servers and web applications.

Scout makes monitoring and reporting on your web applications
as flexible and simple as possible.

Scout is a product of Highgroove Studios.
Please visit http://scoutapp.com for more information.

== Installing

Install the Scout gem:

  $ sudo gem install scout

Then simply run:

  $ scout

to run the installation wizard.  You'll need your server key to continue. Get the server key from your account at http://scoutapp.com

== Running the Scout Client

The Scout client has several modes of operation and commands.  The normal, intended usage is through a scheduled interval with no output.

Normal checkin with server:
  $ scout [OPTIONS] SERVER_KEY
  ... OR ...
  $ scout [OPTIONS] run SERVER_KEY

Install:
  $ scout
  ... OR ...
  $ scout [OPTIONS] install

Local plugin testing:
  $ scout [OPTIONS] test PATH_TO_PLUGIN [PLUGIN_OPTIONS]


SERVER_KEY is the identification key assigned by your account at http://scoutapp.com

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.


== Setting up in cron

Configure Scout to run every minute. Typically, this will look like:

  * * * * *  deploy /usr/bin/scout SERVER_KEY

It's often helpful to log the output to a file. To do so:

  * * * * *  deploy /usr/bin/scout SERVER_KEY > /path/to/anywhere/scout.out 2>&1


For additional help, please visit http://scoutapp.com
Something went wrong with that request. Please try again.