statsd = TCPStatsClient(host='', port=8126, timeout=1.)

The TCPStatsClient class has a very similar interface to 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.
  • 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.