This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!

This app collects data from supervisor instances on one or multiple servers, stores and visualizes it.

Project Description
# djangovisor

This is a django project, which collects data from <a href="https://github.com/Supervisor/supervisor" target="_blank">supervisor</a> instances on one or multiple servers, stores it and plots it it using <a href="http://getbootstrap.com/" target="_blank">bootstrap</a> and the javascript library <a href="http://dygraphs.com/" target="_blank">dygraphs</a>. Example website: http://djangovisor.cfs-me-research.net/djangovisor/.

There is a very similar app for the server monitoring tool <a href="https://mmonit.com/monit/" target="_blank">monit</a> called <a href="https://github.com/nleng/django-monit-collector" target="_blank">django-monit-collector</a>.

### Features
- Collects supervisor data from one or multiple servers.
- Collects process cpu and memory usage and stores the data for a given time period.
- Displays it in pretty graphs.
- Start/stop/restart buttons for processes.
- Shows the tails of spuervisor and process specific logfiles.
- Status tables and graphs are refreshing automatically via ajax.
- Processes are automatically removed when they stop sending data (removed from supervisord.conf). Servers can be deleted manually.

### Installation

Just install it via pip:
```
pip install djangovisor
```
Or clone the repository if you want to modify the code:
```
git clone https://github.com/nleng/djangovisor
```

Add 'djangovisor' to your installed apps in settings.py:
```
INSTALLED_APPS = [
'djangovisor',
# ...
]
```
Include djangovisor in your url.py:
```
url(r'^djangovisor/', include('djangovisor.urls')),
```
On every server that should be monitored enable the xml web interface in your supervisord.conf:
```
[inet_http_server]
port=*:9001
username=yourname
password=yourpassword
```
If you use another port, you would have to change it in the sender.py script. Also, the port must not be blocked by the firewall, e.g.
```
ufw allow 9001
```
Since supervisor does not send process cpu and memory information, we use a script sender.py, which you have to copy to any server you want to observe.
You have to change the user and password in the script sender.py. Then the simplest solution is to just run a cronjob, e.g. every minute:
```
crontab -e
* * * * * /usr/bin/python /path/to/sender.py
```
You can also use the script sender_psutil.py if you prefer using the library psutil, which has to be installed.

If you want to you can change the default values in your settings.py:
```
# in seconds, should be the same as set in the crontab
UPDATE_PERIOD = 60
# maximum days to store data, only correct, if UPDATE_PERIOD is set correctly
MAXIMUM_STORE_DAYS = 7
```
Set up your webserver and run:
```
python manage.py collectstatic
python manage.py migrate
python manage.py createsuperuser
```

### License
BSD License.
Release History

Release History

This version
History Node

0.9

Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
djangovisor-0.9.tar.gz (172.1 kB) Copy SHA256 Checksum SHA256 Source Jun 2, 2015

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting