Skip to main content

Outage Escalation Tool and Site Contact Info

Project description

whatsup is an outage escalation tool for a list of sites and contacts

Installing whatsup

whatsup is installable via easy_install or python in the usual way from the python source at The recommended installation procedure is with virtualenv:

python <(curl whatsup
cd whatsup
. bin/activate
mkdir src
cd src
svn co
cd whatsup
python develop

You will also need data files (.ini) for contacts and sites. By default these live in ${VIRTUAL_ENV}/src/whatsup/contacts and ${VIRTUAL_ENV}/src/whatsup/sites, though this is configurable.

Instantiating whatsup

whatsup is served by the paste .ini file:

paster serve whatsup.ini

Application options may be specified in this .ini file in the [app:whatsup] section prefixed with whatsup.:

  • contacts, sites: location of the contacts and sites files. can be a single file or a directory containing .ini files
  • auto_reload: whether to reload the configuration on each request
  • ping: whether to ping the sites
  • ping_frequency: how often, in seconds, to ping the sites
  • smtp_from: who to send email as if the user does not specified
  • smtp_server: mail server to use. If not specified, whatsup will not send email

whatsup contact .ini files

A contact .ini file contains one or more sections, each corresponding to a contact. The name of the section should be the name of the contact. Several data are specifiable for each contact:

  • email: comma separated list of email addresses.
  • phone: comma separated list of phone numbers
  • irc: comma separated list of IRC names
  • aim: AIM screenname
  • url: canonical web presence
  • contact: description of how to contact this person, or a filename containing that information

For each comma separated list, the first item is considered primary.

whatsup site .ini files

A site .ini file contains one or more sections, each corresponding to a website. By convention, the section name is the domain name of the site. Several data are specifiable for each site:

  • url: location of the site. If not specified, the url will be from the section name (presumedly the domain name)
  • contact: comma separated list of contacts in case of site outage
  • description: brief description of the website
  • outage_procedure: if specified, a description of what to do in case the site is down or a filename containing that information. By default, this links to the contact form which emails the contacts upon submission.
  • trac: URL of the associated Trac site

Project details

Release history Release notifications

This version
History Node


History Node


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
whatsup-0.1.1-py2.5.egg (55.5 kB) Copy SHA256 hash SHA256 Egg 2.5 Oct 29, 2009
whatsup-0.1.1.tar.gz (47.0 kB) Copy SHA256 hash SHA256 Source None Oct 29, 2009

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page