Metadata-Version: 2.1
Name: django-celery-heartbeat
Version: 0.1.0
Summary: A Django app to provide basic celery health monitoring.
Home-page: https://github.com/octavenz/django-celery-heartbeat
Author: Richard Campen
Author-email: richard@campen.co
License: MIT
Platform: UNKNOWN
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content

Celery Heartbeat
===

Django app that provides a task that can be run periodically to hit a webhook url of choice to provide basic celery health monitoring.

Configuration
---

Add ``celery_heartbeat`` to your ``INSTALLED_APPS`` setting::

    INSTALLED_APPS = [
        ...
        celery_heartbeat,
    ]

Celery-heartbeat comes with a request handler that posts to a configured endpoint and sends a token to authenticate with the receiving server::

    CELERY_HEARTBEAT_ENDPOINT = 'https://example.com/celery-webhook/
    CELERY_HEARTBEAT_TOKEN = '<valid token for endpoint request>'

You will also need to configure the heartbeat task to run periodically using celery-beat::

    CELERY_BEAT_SCHEDULE = {
        'celery-heartbeat': {
            'task': 'celery_heartbeat.tasks.send_heartbeat',
            'schedule': crontab(minute='*/5')
        }
    }


