Skip to main content

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

Project description

https://badge.fury.io/py/django-rq-pulse.svg https://travis-ci.org/NZME/django-rq-pulse.svg?branch=master

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

Quickstart

Install Django RQ Pulse:

pip install django-rq-pulse

Add it to your INSTALLED_APPS:

INSTALLED_APPS = (
    ...
    'django_rq_pulse.apps.DjangoRqPulseConfig',
    ...
)

Define the SERVER_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:

REDIS_DB = {
    'host': 'Your Redis Hostname or IP goes here',
    'port': 'Your Redis port number goes here',
    'database': 'Your Redis database number goes here'
}

Usage

Check that rqworkers are running:

$ python manage.py rq_pulse_check

If the actual number of workers is less 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:

--expected-num-workers=2
--seconds-to-sleep=5
--num-retries=5
--queue-name="default"

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

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

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

$ python manage.py rq_pulse_check --help

Running Tests

Does the code actually work?

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

Credits

Tools used in rendering this package:

History

0.2.0 (2019-07-23)

  • Change behaviour of –expected-num-workers to only report to admins when the number of workers are less than the expected value. Add test versions for Python 3.6 and Django 2.2.

0.1.4 (2018-02-13)

  • Use the built in mail_admins Django function instead of send_mail.

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 setup.py 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.

Files for django-rq-pulse, version 0.2.0
Filename, size File type Python version Upload date Hashes
Filename, size django_rq_pulse-0.2.0-py2.py3-none-any.whl (6.7 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size django-rq-pulse-0.2.0.tar.gz (7.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