Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

A kestrel web ui

branch: master

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 html
Octocat-spinner-32 kestrelweb
Octocat-spinner-32 templates Don't show errors unless we have some
Octocat-spinner-32 .gitignore
Octocat-spinner-32 LICENSE
Octocat-spinner-32 README.mkd
Octocat-spinner-32 local_settings.py.example
Octocat-spinner-32 logging.conf
Octocat-spinner-32 requirement.txt
Octocat-spinner-32 setup.py
README.mkd

kestrelweb

A kestrel web ui.

Uses gunicorn + gevent for front end serving. Also uses gevent to make async requests to the kestrel servers for stats. It's still in early development so any suggestions or ideas are welcome.

https://github.com/matterkkila/kestrelweb

Dependencies:

  • decoroute >= 0.8.1
  • gevent >= 0.13.6
  • gunicorn >= 0.13.4
  • pykestrel >= 0.5.1
  • webob >= 1.2b2

Prerequisites

  • Python 2.7+
  • virtualenv (not really required, but it's a good idea)
  • libevent 1.4+ (for gevent)

Installing

git clone https://github.com/matterkkila/kestrelweb.git
cd kestrelweb
virtualenv --no-site-packages .
. bin/activate
pip install -r requirement.txt
python ./setup.py develop

Note: If libevent is installed in a non-standard location (I'm looking at you macports) you'll need to download the source distribution for gevent and install using something similar to:

pip install --no-install gevent  #download only
cd build/gevent
python ./setup.py install --libevent /opt/local

Configuring

Copy the local_settings.py.example to local_settings.py and edit the server list to reflect your queue servers.

cp local_settings.py.example local_settings.py

Running

gunicorn -k gevent -w 2 kestrelweb.main:App

Deploying

It's best to front gunicorn with something like nginx. It is also best to use nginx to serve the static files used by kestrelweb. Specifically anything in /static/* should be served by the proxy server.

Filtering

You can filter the queue list on any field/value. Strings only support the '=' and '!=' comparisons and use the re.match() function. Numeric types support <, >, <=, >=, !=, = and will do the standard numeric comparison.

Examples:

  • queue=my_queue
  • queue!=.*_prod$
  • server=10.0.10
  • total_items>=10
  • mem_items<=1024

Feedback & Questions

Any comments, questions, feel free to send me a message on github at https://github.com/matterkkila

All patches and pull requests are welcome.

Something went wrong with that request. Please try again.