Skip to main content

Server Density plugin to monitor IronMQs

Project description

A plugin for the Server Density agent that monitors IronMQ queues using API version 3.

PyPI page | GitHub project

For details how to write one, read the official docs on plugins. Or find more official plugins.


  • Monitors all queues of the given projects.
  • Recorded metrics:
    • size (key: <projectid/-name>:<queuename>:size)
    • total_messages (key: <projectid/-name>:<queuename>:size)

Example for metric keys:


How to use

Install via PyPI or …

Get it from pypi, installing it somewhere:

pip install sd-ironmq

Symlink it to your plugin directory, on Debian/Ubuntu by default: /usr/bin/sd-agent/plugins

Install via curl

curl the latest version from GitHub directly into your Plugin directory:

curl > /usr/bin/sd-agent/plugins/


Add this section to your /etc/sd-agent/config.cfg:

# comma separated list of project IDs

Restart the agent

On Debian/Ubuntu:

service sd-agent restart

Other configuration options

Metric Keys: Use Project Names instead of IDs

Let’s say you configured the queues of your billing project to be monitored:


For a queue invoices, the metric keys would look like so:


That’s not beautiful, nor understandable. Also it exposes IronMQ internals unnecessarily. Configure a name for the project ID like so:

The name is then used in the keys:


Test locally

Create an example.cfg in the working directory:


Run the plugin:




  1. Install twine and wheel:

    $ pip install -r requirements_dev.txt
  2. Setup your .pypirc.

Release a new version

  1. Update CHANGELOG.

  2. Update version in, commit, push.

  3. Tag as that version, see git tag, push –tags

  4. Build distributables:

    $ python sdist bdist_wheel
  5. Upload distributable to PyPI:

    $ twine upload --sign dist/*


MIT, see LICENSE file, Copyright engageSPARK

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for sd-ironmq, version 0.1.2
Filename, size File type Python version Upload date Hashes
Filename, size sd_ironmq-0.1.2-py2-none-any.whl (6.2 kB) File type Wheel Python version py2 Upload date Hashes View
Filename, size sd-ironmq-0.1.2.tar.gz (4.1 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page