NAME
Starch::Plugin::Trace - Add extra trace logging to your manager, states, and stores.
SYNOPSIS
my $starch = Starch->new(
plugins => ['::Trace'],
....,
);DESCRIPTION
This plugin logs a lot of debug information to Log::Any under the trace level.
See the Log::Any documentation for instructions on how to output these log messages using an adapter.
This plugin is meant for non-production use, as logging will reduce performance.
MANAGER LOGGING
These messages are logged from the Starch::Manager object.
new
Every time a Starch::Manager object is created a message is logged in the format of starch.manager.new.
state
Every call to "state" in Starch::Manager is logged in the format of starch.manager.state.$action.$state_id, where $action is either retrieve or create depending on if the state ID was provided.
STATE LOGGING
These messages are logged from the Starch::State object.
new
Every time a Starch::State object is created a message is logged in the format of starch.state.new.$state_key.
save
Every call to "force_save" in Starch::State (which save calls if the state isn't dirty) is logged in the format of starch.state.save.$state_id.
reload
Every call to "force_reload" in Starch::State (which reload calls if the state isn't dirty) is logged in the format of starch.state.reload.$state_id.
mark_clean
Every call to "mark_clean" in Starch::State is logged in the format of starch.state.mark_clean.$state_id.
rollback
Every call to "rollback" in Starch::State is logged in the format of starch.state.rollback.$state_id.
delete
Every call to "force_delete" in Starch::State (which delete calls if the state is in the store) is logged in the format of starch.state.delete.$state_id.
generate_id
Every call to "generate_id" in Starch::State is logged in the format of starch.state.generate_id.$state_id.
STORE LOGGING
These messages are logged from the Starch::Store object.
The $store_name bits in the below log messages will be the name of the store class minus the Starch::Store:: bit.
new
Every time a Starch::Store object is created a message is logged in the format of starch.store.$store_name.new.
set
Every call to "set" in Starch::Store is logged in the format of starch.store.$store_name.set.$state_key.
get
Every call to "get" in Starch::Store is logged in the format of starch.store.$store_name.get.$state_key.
If the result of calling get is undefined then an additional log will produced of the format starch.store.$store_name.get.$state_key.missing.
remove
Every call to "remove" in Starch::Store is logged in the format of starch.store.$store_name.remove.$state_key.
AUTHORS AND LICENSE
See "AUTHOR" in Starch, "CONTRIBUTORS" in Starch, and "LICENSE" in Starch.