NAME

Plack::Middleware::NewRelic - Plack middleware for NewRelic APM instrumentation

VERSION

version 0.0502

SYNOPSIS

    use Plack::Builder;
    use Plack::Middleware::NewRelic;
    my $app = sub { ... } # as usual
    # NewRelic Options
    my %options = (
        license_key => 'asdf1234',
        app_name    => 'REST API',
    );
    builder {
        enable "Plack::Middleware::NewRelic", %options;
        $app;
    };

DESCRIPTION

With the above in place, Plack::Middleware::NewRelic will instrument your Plack application and send information to NewRelic, using the NewRelic::Agent module.

Parameters

- license_key

A valid NewRelic license key for your account.

This value is also automatically sourced from the NEWRELIC_LICENSE_KEY environment variable.

- app_name

The name of your application.

This value is also automatically sourced from the NEWRELIC_APP_NAME environment variable.

- path_rules

A HashRef containing path replacement rules, containing case-insensitive regex patterns as string keys, and evaluatable strings as replacement values.

Regex capturing groups work as intended, so you can specify something like this in your ruleset:

    # Replaces '/pages/new/asdf' with '/pages/new'
    '(\/pages\/new)\/\S+' => '$1'

BUGS

Please report any bugs or feature requests on the bugtracker website https://github.com/aanari/Plack-Middleware-NewRelic/issues

When submitting a bug or request, please include a test-file or a patch to an existing test-file that illustrates the bug or desired feature.

AUTHOR

Ali Anari <ali@anari.me>

COPYRIGHT AND LICENSE

This software is copyright (c) 2015 by Ali Anari.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.