summaryrefslogtreecommitdiff
path: root/docs/unix_socket.rst
blob: b3d1c21909ecac5226589d9a0b9950bea69e2c1a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
.. _unix-socket-chapter:

=====================
UnixSocketStatsClient
=====================

.. code-block:: python

    statsd = UnixSocketStatsClient(socket_path='/var/run/stats.sock')

The :py:class:`UnixSocketStatsClient` class has a very similar interface to
:py:class:`TCPStatsClient`, but internally it uses Unix Domain sockets instead
of TCP.  These are the main differences when using ``UnixSocketStatsClient``
compared to ``StatsClient``:

* The ``socket_path`` parameter is required. It has no default.

* The ``host``, ``port`` and ``ipv6`` parameters are not allowed.

* The application process must have permission to write to the socket.