Log::Agent::Driver::Default(3pm)

Log::Agent::Driver::Default3pm

Default logging driver for log::agent

Usage

 # Implicit use
 use Log::Agent;
 logconfig(-prefix => "prefix");   # optional
 # Explicit use
 use Log::Agent;
 require Log::Agent::Driver::Default;
 my $driver = Log::Agent::Driver::Default->make("prefix");
 logconfig(-driver => $driver);

Overview

The default logging driver remaps the logxxx() operations to their default Perl counterpart. For instance, logerr() will issue a warn() and logwarn() will call warn() with a clear "WARNING: " emphasis (to distinguish between the two calls).

The only routine of interest here is the creation routine:

make($prefix)

Create a Log::Agent::Driver::Default driver whose prefix string will be $prefix. When no prefix is configured, the first letter of each logged string will be uppercased.

Channels

The "error", "output" and "debug" channels all go to STDERR.

Releases

12 releases since Debian 3.0 (Woody); the text changed 7 times.

  1. 3.0
  2. 3.1
  3. 4.0–5.0
  4. 6.0–7
  5. 8
  6. 9–10
  7. 11
  8. 12–13

Bugs

If logdie() is used within an eval(), the string you will get in $@ will be prefixed. It's not really a bug, simply that wrapping a code into eval() and parsing $@ is poor's man exception handling which shows its limit here: since the programmer using logdie() cannot foresee which driver will be used, the returned string cannot be determined precisely. Morality: use die() if you mean it, and document the string as an exception.

Author

Raphael Manfredi <[email protected]>

From liblog-agent-perl 1.005-2 in Debian 13 (Trixie). Parsed by carta from the page's man source.