Support logging configuration through the python logger

Signed-off-by: Ivan Kanakarakis <ivan.kanak@gmail.com>

1 files changed, 49 insertions, 9 deletions

diff --git a/docs/howto/config.rst b/docs/howto/config.rst
index c4279974..060f4f68 100644
--- a/docs/howto/config.rst
+++ b/docs/howto/config.rst
@@ -64,6 +64,55 @@ Configuration directives
 General directives
 ------------------
 
+logging
+^^^^^^^
+
+The logging configuration format is the python logging format.
+The configuration is passed to the python logging dictionary configuration handler,
+directly.
+
+Example::
+
+    "logging": {
+        "version": 1,
+        "formatters": {
+            "simple": {
+                "format": "[%(asctime)s] [%(levelname)s] [%(name)s.%(funcName)s] %(message)s",
+            },
+        },
+        "handlers": {
+            "stdout": {
+                "class": "logging.StreamHandler",
+                "stream": "ext://sys.stdout",
+                "level": "DEBUG",
+                "formatter": "simple",
+            },
+        },
+        "loggers": {
+            "saml2": {
+                "level": "DEBUG"
+            },
+        },
+        "root": {
+            "level": "DEBUG",
+            "handlers": [
+                "stdout",
+            ],
+        },
+    },
+
+The exapmle configuration above will enable DEBUG logging to stdout.
+
+
+debug
+^^^^^
+
+Example::
+
+    debug: 1
+
+Whether debug information should be sent to the log file.
+
 additional_cert_files
 ^^^^^^^^^^^^^^^^^^^^^
 
@@ -186,15 +235,6 @@ and **other**.::
         },
     ]
 
-debug
-^^^^^
-
-Example::
-
-    debug: 1
-
-Whether debug information should be sent to the log file.
-
 entityid
 ^^^^^^^^