NAME Log::Fine - Yet another logging framework SYNOPSIS Provides fine-grained logging and tracing. use Log::Fine; use Log::Fine::Levels::Syslog; # exports log levels use Log::Fine::Levels::Syslog qw( :masks ); # exports masks and levels # Build a Log::Fine object my $fine = Log::Fine->new(); # Specify a custom map my $fine = Log::Fine->new(levelmap => "Syslog"); # Get the name of the log object my $name = $fine->name(); # Use logger() to get a new logger object. If "foo" is not # defined then a new logger with the name "foo" will be created. my $log = Log::Fine->logger("foo"); # Get list of names of defined logger objects my @loggers = $log->listLoggers(); # Register a handle, in this case a handle that logs to console. my $handle = Log::Fine::Handle::Console->new(); $log->registerHandle( $handle ); # Log a message $log->log(INFO, "Log object successfully initialized"); DESCRIPTION Log::Fine provides a logging framework for application developers who need a fine-grained logging mechanism in their program(s). By itself, Log::Fine provides a mechanism to get one or more logging objects (called *loggers*) from its stored namespace. Most logging is then done through a logger object that is specific to the application. For a simple functional interface to the logging sub-system, see Log::Fine::Utils. Handles Handlers provides a means to output log messages in one or more ways. Currently, the following handles are provided: * Log::Fine::Handle::Console Provides logging to `STDERR' or `STDOUT' * Log::Fine::Handle::Email Provides logging via email. Useful for delivery to one or more pager addresses. * Log::Fine::Handle::File Provides logging to a file * Log::Fine::Handle::File::Timestamp Same thing with support for time-stamped files * Log::Fine::Handle::Syslog Provides logging to syslog See the relevant perldoc information for more information. Additional handlers can be defined to user taste. Formatters A formatter specifies how Log::Fine displays messages. When a message is logged, it gets passed through a formatter object, which adds any additional information such as a time-stamp or caller information. By default, log messages are formatted as follows using the Basic formatter object. [