blob: 5e6bd115c6f8bced4f7a28a3b50277b58ec949d1 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
|
.. _tcp-chapter:
==============
TCPStatsClient
==============
.. code-block:: python
statsd = TCPStatsClient(host='1.2.3.4', port=8126, timeout=1.)
The :py:class:`TCPStatsClient` class has a very similar interface to
:py:class:`StatsClient`, but internally it uses TCP connections instead of UDP.
These are the main differences when using ``TCPStatsClient`` compared to
``StatsClient``:
* The constructor supports a ``timeout`` parameter to set a timeout on all
socket actions.
* :py:meth:`connect() <TCPStatsClient.connect()>` and all methods that send
data can potentially raise socket exceptions.
* **It is not thread-safe**, so it is recommended to not share it across
threads unless a lot of attention is paid to make sure that no two threads
ever use it at once.
|
