Added the stub for a userguide on monitoring

docs/userguide/index.rst

@@ -14,3 +14,4 @@
     tasksets
     remote-tasks
     routing
+    monitoring

docs/userguide/monitoring.rst

@@ -0,0 +1,91 @@
+==================
+ Monitoring Guide
+==================
+
+.. contents::
+    :local:
+
+Events
+======
+
+Describe events
+
+
+Snapshots
+---------
+
+Describe snapshots
+
+
+Custom Camera
+~~~~~~~~~~~~~
+
+.. code-block:: python
+
+    from pprint import pformat
+
+    from celery.events.snapshot import Polaroid
+
+    class DumpCam(Polaroid):
+
+        def shutter(self, state):
+            if not state.event_count:
+                # No new events since last snapshot.
+                return
+            print("Workers: %s" % (pformat(state.workers, indent=4), ))
+            print("Tasks: %s" % (pformat(state.tasks, indent=4), ))
+            print("Total: %s events, %s tasks" % (
+                state.event_count, state.task_count))
+
+Now you can use this cam with ``celeryev`` by specifying
+it with the ``-c`` option::
+
+    $ celeryev -c myapp.DumpCam --frequency=2.0
+
+Or you can use it programatically like this::
+
+    from celery.events import EventReceiver
+    from celery.messaging import establish_connection
+    from celery.events.state import State
+    from myapp import DumpCam
+
+    def main():
+        state = State()
+        with establish_connection() as connection:
+            recv = EventReceiver(connection, handlers={"*": state.event})
+            with DumpCam(state, freq=1.0):
+                recv.capture(limit=None, timeout=None)
+
+    if __name__ == "__main__":
+        main()
+
+
+
+
+Tools
+=====
+
+celerymon
+=========
+
+Describe celerymon
+
+celeryev
+========
+
+Describe celeryev
+
+RabbitMQ
+========
+
+Describe rabbitmq tools. rabbitmqctl, Alice, etc...
+
+Django Admin
+============
+
+Describe the snapshot camera django-celery ships with.
+
+Munin
+=====
+
+Maintain a list of related munin plugins