NAME
Log::Any::Adapter::Syslog - send Log::Any logs to syslog
VERSION
version 1.3
SYNOPSIS
use Log::Any::Adapter;
Log::Any::Adapter->set('Syslog');
# You can override defaults:
use Unix::Syslog qw{:macros};
Log::Any::Adapter->set(
'Syslog',
# name defaults to basename($0)
name => 'my-name',
# options default to LOG_PID
options => LOG_PID|LOG_PERROR,
# facility defaults to LOG_LOCAL7
facility => LOG_LOCAL7
);
DESCRIPTION
Log::Any is a generic adapter for writing logging into Perl modules; this adapter use the Unix::Syslog module to direct that output into the standard Unix syslog system.
CONFIGURATION
Log::Any::Adapter::Syslog
is designed to work out of the box with no
configuration required; the defaults should be reasonably sensible.
You can override the default configuration by passing extra arguments to the
Log::Any::Adapter
method:
- name
The name argument defaults to the basename of $0
if not supplied, and is
inserted into each line sent to syslog to identify the source.
- options
The options configure the behaviour of syslog; see Unix::Syslog for details.
The default is LOG_PID
, which includes the PID of the current process after
the process name:
example-process[2345]: something amazing!
The most likely addition to that is LOG_PERROR
which causes syslog to also
send a copy of all log messages to the controlling terminal of the process.
WARNING: If you pass a defined value you are setting, not augmenting, the
options. So, if you want LOG_PID
as well as other flags, pass them all.
- facility
The facility determines where syslog sends your messages. The default is
LOCAL7
, which is not the most useful value ever, but is less bad that
assuming the fixed facilities.
See Unix::Syslog and L for details on the available facilities.
AUTHORS
- Daniel Pittman daniel@rimspace.net
COPYRIGHT AND LICENSE
Copyright 2010 by Daniel Pittman daniel@rimspace.net
Log::Any::Adapter::Syslog is provided "as is" and without any express or implied warranties, including, without limitation, the implied warranties of merchantibility and fitness for a particular purpose.
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.