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