NAME

Plack::Middleware::QueryCounter::DBI - DBI query counter per request middleware

SYNOPSIS

Enable this middleware using Plack::Builder.

use MyApp;
use Plack::Builder;

my $app = MyApp->psgi_app;

builder {
    enable 'QueryCounter::DBI';
    $app;
};

You can specify HTTP header using prefix option.

builder {
    enable 'QueryCounter::DBI', prefix => 'X-MyQueryCounter';
    $app;
};

DESCRIPTION

Plack::Middleware::QueryCounter::DBI is a middleware to count SQL query per each HTTP request. Count result outputs on HTTP header.

The counted quieries classify read, write or other query.

You'll get following HTTP headers.

X-QueryCounter-DBI-Total: 20
X-QueryCounter-DBI-Read:  16
X-QueryCounter-DBI-Write:  4
X-QueryCounter-DBI-Other:  0

Then, you can write to access log using nginx.

log_format ltsv   'host:$remote_addr\t'
                  'user:$remote_user\t'
(snip)
                  'user_agent:$http_user_agent\t'
                  'query_total:$sent_http_x_querycounter_dbi_total\t'
                  'query_read:$sent_http_x_querycounter_dbi_read\t'
                  'query_write:$sent_http_x_querycounter_dbi_write\t'
                  'query_other:$sent_http_x_querycounter_dbi_other\t';

LTSV is Labeled Tab-separated Values, see http://ltsv.org/

Additionally, I recommend to remove these header for end-user response.

location / {
    proxy_hide_header 'X-QueryCounter-DBI-Total';
    proxy_hide_header 'X-QueryCounter-DBI-Read';
    proxy_hide_header 'X-QueryCounter-DBI-Write';
    proxy_hide_header 'X-QueryCounter-DBI-Other';

    proxy_pass http://backend;
}

SEE ALSO

Plack Plack::Builder

LICENSE

Copyright (C) Masatoshi Kawazoe (acidlemon).

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

AUTHOR

Masatoshi Kawazoe (acidlemon) acidlemon@cpan.org