Dave Rolsky > Log-Dispatch-2.40 > Log::Dispatch

Download:
Log-Dispatch-2.40.tar.gz

Dependencies

Annotate this POD

Related Modules

Log::Log4perl
Thread::Queue
CGI::Carp
Data::Dumper
File::Spec
Date::Format
Sys::Syslog
Apache::Session
IO::Socket
XML::Twig
more...
By perlmonks.org

CPAN RT

New  4
Open  4
View/Report Bugs
Module Version: 2.40   Source   Latest Release: Log-Dispatch-2.44

NAME ^

Log::Dispatch - Dispatches messages to one or more outputs

VERSION ^

version 2.40

SYNOPSIS ^

  use Log::Dispatch;

  # Simple API
  #
  my $log = Log::Dispatch->new(
      outputs => [
          [ 'File',   min_level => 'debug', filename => 'logfile' ],
          [ 'Screen', min_level => 'warning' ],
      ],
  );

  $log->info('Blah, blah');

  # More verbose API
  #
  my $log = Log::Dispatch->new();
  $log->add(
      Log::Dispatch::File->new(
          name      => 'file1',
          min_level => 'debug',
          filename  => 'logfile'
      )
  );
  $log->add(
      Log::Dispatch::Screen->new(
          name      => 'screen',
          min_level => 'warning',
      )
  );

  $log->log( level => 'info', message => 'Blah, blah' );

  my $sub = sub { my %p = @_; return reverse $p{message}; };
  my $reversing_dispatcher = Log::Dispatch->new( callbacks => $sub );

DESCRIPTION ^

This module manages a set of Log::Dispatch::* output objects that can be logged to via a unified interface.

The idea is that you create a Log::Dispatch object and then add various logging objects to it (such as a file logger or screen logger). Then you call the log method of the dispatch object, which passes the message to each of the objects, which in turn decide whether or not to accept the message and what to do with it.

This makes it possible to call single method and send a message to a log file, via email, to the screen, and anywhere else, all with very little code needed on your part, once the dispatching object has been created.

CONSTRUCTOR ^

The constructor (new) takes the following parameters:

METHODS ^

Logging

Log levels

Output objects

OUTPUT CLASSES ^

An output class - e.g. Log::Dispatch::File or Log::Dispatch::Screen - implements a particular way of dispatching logs. Many output classes come with this distribution, and others are available separately on CPAN.

The following common parameters can be used when creating an output class. All are optional. Most output classes will have additional parameters beyond these, see their documentation for details.

LOG LEVELS ^

The log levels that Log::Dispatch uses are taken directly from the syslog man pages (except that I expanded them to full words). Valid levels are:

debug
info
notice
warning
error
critical
alert
emergency

Alternately, the numbers 0 through 7 may be used (debug is 0 and emergency is 7). The syslog standard of 'err', 'crit', and 'emerg' is also acceptable. We also allow 'warn' as a synonym for 'warning'.

SUBCLASSING ^

This module was designed to be easy to subclass. If you want to handle messaging in a way not implemented in this package, you should be able to add this with minimal effort. It is generally as simple as subclassing Log::Dispatch::Output and overriding the new and log_message methods. See the Log::Dispatch::Output docs for more details.

If you would like to create your own subclass for sending email then it is even simpler. Simply subclass Log::Dispatch::Email and override the send_email method. See the Log::Dispatch::Email docs for more details.

The logging levels that Log::Dispatch uses are borrowed from the standard UNIX syslog levels, except that where syslog uses partial words ("err") Log::Dispatch also allows the use of the full word as well ("error").

RELATED MODULES ^

Log::Dispatch::DBI

Written by Tatsuhiko Miyagawa. Log output to a database table.

Log::Dispatch::FileRotate

Written by Mark Pfeiffer. Rotates log files periodically as part of its usage.

Log::Dispatch::File::Stamped

Written by Eric Cholet. Stamps log files with date and time information.

Log::Dispatch::Jabber

Written by Aaron Straup Cope. Logs messages via Jabber.

Log::Dispatch::Tk

Written by Dominique Dumont. Logs messages to a Tk window.

Log::Dispatch::Win32EventLog

Written by Arthur Bergman. Logs messages to the Windows event log.

Log::Log4perl

An implementation of Java's log4j API in Perl. Log messages can be limited by fine-grained controls, and if they end up being logged, both native Log4perl and Log::Dispatch appenders can be used to perform the actual logging job. Created by Mike Schilli and Kevin Goess.

Log::Dispatch::Config

Written by Tatsuhiko Miyagawa. Allows configuration of logging via a text file similar (or so I'm told) to how it is done with log4j. Simpler than Log::Log4perl.

Log::Agent

A very different API for doing many of the same things that Log::Dispatch does. Originally written by Raphael Manfredi.

SUPPORT ^

Please submit bugs and patches to the CPAN RT system at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Log%3A%3ADispatch or via email at bug-log-dispatch@rt.cpan.org.

Support questions can be sent to me at my email address, shown below.

DONATIONS ^

If you'd like to thank me for the work I've done on this module, please consider making a "donation" to me via PayPal. I spend a lot of free time creating free software, and would appreciate any support you'd care to offer.

Please note that I am not suggesting that you must do this in order for me to continue working on this particular software. I will continue to do so, inasmuch as I have in the past, for as long as it interests me.

Similarly, a donation made in this way will probably not make me work on this software much more, unless I get so many donations that I can consider working on free software full time, which seems unlikely at best.

To donate, log into PayPal and send money to autarch@urth.org or use the button on this page: http://www.urth.org/~autarch/fs-donation.html

SEE ALSO ^

Log::Dispatch::ApacheLog, Log::Dispatch::Email, Log::Dispatch::Email::MailSend, Log::Dispatch::Email::MailSender, Log::Dispatch::Email::MailSendmail, Log::Dispatch::Email::MIMELite, Log::Dispatch::File, Log::Dispatch::File::Locked, Log::Dispatch::Handle, Log::Dispatch::Output, Log::Dispatch::Screen, Log::Dispatch::Syslog

AUTHOR ^

Dave Rolsky <autarch@urth.org>

COPYRIGHT AND LICENSE ^

This software is Copyright (c) 2013 by Dave Rolsky.

This is free software, licensed under:

  The Artistic License 2.0 (GPL Compatible)
syntax highlighting: