NAME
Plack::Middleware::Debug::CatalystPluginCache - Panel for monitoring
Catalyst::Plugin::Cache's
VERSION
version 0.101
SYNOPSIS
enable "Debug:CatalystPluginCache";
is equivalent to:
enable "Debug:CatalystPluginCache",
app_class => '...', # Catalyst class name is determined automatically
show_process_stats => 1,
show_global_stats => 0,
track_miss_locations => 0;
DESCRIPTION
General
The default output consists of a summary of cache statistics, for each
of the caches configured for Catalyst::Plugin::Cache, for the current
request:
Cache Get Miss Hit% Set Compute Remove Backend
default 11 10 9.09 11 0 0 Cache::Memcached::libmemcached=HASH(0xa682020)
This becomes more useful as more Catalyst::Plugin::Cache caches are
configured for different uses. You can then see more fine-grained
details of how effectively the different caches are being used.
track_miss_locations
If "track_miss_locations" is enabled then, for each cache that had one
or more misses, a summary of the subroutine call paths that encountered
the misses is displayed:
Call paths for misses in the default cache:
. Catalyst::Plugin::PageCache::Catalyst::Plugin::Cache::Curried::get@106 =>
. . Catalyst::Plugin::Static::Simple::Catalyst::Plugin::PageCache::dispatch@76 =>
. . . Catalyst::Engine::PSGI::Hello::dispatch@158 =>
. . . . Catalyst::Engine::PSGI::(eval)@156 =>
. . . . . Catalyst::Catalyst::Engine::PSGI::run@2386 =>
...
. . . . . . . misses => 1
Some 'uninteresting' packages are filtered out to aid readability.
show_process_stats
If "show_process_stats" is enabled then a summary of the cache
statistics is shown, like "General" above, except the stats refer to the
lifetime of the server process which handled the request. Typically only
useful in development environments with a single Plack application
server process.
show_global_stats
If "show_global_stats" is enabled then the cache backend service is
queried for global stats before and after the request is processed and
the differences in counts are displayed. For example:
Cache Global stats changes during time of request
default bytes: +2, bytes_read: +65915, bytes_written: +1635, cmd_get: +11, cmd_set: +11,
curr_items: +1, evictions: +1, get_hits: +1, get_misses: +10, total_connections: +2, total_items: +11
Currently only global stats fromCache::Memcached::libmemcached based
caches are supported. Others could be added easily. Note that these
backend cache server stats will obviously be affected by any other
clients using the cache services. They are most useful in development
environments with a dedicated backend cache server.
SEE ALSO
Plack::Middleware::Debug, Cache::Memcached::libmemcached