NAME

Plack::ServerTiming - Frontend for Plack::Middleware::ServerTiming

SYNOPSIS

    use Plack::ServerTiming;

    builder {
        enable 'ServerTiming';
        sub {
            my $env = shift;
            my $t = Plack::ServerTiming->new($env);
            sleep 1;
            $t->record_timing('miss');
            $t->record_timing(sleep => {dur => 1000, desc => 'Sleep one second...'});
            [200, ['Content-Type','text/html'], ["OK"]];
        };
    };

DESCRIPTION

This module provides high level API for Plack::Middleware::ServerTiming.

METHODS

$timing = Plack::ServerTiming->new($env)

This will create a new instance of Plack::SeverTiming.

$timing->record_timing($name, {dur => $duration, desc => $description})

record_timing() adds a metric consisting of name, duration and description.

    $timing->record_timing('total', {dur => 123.4});

$timing->guard($name, $description)

guard() creates a guard instance to record a duration. This will add a elapsed time until exit the scope as metric.

    {
        my $g = $timing->guard('elapsed', 'sleep 1');
        sleep 1;
    }
    # `elapsed;dur=1000.224;desc="sleep 1"`

SEE ALSO

Plack::Middleware::ServerTiming

LICENSE

Copyright (C) Takumi Akiyama.

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

AUTHOR

Takumi Akiyama <t.akiym@gmail.com>