NAME

    Metrics::Any::Adapter::Statsd - a metrics reporting adapter for statsd

SYNOPSIS

       use Metrics::Any::Adapter 'Statsd';

DESCRIPTION

    This Metrics::Any adapter type reports metrics to statsd via the local
    UDP socket. Each metric value reported will result in a new UDP packet
    being sent.

    The location of the statsd server is set by two package variables,
    defaulting to

       $Net::Statsd::HOST = "127.0.0.1";
       $Net::Statsd::PORT = 8125

    The configuration can be changed by setting new values.

METRIC HANDLING

    Unlabelled counter, gauge and timing metrics are handled natively as
    you would expect for statsd; with multipart names being joined by
    periods (.).

    Distribution metrics are emitted as two sub-named metrics by appending
    count and sum. The count metric in incremented by one for each
    observation and the sum by the observed amount.

    Labels are not handled by this adapter and are thrown away. This will
    result in a single value being reported that accumulates the sum total
    across all of the label values. In the case of labelled gauges using
    the set_gauge_to method this will not be a useful value.

    For better handling of labelled metrics for certain services which have
    extended the basic statsd format to handle them, see:

      * Metrics::Any::Adapter::DogStatsd - a metrics reporting adapter for
      DogStatsd

      * Metrics::Any::Adapter::SignalFx - a metrics reporting adapter for
      SignalFx

TODO

      * Support non-one samplerates; emit only one-in-N packets with the
      @rate notation in the packet.

      * Optionally support one dimension of labelling by appending the
      conventional some.metric.by_$label.$value notation to it.

AUTHOR

    Paul Evans <leonerd@leonerd.org.uk>