NAME

Thorium::Log - Logging support

VERSION

version 0.510

SYNOPSIS

    use Thorium::Log;

    my $log = Thorium::Log->new();

    $log->warn('Some warning message');

DESCRIPTION

Thorium::Log is a high level wrapper class around Log::Log4perl's functionality. It exists to replace all prints and says. See Thorium::Roles::Logging for adding logging support via $self-log->...> to your object. You are encouraged to subclass and set prefix().

ATTRIBUTES

Optional Attributes

add_benchmarks (rw, Bool)
Every time a log message is output ($log->$level($message)), additionally outputs a benchmark time line with the time elapsed since the last log message was output. Defaults to '0'.
caller_depth (rw, Int)
Determines (additional) depth for caller inside Log4Perl. Defaults to '1'.
category (ro, Str)
The category to use for Log::Log4Perl. This is used to set category specific log levels in the configuration. Default is the name of the package in which the Thorium::Log object was created.
config_file (rw, Str)
The location of the configuration file to read. You may set the environment variable THORIUM_LOG_CONF_FILE otherwise /etc/thorium/log.conf will be used. An example is provided in this distribution under conf/log.conf. See Log::Log4Perl for details.
die_on_fatal (rw, Bool)
Allows automatic die()ing for the fatal level. Defaults to '0'.

PUBLIC API METHODS

Levels

trace($str_or_ref, ...)
debug($str_or_ref, ...)
info($str_or_ref, ...)
warn($str_or_ref, ...)
error($str_or_ref, ...)
fatal($str_or_ref, ...)

Stack Traces

carp($str_or_ref, ...)
Warn with one level of a stack trace.
cluck($str_or_ref, ...)
Warn with full stack trace.
confress($str_or_ref, ...)
Die with one level of a stack trace.
croak($str_or_ref, ...)
Die with full stack trace.

AUTHOR

Adam Flott <adam@npjh.com>

COPYRIGHT AND LICENSE

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