Agent::Channel::Syslog(3p)

NAME
Log::Agent::Channel::Syslog - syslog logging channel for Log::Agent::Logger

SYNOPSIS
 require Log::Agent::Channel::Syslog;

 my $channel = Log::Agent::Channel::Syslog->make(
     # Specific attributes
     -prefix     => prefix,
     -facility   => "user",
     -showpid    => 1,
     -socktype   => { port => 514, type => "udp" },
     -logopt     => "ndelay",
 );

DESCRIPTION
The syslog logging channels directs operations to syslog() via the Sys::Syslog(3) interface.

The creation routine make() takes the following switches:

"-facility" => facility
    Tell syslog() which facility to use (e.g. "user", "auth", "daemon"). Unlike the Sys::Syslog(3) interface, the facility is set once and for all: every message logged through this channel will use the same facility.

"-logopt" => syslog options
    Specifies logging options, under the form of a string containing zero or more of the words ndelay, cons or nowait.

"-prefix" => prefix
    The prefix here is syslog's identification string.

"-showpid" => flag
    Set to true to have the PID of the process logged. It is false by default.

"-socktype" => options
    Configures the logging socket.

    The given options are passed without interpretation to "setlogsock()" hence refer to Sys::Sylog(3) for the exhaustive set of configuration options there.

    If you run "rsyslogd" over TCP on a non-standard port 60514 for instance, you could say:

            -socktype => { port => 60514, type => "tcp" }

    but there are many other configuration possibilities.

AUTHOR
Raphael Manfredi <Raphael_Manfredi@pobox.com>

SEE ALSO
Log::Agent::Logger(3), Sys::Syslog(3).