document werkzeug logger

pallets · Feb 4, 2020 · 4249e01 · 4249e01
1 parent 13b6ef0
commit 4249e01
Showing 1 changed file with 16 additions and 0 deletions.
diff --git a/docs/utils.rst b/docs/utils.rst
@@ -76,3 +76,19 @@ Security Helpers
 .. autofunction:: pbkdf2_hex
 
 .. autofunction:: pbkdf2_bin
+
+
+Logging
+=======
+
+Werkzeug uses standard Python :mod:`logging`. The logger is named
+``"werkzeug"``.
+
+.. code-block:: python
+
+    import logging
+    logger = logging.getLogger("werkzeug")
+
+If the logger level is not set, it will be set to :data:`~logging.INFO`
+on first use. If there is no handler for that level, a
+:class:`~logging.StreamHandler` is added.