Perl/Log4perl - Historique des versions

Didier : /* Listing 1: drink.pl */

2013-04-26T14:13:05Z

Listing 1: drink.pl

← Version précédente		Version du 26 avril 2013 à 14:13
Ligne 37 :		Ligne 37 :
	Listing <path>drink.pl</path> shows an example. <class>Log::Log4perl</class> is called with the <class>qw(:easy)</class> target to provide a beginner's interface for us. We initialize the logging system with <class>easy_init($ERROR)</class>, telling it to suppress all messages except those marked <class>ERROR</class> and higher (<class>ERROR</class> and <class>FATAL</class> that is). In easy mode, <class>Log::Log4perl</class> exports the scalars <class>$DEBUG</class>, <class>$INFO</class> etc. to allow the user to easily specify the desired priority.		Listing <path>drink.pl</path> shows an example. <class>Log::Log4perl</class> is called with the <class>qw(:easy)</class> target to provide a beginner's interface for us. We initialize the logging system with <class>easy_init($ERROR)</class>, telling it to suppress all messages except those marked <class>ERROR</class> and higher (<class>ERROR</class> and <class>FATAL</class> that is). In easy mode, <class>Log::Log4perl</class> exports the scalars <class>$DEBUG</class>, <class>$INFO</class> etc. to allow the user to easily specify the desired priority.

	=== Listing 1: drink.pl ===		== Listing 1: drink.pl ==
	<syntaxhighlight lang="perl">		<syntaxhighlight lang="perl">
	use Log::Log4perl qw(:easy);		use Log::Log4perl qw(:easy);

Didier : /* Listing 2: eat.pl */

2013-04-26T14:12:30Z

Listing 2: eat.pl

← Version précédente		Version du 26 avril 2013 à 14:12
Ligne 228 :		Ligne 228 :
	That's it -- we've got <class>Log::Log4perl</class> ready for the big league. Listing <path>eat.pl</path> shows the entire "system": Startup code, the main program and the application wrapped into the <class>Groceries::Food</class> class.		That's it -- we've got <class>Log::Log4perl</class> ready for the big league. Listing <path>eat.pl</path> shows the entire "system": Startup code, the main program and the application wrapped into the <class>Groceries::Food</class> class.

	=== Listing 2: eat.pl ===		== Listing 2: eat.pl ==

	<syntaxhighlight lang="perl">		<syntaxhighlight lang="perl">

Didier : /* Appenders */

2013-04-26T14:10:17Z

Appenders

← Version précédente		Version du 26 avril 2013 à 14:10
Ligne 176 :		Ligne 176 :
	Moreover, and this is ''very'' important, <class>Log::Log4perl</class> will walk up the hierarchy and forward the message to every appender attached to one of the logger's parents or ancestors.		Moreover, and this is ''very'' important, <class>Log::Log4perl</class> will walk up the hierarchy and forward the message to every appender attached to one of the logger's parents or ancestors.

	<class>Log::Log4perl</class> makes use of all appenders defined in the <class>Log::Dispatch</class> namespace, a separate set of modules, created by ''Dave Rolsky'' and others, all freely available on CPAN. There's appenders to write to the screen (<class>Log::Dispatch::Screen</class>), to a file (<class>Log::Dispatch::File</class>), to a database (<class>Log::Dispatch::DBI</class>), to send messages via e-mail (<class>Log::Dispatch::Email</class>), and many more.		<class>Log::Log4perl</class> makes use of all appenders defined in the <class>Log::Dispatch</class> namespace<ref>Documentation to Log::Dispatch modules: [http://search.cpan.org/author/DROLSKY/Log-Dispatch-2.01/Dispatch.pm http://search.cpan.org/author/DROLSKY/Log-Dispatch-2.01/Dispatch.pm]</ref>, a separate set of modules, created by ''Dave Rolsky'' and others, all freely available on CPAN. There's appenders to write to the screen (<class>Log::Dispatch::Screen</class>), to a file (<class>Log::Dispatch::File</class>), to a database (<class>Log::Dispatch::DBI</class>), to send messages via e-mail (<class>Log::Dispatch::Email</class>), and many more.

	New appenders are defined using the <class>Log::Log4perl::Appender</class> class. The exact number and types of parameters required depends on the type of appender used, here's the syntax for one of the most common ones, the logfile appender, which appends its messages to a log file:		New appenders are defined using the <class>Log::Log4perl::Appender</class> class. The exact number and types of parameters required depends on the type of appender used, here's the syntax for one of the most common ones, the logfile appender, which appends its messages to a log file:

Didier : /* Introduction */

2013-04-26T14:08:00Z

Introduction

← Version précédente		Version du 26 avril 2013 à 14:08
Ligne 10 :		Ligne 10 :
	However, with traditional logging systems, the amount of data written to the logs can be overwhelming. In fact, turning on low-level-logging on a system under heavy load can cause it to slow down to a crawl or even crash.		However, with traditional logging systems, the amount of data written to the logs can be overwhelming. In fact, turning on low-level-logging on a system under heavy load can cause it to slow down to a crawl or even crash.

	<class>Log::Log4perl</class> is different. It is a pure Perl port of the widely popular Apache/Jakarta <class>log4j</class><nowiki> library [3] for Java, a project made public in 1999, which has been actively supported and enhanced by a team around head honcho </nowiki>''Ceki Gülcü'' during the years.		<class>Log::Log4perl</class><ref>The <class>Log::Log4perl</class> documentation: [http://log4perl.sourceforge.net/releases/Log-Log4perl/docs/html/Log/Log4perl.html http://log4perl.sourceforge.net/releases/Log-Log4perl/docs/html/Log/Log4perl.html]</ref> is different. It is a pure Perl port of the widely popular Apache/Jakarta <class>log4j</class><nowiki> library [3] for Java, a project made public in 1999, which has been actively supported and enhanced by a team around head honcho </nowiki>''Ceki Gülcü'' during the years.

	The comforting facts about <class>log4j</class> are that it's really well thought out, it's the alternative logging standard for Java and it's been in use for years with numerous projects. If you don't like Java, then don't worry, you're not alone -- the <class>Log::Log4perl</class> authors (yours truly among them) are all Perl ''hardliners'' who made sure <class>Log::Log4perl</class> is ''real'' Perl.		The comforting facts about <class>log4j</class> are that it's really well thought out, it's the alternative logging standard for Java and it's been in use for years with numerous projects. If you don't like Java, then don't worry, you're not alone -- the <class>Log::Log4perl</class> authors (yours truly among them) are all Perl ''hardliners'' who made sure <class>Log::Log4perl</class> is ''real'' Perl.

	In the spirit of <class>log4j</class>, <class>Log::Log4perl</class> addresses the shortcomings of typical ad-hoc or homegrown logging systems by providing three mechanisms to control the amount of data being logged and where it ends up at:		In the spirit of <class>log4j</class><ref>The <class>log4j</class> project page on the Apache site: [http://jakarta.apache.org/log4j http://jakarta.apache.org/log4j]</ref>, <class>Log::Log4perl</class> addresses the shortcomings of typical ad-hoc or homegrown logging systems by providing three mechanisms to control the amount of data being logged and where it ends up at:

	* ''Levels'' allow you to specify the ''priority'' of log messages. Low-priority messages are suppressed when the system's setting allows for only higher-priority messages.		* ''Levels'' allow you to specify the ''priority'' of log messages. Low-priority messages are suppressed when the system's setting allows for only higher-priority messages.

Didier : /* Installation */

2013-04-26T14:04:55Z

Installation

← Version précédente		Version du 26 avril 2013 à 14:04
Ligne 450 :		Ligne 450 :
	<class>Log::Log4perl</class> is freely available from CPAN. It also requires the presence of two other modules, <class>Log::Dispatch</class> (2.00 or better, which is a bundle itself) and <class>Time::HiRes</class> (1.20 or better). If you're using the CPAN shell to install <class>Log::Log4perl</class>, then it will resolve these and other recursive dependencies for you automatically and download the required modules one by one from CPAN.		<class>Log::Log4perl</class> is freely available from CPAN. It also requires the presence of two other modules, <class>Log::Dispatch</class> (2.00 or better, which is a bundle itself) and <class>Time::HiRes</class> (1.20 or better). If you're using the CPAN shell to install <class>Log::Log4perl</class>, then it will resolve these and other recursive dependencies for you automatically and download the required modules one by one from CPAN.

	At the time this article went to print, 0.22 was the stable release of <class>Log::Log4perl</class~~><nowiki~~>, available from project page<ref>The project page on SourceForge: [http://log4perl.sourceforge.net/ http://log4perl.sourceforge.net]</ref> and CPAN. Also on ~~[1]~~, the CVS source tree is publicly available for those who want the (sometimes shaky) bleeding development edge. The CPAN releases, on the other hand are guaranteed to be stable.~~</nowiki>~~		At the time this article went to print, 0.22 was the stable release of <class>Log::Log4perl</class>, available from project page<ref>The project page on SourceForge: [http://log4perl.sourceforge.net/ http://log4perl.sourceforge.net]</ref> and CPAN. Also on, the CVS source tree is publicly available for those who want the (sometimes shaky) bleeding development edge. The CPAN releases, on the other hand are guaranteed to be stable.

	If you have questions, requests for new features, or if you want to contribute a patch to <class>Log::Log4perl</class>, then please send them to our mailing list at [mailto:log4perl-devel@lists.sourceforge.net log4perl-devel@lists.sourceforge.net] on SourceForge.		If you have questions, requests for new features, or if you want to contribute a patch to <class>Log::Log4perl</class>, then please send them to our mailing list at [mailto:log4perl-devel@lists.sourceforge.net log4perl-devel@lists.sourceforge.net] on SourceForge.

Didier : /* Installation */

2013-04-26T14:01:22Z

Installation

← Version précédente		Version du 26 avril 2013 à 14:01
Ligne 450 :		Ligne 450 :
	<class>Log::Log4perl</class> is freely available from CPAN. It also requires the presence of two other modules, <class>Log::Dispatch</class> (2.00 or better, which is a bundle itself) and <class>Time::HiRes</class> (1.20 or better). If you're using the CPAN shell to install <class>Log::Log4perl</class>, then it will resolve these and other recursive dependencies for you automatically and download the required modules one by one from CPAN.		<class>Log::Log4perl</class> is freely available from CPAN. It also requires the presence of two other modules, <class>Log::Dispatch</class> (2.00 or better, which is a bundle itself) and <class>Time::HiRes</class> (1.20 or better). If you're using the CPAN shell to install <class>Log::Log4perl</class>, then it will resolve these and other recursive dependencies for you automatically and download the required modules one by one from CPAN.

	At the time this article went to print, 0.22 was the stable release of <class>Log::Log4perl</class><nowiki>, available from [1] and CPAN. Also on [1], the CVS source tree is publicly available for those who want the (sometimes shaky) bleeding development edge. The CPAN releases, on the other hand are guaranteed to be stable.</nowiki>		At the time this article went to print, 0.22 was the stable release of <class>Log::Log4perl</class><nowiki>, available from project page<ref>The project page on SourceForge: [http://log4perl.sourceforge.net/ http://log4perl.sourceforge.net]</ref> and CPAN. Also on [1], the CVS source tree is publicly available for those who want the (sometimes shaky) bleeding development edge. The CPAN releases, on the other hand are guaranteed to be stable.</nowiki>

	If you have questions, requests for new features, or if you want to contribute a patch to <class>Log::Log4perl</class>, then please send them to our mailing list at [mailto:log4perl-devel@lists.sourceforge.net log4perl-devel@lists.sourceforge.net] on SourceForge.		If you have questions, requests for new features, or if you want to contribute a patch to <class>Log::Log4perl</class>, then please send them to our mailing list at [mailto:log4perl-devel@lists.sourceforge.net log4perl-devel@lists.sourceforge.net] on SourceForge.

Didier : /* Infos */

2013-04-26T13:58:00Z

Infos

← Version précédente		Version du 26 avril 2013 à 13:58
Ligne 466 :		Ligne 466 :

	== Infos ==		== Infos ==
	~~'''<nowiki>[1]</nowiki>''' The <class>log4perl</class> project page on SourceForge: [http://log4perl.sourceforge.net/ http://log4perl.sourceforge.net]~~		<references/>

	~~'''<nowiki>[2]</nowiki>''' The <class>Log::Log4perl~~</~~class~~> ~~documentation: [http://log4perl.sourceforge.net/releases/Log-Log4perl/docs/html/Log/Log4perl.html http://log4perl.sourceforge.net/releases/Log-Log4perl/docs/html/Log/Log4perl.html]~~

	~~'''<nowiki>[3]</nowiki>''' The <class>log4j</class> project page on the Apache site: [http://jakarta.apache.org/log4j http://jakarta.apache.org/log4j]~~

	'''<nowiki>[4]</nowiki>''' Documentation to Log::Dispatch modules: [http://search.cpan.org/author/DROLSKY/Log-Dispatch-2.01/Dispatch.pm http://search.cpan.org/author/DROLSKY/Log-Dispatch-2.01/Dispatch.pm]
	{{author\|Michael Schilli}}		{{author\|Michael Schilli}}

Didier : /* Listing 2: eat.pl */

2013-04-26T13:53:04Z

Listing 2: eat.pl

← Version précédente		Version du 26 avril 2013 à 13:53
Ligne 241 :		Ligne 241 :
	"Log::Dispatch::File",		"Log::Dispatch::File",
	filename => "test.log",		filename => "test.log",
	mode ~~<nowiki>~~=> "append",~~</nowiki>~~		mode => "append",
	);		);

Didier : /* Appenders */

2013-04-26T13:52:30Z

Appenders

← Version précédente		Version du 26 avril 2013 à 13:52
Ligne 185 :		Ligne 185 :
	"Log::Dispatch::File",		"Log::Dispatch::File",
	filename => "test.log",		filename => "test.log",
	mode ~~<nowiki>~~=> "append",~~</nowiki>~~		mode => "append",
	);		);

Didier : Page créée avec « '''Retire your debugger, log smartly with Log::Log4perl!''' == Introduction == You've rolled out an application and it produces mysterious, sporadic errors? That's pretty... »

2013-04-26T10:37:16Z

Page créée avec « '''Retire your debugger, log smartly with Log::Log4perl!''' == Introduction == You've rolled out an application and it produces mysterious, sporadic errors? That's pretty... »

Voir les modifications

Perl/Log4perl - Historique des versions

Didier : /* Listing 1: drink.pl */

Didier : /* Listing 2: eat.pl */

Didier : /* Appenders */

Didier : /* Introduction */

Didier : /* Installation */

Didier : /* Installation */

Didier : /* Infos */

Didier : /* Listing 2: eat.pl */

Didier : /* Appenders */

Didier : Page créée avec « '''Retire your debugger, log smartly with Log::Log4perl!''' == Introduction == You've rolled out an application and it produces mysterious, sporadic errors? That's pretty... »

Didier : /* Listing 1: drink.pl */

Didier : /* Listing 2: eat.pl */

Didier : /* Appenders */

Didier : /* Introduction */

Didier : /* Installation */

Didier : /* Installation */

Didier : /* Infos */

Didier : /* Listing 2: eat.pl */

Didier : /* Appenders */

Didier : Page créée avec « '''Retire your debugger, log smartly with Log::Log4perl!''' == Introduction == You've rolled out an application and it produces mysterious, sporadic errors? That's pretty... »