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 default 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 or by passing
    arguments to the import line:

       use Metrics::Any::Adapter 'Statsd', port => 8200;

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

ARGUMENTS

    The following additional arguments are recognised

 host

 port

    Provides specific values for the statsd server location.

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>

