About
---------------------------------------------------------------------------------

  libstatsdc is a C client library to the etsy/statsd statistics daemon.

  For more info, see :
    * http://codeascraft.etsy.com/2011/02/15/measure-anything-measure-everything/
    * https://github.com/etsy/statsd

---------------------------------------------------------------------------------


Usage
---------------------------------------------------------------------------------

  Interface documented in libstatsdc/statsdc.h

  See the accompanying src/example.c file for example usage

---------------------------------------------------------------------------------


Installation instructions
---------------------------------------------------------------------------------

  Follow the instructions in INSTALL file

  If you cloned from a repo and you're lacking the "./configure" script,
  first run:

    autoreconf --install

---------------------------------------------------------------------------------


Notes
---------------------------------------------------------------------------------

  1. While UDP is fire-and-forget, this library may block on DNS operations in
  statsdc_reconnect

    If you'd like guaranteed non-blocking behavior, ensure:

    * Supply the host as an IP address string, which would not require DNS
      resolution
    * Guarantee fast DNS operations by your OS (via /etc/hosts for example)
      or via upstream DNS servers and/or caching proxies

  2. If supplying sample_rate != 1, rand() will internally be called.  However
     srand() will not be called.  You should srand() once early on in your
     application to properly seed the PRNG.

---------------------------------------------------------------------------------


Copyright
---------------------------------------------------------------------------------

  This code is Copyright 2011 Mina Naguib.

  See the accompanying COPYING file for use and distribution legalese.

---------------------------------------------------------------------------------