Log::Agent::Logger 0.2.00 Copyright (c) 2000, Raphael Manfredi Copyright (c) 2015, Mark Rogaski ------------------------------------------------------------------------ This program is free software; you can redistribute it and/or modify it under the terms of the Artistic License, a copy of which can be found with perl. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the Artistic License for more details. ------------------------------------------------------------------------ *** This is alpha software -- use at your own risks *** Name DSLI Description Info ----------- ---- -------------------------------------------- ----- Log::Agent ---- A general logging framework RAM ::Logger adpO Application-level logging interface RAM The Log::Agent::Logger module is an extension of Log::Agent that brings an application-level logging API. It is separated from Log::Agent itself because it has dependencies on other CPAN modules that Log::Agent cannot afford to have: everyone with a plain stock Perl distribution must be able to simply install Log::Agent and start using it. SYNOPSIS require Log::Agent::Logger; my $log = Log::Agent::Logger->make( -channel => $chan, -max_prio => 'info', -min_prio => 'emerg', ); $log->error("can't open file %s: $!", $file); $log->warning("can't open file $file: $!"); DESCRIPTION The `Log::Agent::Logger' class defines a generic interface for application logging. It must not be confused with the interface provided by Log::Agent, which is meant to be used by re-usable modules that do not wish to commit on a particular logging method, so that they remain true building blocks. By contrast, `Log::Agent::Logger' explicitely requests an object to be used, and that object must commit upon the logging channel to be used, at creation time. Optionally, minimum and maximum priority levels may be defined (and changed dynamically) to limit the messages to effectively log, depending on the advertised priority. The standard syslog(3) priorities are used. -- Raphael Manfredi