Alexander Hartmaier > Message-Passing-Syslog-0.009 > Message::Passing::Input::Syslog

Download:
Message-Passing-Syslog-0.009.tar.gz

Dependencies

Annotate this POD

View/Report Bugs
Source   Latest Release: Message-Passing-Syslog-0.011

NAME ^

Message::Passing::Input::Syslog - input messages from Syslog.

SYNOPSIS ^

    message-pass --input Syslog --input_options '{"port":"5140"}' --output STDOUT

DESCRIPTION ^

Provides a syslog server for UDP syslog.

Can be used to ship syslog logs into a Message::Passing system.

The message is a hashref:

    {
        epochtime     => 1366803118,
        facility_code => 19,
        facility      => 'error',
        severity_code => 3,
        severity      => 'local3',
        message       => 'the received syslog message',

        # depending on the remote_hostname attribute
        hostname      => 'syslog.company.tld' || '192.0.2.29',
    }

ATTRIBUTES ^

hostname

The IP to bind the daemon to. By default, binds to 127.0.0.1, which means that the server can only be accessed from localhost. Use 0.0.0.0 to bind to all interfaces.

port

The port to bind to, defaults to 5140, as the default syslog port (514) is likely already taken by your regular syslogd, and needs root permissio to bind to it.

protocol

The protocol to listen on, currently only UDP is supported.

remote_hostname

Set to true to store the remote ip address instead of the servers' hostname in the hostname attribute. Defaults to false for backward compatibility.

SEE ALSO ^

Message::Passing::Syslog
Message::Passing

AUTHOR, COPYRIGHT AND LICENSE ^

See Message::Passing::Syslog.

syntax highlighting: