/djangovisor

This is a django project, which collects data from supervisor instances on one or multiple servers, stores it and plots it it using bootstrap and the javascript library dygraphs.

Primary LanguagePythonBSD 3-Clause "New" or "Revised" LicenseBSD-3-Clause

djangovisor

This is a django project, which collects data from supervisor instances on one or multiple servers, stores it and plots it it using bootstrap and the javascript library dygraphs.

There is a very similar app for the server monitoring tool monit called django-monit-collector.

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.