Welcome, guest | Sign In | My Account | Store | Cart

Notice! PyPM is being replaced with the ActiveState Platform, which enhances PyPM’s build and deploy capabilities. Create your free Platform account to download ActivePython or customize Python with the packages you require and get automatic updates.

pypm install salmon

How to install salmon

  1. Download and install ActivePython
  2. Open Command Prompt
  3. Type pypm install salmon
 Python 2.7Python 3.2Python 3.3
Windows (32-bit)
Windows (64-bit)
Mac OS X (10.5+)
0.1.5 Available View build log
Linux (32-bit)
0.1.5 Available View build log
Linux (64-bit)
0.1.5 Available View build log
Lastest release
version 0.1.5 on Apr 30th, 2013

A multi-server monitoring system built on top of Salt using Django.

The project currently isn't much more than proof-of-concept. I'm interested in exploring its usefulness as both an alerting system like monit and a monitoring system like munin (perhaps using Graphite's whisper database).



It's expected that you'll run this on the same server as the Salt master.

To bootstrap the project:

virtualenv salmon
source salmon/bin/activate
pip install salmon
salmon init
salmon upgrade

Fire up the web server with:

salmon start

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: ~/.salmon/checks.yaml).

Once you have your checks defined, you can run manage.py run_checks periodically with cron and view the status at http://localhost:9000.

Configuring Salt

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:

    - '.*':
      - 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.

Subscribe to package updates

Last updated Apr 30th, 2013

What does the lock icon mean?

Builds marked with a lock icon are only available via PyPM to users with a current ActivePython Business Edition subscription.

Need custom builds or support?

ActivePython Enterprise Edition guarantees priority access to technical support, indemnification, expert consulting and quality-assured language builds.

Plan on re-distributing ActivePython?

Get re-distribution rights and eliminate legal risks with ActivePython OEM Edition.