mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-11-10 22:36:18 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 8

gh-91305: Add a note about DatagramHandler and DNS latency. (GH-96380)

Browse source
This commit is contained in:
Vinay Sajip 2022-08-29 22:29:22 +01:00 • committed by GitHub
parent e5b2453e61
commit 6324b135ac
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 7 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

7
Doc/library/logging.handlers.rst
View file

@ -572,6 +572,13 @@ over UDP sockets.
Returns a new instance of the :class:`DatagramHandler` class intended to Returns a new instance of the :class:`DatagramHandler` class intended to
communicate with a remote machine whose address is given by *host* and *port*. communicate with a remote machine whose address is given by *host* and *port*.
.. note:: As UDP is not a streaming protocol, there is no persistent connection
between an instance of this handler and *host*. For this reason, when using a
network socket, a DNS lookup might have to be made each time an event is
logged, which can introduce some latency into the system. If this affects you,
you can do a lookup yourself and initialize this handler using the looked-up IP
address rather than the hostname.
.. versionchanged:: 3.4 .. versionchanged:: 3.4
If ``port`` is specified as ``None``, a Unix domain socket is created If ``port`` is specified as ``None``, a Unix domain socket is created
using the value in ``host`` - otherwise, a UDP socket is created. using the value in ``host`` - otherwise, a UDP socket is created.