Added docs for #40

This commit is contained in:
Ilan
2015-08-04 13:07:53 +02:00
parent 4bae1fc99f
commit 3ca7978d8c
+8 -5
View File
@@ -30,7 +30,7 @@ State
Current state of the cluster: Current state of the cluster:
- **Starting** The cluster is spawning workers and getting ready. - **Starting** The cluster is spawning workers and getting ready.
- **Idle** Everything is ok, but there are no tasks to process. - **Idle** Everything is ok, but there are no tasks to process. [#f1]_
- **Working** Processing tasks like a good cluster should. - **Working** Processing tasks like a good cluster should.
- **Stopping** The cluster does not take on any new tasks and is finishing. - **Stopping** The cluster does not take on any new tasks and is finishing.
- **Stopped** All tasks have been processed and the cluster is shutting down. - **Stopped** All tasks have been processed and the cluster is shutting down.
@@ -43,7 +43,7 @@ The current number of workers in the cluster pool.
TQ TQ
~~ ~~
**Task Queue** counts the number of tasks in the queue **Task Queue** counts the number of tasks in the queue [#f1]_
If this keeps rising it means you are taking on more tasks than your cluster can handle. If this keeps rising it means you are taking on more tasks than your cluster can handle.
You can limit this by settings the :ref:`queue_limit` in your cluster configuration. You can limit this by settings the :ref:`queue_limit` in your cluster configuration.
@@ -51,7 +51,7 @@ You can limit this by settings the :ref:`queue_limit` in your cluster configurat
RQ RQ
~~ ~~
**Result Queue** shows the number of results in the queue. **Result Queue** shows the number of results in the queue. [#f1]_
Since results are only saved by a single process which has to access the database. Since results are only saved by a single process which has to access the database.
It's normal for the result queue to take slightly longer to clear than the task queue. It's normal for the result queue to take slightly longer to clear than the task queue.
@@ -117,11 +117,11 @@ Reference
.. py:attribute:: task_q_size .. py:attribute:: task_q_size
The number of tasks currently in the task queue. The number of tasks currently in the task queue. [#f1]_
.. py:attribute:: done_q_size .. py:attribute:: done_q_size
The number of tasks currently in the result queue. The number of tasks currently in the result queue. [#f1]_
.. py:attribute:: pusher .. py:attribute:: pusher
@@ -143,6 +143,7 @@ Reference
Returns true or false depending on any tasks still present in the task or result queue. Returns true or false depending on any tasks still present in the task or result queue.
.. py:classmethod:: get(cluster_id, r=redis_client) .. py:classmethod:: get(cluster_id, r=redis_client)
Gets the current :class:`Stat` for the cluster id. Takes an optional redis connection. Gets the current :class:`Stat` for the cluster id. Takes an optional redis connection.
@@ -151,3 +152,5 @@ Reference
Returns a list of :class:`Stat` objects for all active clusters. Takes an optional redis connection. Returns a list of :class:`Stat` objects for all active clusters. Takes an optional redis connection.
.. [#f1] Uses :meth:`multiprocessing.Queue.qsize()` which is not implemented on OS X.