gh-65046: Link to logging cookbook from asyncio docs (GH-98207)

(cherry picked from commit c39a0c3) Co-authored-by: Shantanu <[email protected]>
python · Oct 22, 2022 · 168ec08 · 168ec08
1 parent b636023
commit 168ec08
Show file tree

Hide file tree

Showing 2 changed files with 7 additions and 0 deletions.
diff --git a/Doc/howto/logging-cookbook.rst b/Doc/howto/logging-cookbook.rst
@@ -537,6 +537,8 @@ configuration::
     print('complete')
 
 
+.. _blocking-handlers:
+
 Dealing with handlers that block
 --------------------------------
 

diff --git a/Doc/library/asyncio-dev.rst b/Doc/library/asyncio-dev.rst
@@ -148,6 +148,11 @@ adjusted::
    logging.getLogger("asyncio").setLevel(logging.WARNING)
 
 
+Network logging can block the event loop. It is recommended to use
+a separate thread for handling logs or use non-blocking IO. For example,
+see :ref:`blocking-handlers`.
+
+
 .. _asyncio-coroutine-not-scheduled:
 
 Detect never-awaited coroutines