Documentation

doc/ref/returners/index.rst

@@ -110,6 +110,26 @@ loaded as simply ``redis``:
             return False
         return __virtualname__
 
+Event Returners
+===============
+
+For maximimum visibility into the history of events across a Salt
+infrastructure, all events seen by a salt master may be logged to a returner.
+
+To enable event logging, set the ``event_return`` configuration option in the
+master config to returner which should be designated as the handler for event
+returns.
+
+.. note::
+    Not all returners support event returns. Verify a returner has an
+    ``event_return()`` function before using.
+
+.. note::
+    On larger installations, many hundreds of events may be generated on a
+    busy master every second. Be certain to closely monitor the storage of
+    a given returner as Salt can easily overwhealm an underpowered server
+    with thousands of returns.
+
 Full List of Returners
 ======================