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>