A multi-server monitoring system built on top of Salt using Django.
It aims to be simpler, easier to setup, and more efficient than its predecessors by taking advantage of Salt for data gathering and transport.
It's expected that you'll run this on the same server as the Salt master, however it is also possible to run on a host capable of SSHing to the master.
To bootstrap the project:
virtualenv salmon source salmon/bin/activate pip install salmon salmon init salmon upgrade salmon collectstatic
Fire up the web server with:
Now create a config file for your checks. There is a commented example in the repo. Store this in the same directory as your
conf.py file (default:
Once you have your checks defined, you can run
manage.py run_checks periodically with
cron and view the status at
For security reasons, you shouldn't run this as
root on your server. Instead, use (or create) a less privileged user and modify your Salt master config to only provide access to the specific functions it needs to check. For example, you could create
/etc/salt/master.d/monitor_acl.conf with the following contents:
client_acl: youruser: - '*': - test.ping - service.status - disk.usage - 'ps.*' - file.check_hash
Be sure to restart the
salt-master for configuration changes to take effect. For more details, read the docs on Salt's client_acl.