minor #7896 How to change the 'time' parameter of the deduplication handler (ThomasLandauer, xabbuh)

This PR was merged into the 2.7 branch.

Discussion
----------

How to change the 'time' parameter of the deduplication handler

Don't know how this needs to be written in XML & PHP, sorry.

Commits
-------

4b7bc67 Update monolog_email.rst
da281f2 `time` option
9d2f2fd add XML and PHP config examples
25e0bc1 How to change the 'time' parameter of the deduplication handler

Author: wouterj

logging/monolog_email.rst

@@ -143,6 +143,43 @@ then passes them onto the nested handler in one go, but only if the records are
 unique over a given period of time (60 seconds by default). If the records are
 duplicates they are simply discarded. Adding this handler reduces the amount of
 notifications to a manageable level, specially in critical failure scenarios.
+You can adjust the time period:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # app/config/config_prod.yml
+        monolog:
+            handlers:
+                # ... 
+                deduplicated:
+                    type: deduplication
+                    # the time in seconds during which duplicate entries are discarded (default: 60)
+                    time: 10
+                    handler: swift
+ 
+    .. code-block:: xml
+
+        <!-- app/config/config_prod.xml -->
+        <!-- use the `time` attribute for values other than the default of 60 seconds: -->
+        <monolog:handler name="deduplicated"
+            type="deduplication"
+            time="10"
+            handler="swift" />
+
+    .. code-block:: php
+
+        // app/config/config_prod.php
+        $container->loadFromExtension('monolog', array(
+            'handlers' => array(
+                // ...
+                'deduplicated' => array(
+                    'type'    => 'deduplication',
+                    // the time in seconds during which duplicate entries are discarded (default: 60)
+                    'time' => 10,
+                    'handler' => 'swift',
+                 )
 
 The messages are then passed to the ``swift`` handler. This is the handler that
 actually deals with emailing you the error. The settings for this are