Skip to main content
Donate to the Python Software Foundation or Purchase a PyCharm License to Benefit the PSF! Donate Now

A Django package to check that rq workers are running and notify admins if they are not

Project description

A Django package to check that rq workers are running and notify admins if they are not


Install Django RQ Pulse:

pip install django-rq-pulse

Add it to your INSTALLED_APPS:


Define the DEFAULT_FROM_EMAIL and ADMINS Django settings because these settings will be used to send notification emails.

Define a dictionary in your Django settings for your Redis connection details like so:

    'host': 'Your Redis Hostname or IP goes here',
    'port': 'Your Redis port number goes here',
    'database': 'Your Redis database number goes here'


Check that rqworkers are running:

$ python rq_pulse_check

If the actual number of workers is not equal the expected number of workers or If there are items in the queue but the queue size is not changing notify admins by email.

The above command will run with default parameters where:


You can override these values by passing any or all the parameters to the command like so:

$ python rq_pulse_check --expected-num-workers=3 --queue-name="high"

To get a list of the command parameters use the –help parameter:

$ python rq_pulse_check --help

Running Tests

Does the code actually work?

source <YOURVIRTUALENV>/bin/activate
(myenv) $ pip install tox
(myenv) $ tox


Tools used in rendering this package:


0.1.3 (2018-02-12)

  • Add commands to Makefile to simplify the package build and release process

0.1.2 (2018-02-12)

  • Modify to enable the usage of bumpversion.

0.1.1 (2018-02-12)

  • Allow the Redis connection details to be customizable.

0.1.0 (2018-01-19)

  • First release on PyPI.

Project details

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
django_rq_pulse-0.1.3-py2.py3-none-any.whl (8.3 kB) Copy SHA256 hash SHA256 Wheel py2.py3
django-rq-pulse-0.1.3.tar.gz (6.3 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page