NAME

    Mojolicious::Plugin::Statsd - Emit to Statsd, easy!

SYNOPSIS

      # Mojolicious
      $self->plugin('Statsd');
    
      # Mojolicious::Lite
      plugin 'Statsd';
    
      # Anywhere you have Mojo helpers available
      $app->stats->increment('frobs.adjusted');
    
      # It's safe to pass around if need be
      my $stats = $app->stats;
    
      # Only sample half of the time
      $stats->increment('frobs.discarded', 0.5);
    
      # Time a code section
      $stats->timing('frobnicate' => sub {
        # section to be timed
      });
    
      # Or do it yourself
      $stats->timing('frobnicate', $milliseconds);
    
      # Save repetition
      my $jobstats = $app->stats->with_prefix('my-special-process.');
    
      # This becomes myapp.my-special-process.foo
      $jobstats->increment('foo');

DESCRIPTION

    Mojolicious::Plugin::Statsd is a Mojolicious plugin which adds a helper
    for throwing your metrics at statsd.

INHERITANCE

    Mojolicious::Plugin::Statsd is a Mojolicious::Plugin

OPTIONS

    Mojolicious::Plugin::Statsd supports the following options.

 adapter

      # Mojolicious::Lite
      plugin Statsd => {adapter => 'Memory'};

    The tail-end of a classname in the
    Mojolicious::Plugin::Statsd::Adapter:: namespace, or an object instance
    to be used as the adapter.

    Defaults to Statsd, which itself defaults to emit to UDP
    localhost:8125.

    Bundled adapters are listed in "SEE ALSO". Adapters MUST implement
    counter and timing.

 prefix

      # Mojolicious::Lite
      plugin Statsd => {prefix => 'whatever.'};

    A prefix applied to all recorded metrics. This a simple string
    concatenation, so if you want to namespace, add the trailing .
    character yourself. It defaults to your $app->moniker, followed by ..

 helper

      # Mojolicious::Lite
      plugin Statsd => {helper => 'statistics'};

    The helper name to be installed. Defaults to 'stats'

ADDITIONAL OPTIONS

    Any further options are passed to the "adapter" during construction,
    unless you've passed an object already. Refer to the adapter
    documentation for supported options.

ATTRIBUTES

    Mojolicious::Plugin::Statsd has the following attributes, which are
    best configured through the plugin options above.

adapter

    The statsd adapter in use.

prefix

    The current prefix to apply to metric names.

METHODS

 register

      $plugin->register(Mojolicious->new);
      $plugin->register(Mojolicious->new, {prefix => 'foo'});

    Register plugin in Mojolicious application. The optional second
    argument is a hashref of "OPTIONS".

 with_prefix

      my $new = $stats->with_prefix('baz.');

    Returns a new instance with the given prefix appended to our own
    prefix, for scoped recording.

 counter

      $stats->counter('foo', 1);
      $stats->counter('bar', 1, 0.5);

    Record a change to a counter.

 increment

      $stats->increment($name, $sample_rate);

    Shortcut for "counter".

 decrement

      $stats->decrement($name, $sample_rate);

    Shortcut for "counter".

 timing

      $stats->timing('foo', 2500, 0.5);
      $stats->timing(foo => 0.5, sub { });
      $stats->timing(foo => sub { });

    Record timing.

 gauge

      $stats->gauge(xyzzy => 76);
      $stats->gauge(xyzzy => '+25');
      $stats->gauge(xyzzy => -25);

    Send a gauge update. Some receiving servers accept sending a signed
    value rather than an absolute value, and this is supported. Note that
    on those servers, in order to reach a negative value, you must update
    to 0 first.

 set_add

      $stats->set_add(things => 42);
      $stats->set_add(primes => 1, 3, 5, 7);

    Add one or more values to a set.

NAMES

    In any place a metric name is specified, it can be substituted with an
    arrayref in order to update several metrics in a single packet,
    provided your server supports it.

EXAMPLE

      use Mojolicious::Lite;
      plugin 'Statsd';
    
      hook after_dispatch => sub {
        my ($c) = @_;
        $c->stats->increment('path.' . $c->req->url->path);
      };
    
      #...
    
      app->start;

SEE ALSO

    Mojolicious::Plugin::Statsd::Adapter::Statsd,
    Mojolicious::Plugin::Statsd::Adapter::Memory.

    Mojolicious, Mojolicious::Guides

LICENSE

    This software is licensed under the same terms as Perl itself.