Added block to main article.

symfony · ghost · Nov 29, 2017 · Nov 29, 2017 · Dec 1, 2017 · Dec 1, 2017
commit 2519c7af3d072680ea21a1ecf559af2ee1e2abb2
diff --git a/logging.rst b/logging.rst
@@ -323,6 +323,49 @@ specific channel (``app`` by default), use the ``monolog.logger`` tag  with the
 ``channel`` property as explained in the
 :ref:`Dependency Injection reference <dic_tags-monolog>`.

+How to Disable Microseconds Precision (for a Performance Boost)
+---------------------------------------------------------------
+
+Setting the parameter ``use_microseconds`` to ``false`` forces the logger to reduce
+the precision in the ``datetime`` field of the log messages from microsecond to second,
+avoiding a call to the ``microtime(true)`` function and the subsequent parsing.
+Disabling the use of microseconds can provide a small performance gain speeding up the
+log generation. This is recommended for systems that generate a large number of log events.
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/monolog.yaml
+        monolog:
+            use_microseconds: false
+            # ...
+
+    .. code-block:: xml
+
+        <!-- config/packages/monolog.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <container xmlns="http://symfony.com/schema/dic/services"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xmlns:monolog="http://symfony.com/schema/dic/monolog"
+            xsi:schemaLocation="http://symfony.com/schema/dic/services
+                http://symfony.com/schema/dic/services/services-1.0.xsd
+                http://symfony.com/schema/dic/monolog
+                http://symfony.com/schema/dic/monolog/monolog-1.0.xsd">
+
+            <monolog:config use-microseconds="false">
+                <!-- ... -->
+            </monolog:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/monolog.php
+        $container->loadFromExtension('monolog', array(
+            'use_microseconds' => false,
+            // ...
+        ));
+
 Adding extra Data to each Log (e.g. a unique request token)
 -----------------------------------------------------------

@@ -343,7 +386,6 @@ Learn more
    logging/processors
    logging/monolog_regex_based_excludes
    logging/monolog_console
-    logging/disable_microsecond_precision

 .. _Monolog: https://github.com/Seldaek/monolog
 .. _LoggerInterface: https://github.com/php-fig/log/blob/master/Psr/Log/LoggerInterface.php