NAME

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.