RELP Output Module (omrelp)

Module Name: omrelp

Author: Rainer Gerhards <rgerhards@adiscon.com>

Description:

This module supports sending syslog messages over the reliable RELP protocol. For RELP's advantages over plain tcp syslog, please see the documentation for imrelp (the server counterpart).

Setup

Please note the librelp is required for imrelp (it provides the core relp protocol implementation).

Configuration Directives:

This module uses old-style action configuration to keep consistent with the forwarding rule. So far, no additional configuration directives can be specified. To send a message via RELP, use

*.* :omrelp:<sever>:<port>;<template>

just as you use

*.* @@<sever>:<port>;<template>

to forward a message via plain tcp syslog.

Caveats/Known Bugs:

See imrelp, which documents them.

Sample:

The following sample sends all messages to the central server "centralserv" at port 2514 (note that that server must run imrelp on port 2514). Rsyslog's high-precision timestamp format is used, thus the special "RSYSLOG_ForwardFormat" (case sensitive!) template is used.

Note: to use IPv6 addresses, encode them in [::1] format.

[rsyslog.conf overview] [manual index] [rsyslog site]