This app powers the Kloudless Status Dashboard.

To update the status, post a tweet of the format:

${SERVICE}-${STATUS}: ${COMMENT}

where SERVICE is one of {API,JS,DASH}, STATUS is one of {UP,DOWN,NOTICE}, and COMMENT is some free-form description.

Examples:

• API-DOWN: everything is on fire
• API-UP: it's back now
• JS-ISSUE: someone deleted the javascript
• DASH-DOWN: helpppp meeee

You can also post a info tweet that won't change the service's status. Just omit the dash and status, e.g.

• API: some generic notice that doesn't affect the status

1. Download the Google App Engine SDK (for Python)

2. Extract it somewhere (Linux) or run the installer (OS X).

3. From the root of this repo, run:

    dev_appserver.py --host 0.0.0.0 --admin_host 0.0.0.0 \
        --clear_datastore 1 situation/
   

   Note: dev_appserver.py is an executable that comes from the App Engine SDK. It might not be on your PATH, so adjust as necessary.

   This will launch the app at localhost:8080 and a mock appserver console at localhost:8000.

   If you want cron jobs to run (e.g. to fetch twitter messages or calculate uptime), you will need to trigger them manually from the appserver console (in development mode, they don't run automatically).

Changes you make to any file should take effect immediately. If you want to clear the datastores, just quit (^C) and re-start the app.

To deploy to Google App Engine, you need your Google Apps account to have "Developer" permissions to the app.

Instead of using password auth (which is complicated if you use 2FA), you should set up OAuth2 with the App Engine SDK.

From the root of this git repo, run

appcfg.py --oauth2 list_versions situation/

...to configure OAuth2. (list_versions is just a harmless command, rather than e.g. trying to deploy). It will launch a web browser and prompt you to grant permission.

(If you're using e.g. vagrant for development, it might do something crazy like try to launch lynx to authorize the token, which will fail since it doesn't support JavaScript. You can pass --noauth_local_webserver and follow the instructions instead.)

Deploying is really easy once OAuth2 is ready. From the root of this repo:

appcfg.py --oauth2 update situation/

You might see a bunch of warnings about mimetypes, but you can probably just ignore them?

Deploying takes ~15 seconds, and will update the live site immediately.

This app is a fork of the Balanced Payments status dashboard. Some info about their dashboard:

• Blog post about it
• Live status page
• GitHub repo

The main changes made in this fork are:

• Removed SMS features
• Minor HTML changes/improvements
• Remove integration with Graphite and Librato, instead calculate uptime by measure time between down/up tweets
• Remove Balanced Payments branding, add Kloudless branding

The deployed app is available at:

• status.kloudless.com
• kloudless-status-2.appspot.com