A Django Admin app to perform host server monitoring
To install Kitsune:
1. easy_install django-kitsune or download package and execute python setup.py install
2. Add 'kitsune' to the INSTALLED_APPS in your project's settings.py
3. Configure cron in every host to run a kitsune management command by running crontab command:
* * * * * /path/to/your/project/manage.py kitsune_cron
Every minute cron will run a management command to check pending jobs. Note that both, django-kitsune and your project must be installed in each host, and each host must have access to the common database (where kitsune tables shall be stored).
Kitsune can be configured via the following parameters, to be defined in your project settings file:
- KITSUNE_RENDERERS: List of modules that contain renderer classes, eg:: KITSUNE_RENDERERS = ['myproject.myapp.renderers'].
Kitsune comes with a default renderer kitsune.renderers.KitsuneJobRenderer.
- Add hosts to monitor.
- Add jobs with checks to be performed
- Check to be performed
- Host to check
- Select users or groups to be notified
- Configure notification rules
- Select how to render results
- Set amount of log history to keep
- Custom Checks:
- You can implement your own checks by implementing a subclass of kitsune.base.BaseKitsuneCheck
- Nagios Checks:
- A builtin check is provided that wrapps any Nagios check.
- You can use any existing Nagios check within django-kitsune
- Log and list check results
- Result Renderers:
- Can implement renderers by implementing a subclass of kitsune.renderers.KitsuneJobRenderer
- Returns a html with the corresponding result that will be rendered within result listings.
- List Checks:
- Host name, last time performed, last result, next scheduled run.
- Notification Rules:
- Notifications through e-mail.
- Configure who to notify: Groups or Users.
- Configure when to trigger a notification.
- Configure the frequency of notifications to avoid spam emails
- All configurations are made through a graphic UI within admin panel.