Skip to main content

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.

Project details


Release history Release notifications

This version
History Node

0.9

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
djangovisor-0.9.tar.gz (172.1 kB) Copy SHA256 hash SHA256 Source None

Supported by

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