docs: Django ORM broker

README.rst

@@ -20,7 +20,7 @@ Features
 -  Django Admin integration
 -  PaaS compatible with multiple instances
 -  Multi cluster monitor
--  Redis, Disque, IronMQ or SQS
+-  Redis, Disque, IronMQ, SQS or ORM
 -  Python 2 and 3
 
 Requirements
@@ -35,11 +35,11 @@ Tested with: Python 2.7 & 3.4. Django 1.7.10 & 1.8.4
 
 Brokers
 ~~~~~~~
-- `Redis <http://redis.io/>`__
+- `Redis <https://django-q.readthedocs.org/en/latest/brokers.html#redis>`__
-- `Disque <https://github.com/antirez/disque>`__
+- `Disque <https://django-q.readthedocs.org/en/latest/brokers.html#disque>`__
-- `IronMQ <http://www.iron.io/mq/>`__
+- `IronMQ <https://django-q.readthedocs.org/en/latest/brokers.html#ironmq>`__
-- `Amazon SQS <https://aws.amazon.com/sqs/>`__
+- `Amazon SQS <https://django-q.readthedocs.org/en/latest/brokers.html#amazon-sqs>`__
-
+- `Django ORM <https://django-q.readthedocs.org/en/latest/brokers.html#django-orm>`__
 
 Installation
 ~~~~~~~~~~~~

docs/admin.rst

@@ -81,3 +81,9 @@ Indicates the success status of the last scheduled task, if any.
 
 
 Uses the :class:`Schedule` model
+
+Queued tasks
+------------
+This admin view is only enabled when you use the :ref:`orm_broker` broker.
+It shows all tasks packages currently in the broker queue. The ``lock`` column shows the moment at which this package was picked up by the cluster and is used to determine whether it has expired or not.
+For development purposes you can edit and delete queued tasks from here.

docs/brokers.rst

@@ -73,6 +73,19 @@ Although `SQS <https://aws.amazon.com/sqs/>`__ is not the fastest, it is stable,
 * Requires the `boto3 <https://github.com/boto/boto3>`__ client library: ``pip install boto3``
 * See the :ref:`sqs_configuration` configuration section for options.
 
+.. _orm_broker:
+
+Django ORM
+----------
+Select this to use Django's database backend as a message broker.
+Unless you have configured a dedicated database backend for it, this should probably not be your first choice for a high traffic setup.
+However for a medium message rate and scheduled tasks, this is the most convenient guaranteed delivery broker.
+
+* Delivery receipts
+* Supports bulk dequeue
+* Needs Django's `Cache framework <https://docs.djangoproject.com/en/1.8/topics/cache/#setting-up-the-cache>`__ configured for monitoring
+* Queue editable in Django Admin
+* See the :ref:`orm_configuration` configuration on how to set it up.
 
 Reference
 ---------

docs/configure.rst

@@ -240,6 +240,29 @@ Please make sure these credentials have proper SQS access.
 
 Amazon SQS only supports a bulk setting between 1 and 10, with the total payload not exceeding 256kb.
 
+.. _orm_configuration:
+
+orm
+~~~
+If you want to use Django's database backend as a message broker, set the ``orm`` keyword to the database connection you want it to use::
+
+    # example ORM broker connection
+
+    Q_CLUSTER = {
+        'name': 'DjangORM',
+        'workers': 4,
+        'timeout': 90,
+        'retry': 120,
+        'queue_limit': 50,
+        'bulk': 10,
+        'orm': 'default'
+    }
+
+Using the Django ORM backend will also enable the Queued Tasks table in the Admin.
+
+If you need better performance , you should consider using a different database backend than the main project.
+Set ``orm`` to the name of that database connection and make sure you run migrations on it using the ``--database`` option.
+
 .. _bulk:
 
 bulk
@@ -256,6 +279,11 @@ cache
 For some brokers, you will need to set up the Django `cache framework <https://docs.djangoproject.com/en/1.8/topics/cache/#setting-up-the-cache>`__
 to gather statistics for the monitor. You can indicate which cache to use by setting this value. Defaults to ``default``.
 
+scheduler
+~~~~~~~~~
+You can disable the scheduler by setting this option to ``False``. This will reduce a little overhead if you're not using schedules, but is most useful if you want to temporarily disable all schedules.
+Defaults to ``True``
+
 cpu_affinity
 ~~~~~~~~~~~~
 

docs/index.rst

@@ -20,7 +20,7 @@ Features
 -  Django Admin integration
 -  PaaS compatible with multiple instances
 -  Multi cluster monitor
--  Redis, Disque, IronMQ or SQS
+-  Redis, Disque, IronMQ, SQS or ORM
 -  Python 2 and 3