The log4perl project -- log4j for Perl

Welcome to the log4perl project page. Log::Log4perl is a Perl port of the widely popular log4j logging package.

Logging beats a debugger if you want to know what's going on in your code during runtime. However, traditional logging packages are too static and generate a flood of log messages in your log files that won't help you.

Log::Log4perl is different. It allows you to control the amount of logging messages generated very effectively. You can bump up the logging level of certain components in your software, using powerful inheritance techniques. You can redirect the additional logging messages to an entirely different output (append to a file, send by email etc.) -- and everything without modifying a single line of source code.

NEW:
Collaborate with Log4perl on Github!

Further reading

CPAN Modules already using Log::Log4perl:

App-Daemon
Archive-Tar-Wrapper
Authen-PAAS
CPAN-Unwind
Cache-Historical
Catalyst-Log-Log4perl
Config-Patch
Data-Throttler
File-Comments
Gaim-Log-Mailer
Gaim-Log-Parser
IPC-Cmd-Cached
JavaScript-SpiderMonkey
Jifty
Log-Dispatch-File-Rolling
Log-Dispatch-FileRotate
Log-Log4perl-Layout-XMLLayout
Log-Statistics
Mail-DWIM
Module-Rename
Nagios-Clientstatus
Net-Amazon
Perl-Configure
Process-MaxSize
RRDTool-OO
Rose-DBx-Object-InternalPager
SQL-Translator
Sysadm-Install
Text-Language-Guess
Text-Scan-License
Text-TermExtract
Trash-Park
WebService-ReviewBoard
Workflow
XML-RSS-FromHTML-Simple
News:

July 2008:
OSCON 2008
Slides for Mike's talk at OSCON 2008.

10/31/2014:
Released version 1.46

06/25/2007:
Talk at YAPC 2007 (Houston, TX):
Smart Logging with Log4perl
.

Get your Log::Log4perl T-Shirt:

09/12/2002:
Retire your debugger, log smartly with Log::Log4perl! -- Mike's article on logging with Log::Log4perl on perl.com. Errata for this article.

Documentation:

Manual
Frequently Asked Questions
Changes


Download:

CPAN:
Log-Log4perl

Stable Release (10/31/2014) Log-Log4perl-1.46.tar.gz

Installation on Unix:
It's a regular Perl module installation procedure, use the CPAN shell for convenience: perl -MCPAN -e'install Log::Log4perl'

Installation on Win32:
We're providing a PPM package: Windows installation instructions.


Contact:

Please send bugs reports or requests for enhancements to the authors via our mailing list: log4perl-devel@lists.sourceforge.net

Subscribe to the mailing list. Or, browse the log4perl-devel mailing list archive. Or, use a better indexed archive of newer messages (2007-...).


Mike Schilli <log4perl@perlmeister.com>
Kevin Goess <cpan@goess.org>