https://github.com/fujin/rsyslog-zeromq

zeromq input and output modules for rsyslog
https://github.com/fujin/rsyslog-zeromq

Last synced: 3 months ago
JSON representation

zeromq input and output modules for rsyslog

• Host: GitHub
• URL: https://github.com/fujin/rsyslog-zeromq
• Owner: fujin
• License: lgpl-3.0
• Fork: true (aggregateknowledge/rsyslog-zeromq)
• Created: 2012-04-12T22:22:33.000Z (over 12 years ago)
• Default Branch: master
• Last Pushed: 2012-02-24T22:06:14.000Z (over 12 years ago)
• Last Synced: 2024-07-19T22:41:59.865Z (4 months ago)
• Language: C
• Homepage:
• Size: 99.6 KB
• Stars: 2
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.markdown
  • License: COPYING

Awesome Lists containing this project

README

        
rsyslog-zeromq

================================================================

ZeroMQ input and output modules for rsyslog.

This module allows rsyslog to read and write ZeroMQ messages.

# Installing rsyslog-zeromq

Tested with rsyslog-5.8.0.

0. Install zeromq, will need headers and devel libraries ...

1. Apply the patch 'rsyslog-zeromq.patch' to the source of rsyslog:

        cd path/to/rsyslog-5.8.0

        patch -p1 -i rsyslog-zeromq.patch

2. Copy imzeromq and omzeromq directories to plugins directory of

   rsyslog source.

        rsync -av {i,o}mzeromq path/to/rsyslog-5.8.0/plugins

3. Regenerate autotools related files:

        cd path/to/rsyslog-5.8.0

        autoreconf

4. Add '--enable-imzeromq' and '--enable-omzeromq' to ./configure

   switches.

        ./configure \

        --enable-imzeromq \

        --enable-omzeromq \

        

5. Build and install.

        cd path/to/rsyslog-5.8.0

        make

        make install

# Configuring the output module (omzeromq)

The :omzeromq: selector takes the following parameter components:

* connect=<endpoint>    Connect to the specified endpoint.

* bind=<endpoint>       Bind to the specified endpoint.

* identity=<identstr>   Sets the identity of the socket.

* hwm=<NNN>             Sets the high water mark of the socket.

* swap=<NNN>            Sets the swap value for the socket.

* threads=<N>           Sets the number of zeromq context threads.

* pattern=<patternstr>  Sets the messaging pattern (push or pub).

The format for the selector may be specified in the standard way with

a trailing ";<FORMAT>" specifier.

Examples:

        $ModLoad omzeromq.so

        

        # Minimal configuration:

        *.* :omzeromq:bind=tcp://*:5557

        

        # Full config, all parameters specified:

        *.* :omzeromq:bind=tcp://*:5557,hwm=1000,swap=9999,identity=foobar,threads=1;RSYSLOG_ForwardFormat

# Configuring the input module (imzeromq)

The $InputZeroMQServerRun directive takes the following parameter components:

* connect=<endpoint>    Connect to the specified endpoint.

* bind=<endpoint>       Bind to the specified endpoint.

* identity=<identstr>   Sets the identity of the socket.

* pattern=<patternstr>  Sets the messaging pattern (pull or sub).

* subscribe=<filterstr> Sets a subscription filter.

Examples:

        $ModLoad imzeromq.so

        

        $RuleSet Events

        

        ... ruleset definition here ...

        

        # Provides ZeroMQ reception on a PULL socket.

        $InputZeroMQServerBindRuleset Events1

        $InputZeroMQServerRun  pattern=pull,connect=tcp://*:5557,identity=yoyo

        # Subscribe to all records from a SUB socket (empty filter string)

        $InputZeroMQServerBindRuleset Events2

        $InputZeroMQServerRun  pattern=sub,connect=tcp://*:5557,subscribe=,

        # Subscribe to just "foo" and "bar" records.

        $InputZeroMQServerBindRuleset Events3

        $InputZeroMQServerRun  pattern=sub,connect=tcp://*:5557,subscribe=foo,subscribe=bar