NAME¶
Log::Agent::Priorities - conversion between syslog priorities and levels
SYNOPSIS¶
Not intended to be used directly
DESCRIPTION¶
This package contains routines to convert between syslog priorities and logging
levels: level_from_prio("crit") yields 2, and
prio_from_level(4) yields "warning", as does
prio_from_level(5).
Here are the known priorities (which may be abbreviated to the first 2 letters,
in a case-insensitive manner) and their corresponding logging level:
Name Level Traditional Export
--------- ----- -------------- ------
none -1 NONE (special, see text)
emergency 0 (emerg, panic) EMERG
alert 1 ALERT
critical 2 (crit) CRIT
error 3 (err) ERROR
warning 4 WARN
notice 6 NOTICE
info 8 INFO
debug 10 DEBUG
The values between parenthesis show the traditional syslog priority tokens. The
missing levels (5, 7, 9) are there for possible extension. They currently map
to the level immediately below.
The Export column lists the symbolic constants defined by this package. They can
be imported selectively, or alltogether via the ":LEVELS" tag, as
in:
use Log::Agent::Priorities qw(:LEVELS);
The special token "none" may be used (and spelled out fully) on
special occasions: it maps to -1, and is convenient when specifying a logging
level, for instance: specifying "none" ensures that
no
logging will take place, even for emergency situations.
Anywhere where a
priority is expected, one may specify a number taken as
a logging level or a string taken as a priority. If the default mapping
outlined above is not satisfactory, it can be redefined by specifying, for
instance "notice:9". It will be taken as being of level 9, but with
a "notice" priority nonetheless, not "info" as it would
have been implicitely determined otherwise.
The routine
priority_level() decompiles "notice:9" into
("notice", 9), and otherwise uses
prio_from_level() or
level_from_prio() to compute the missing informatin. For instance,
given "critical",
priority_level() routine will return the
tuple ("critical", 2).
AUTHOR¶
Raphael Manfredi
<Raphael_Manfredi@pobox.com>
SEE ALSO¶
Log::Agent(3),
Log::Agent::Logger(3).