Simple sending using rsyslog

This article describes how to manually configure rsyslog to send system log events to Devo over an unsecured channel. This is the recommended procedure when you want to forward events within your network to a relay.

1 The /etc/rsyslog.conf file
2 Create the Devo configuration files
3 Restart rsyslog
4 Test the connection

The /etc/rsyslog.conf file

It is advisable to have only the include directive on the /etc/rsyslog.conf file. Otherwise, it may lead to configuration errors.

/etc/rsyslog.conf

#
# http://www.rsyslog.com/doc/
#

# Include all config files in /etc/rsyslog.d/
include(file="/etc/rsyslog.d/*.conf")

Create the Devo configuration files

To forward a system’s internal logs to a Devo Relay, you need to create two files in the /etc/rsyslog.d/ directory. The 00-devo.conf file contains general connection settings. The 49-devo.conf file is responsible for forwarding the events to the Devo Relay.

00-devo.conf

This file contains general connection settings. Create it with the following contents.

/etc/rsyslog.d/00-devo.conf

module(
    load="imfile"
    mode="inotify"
)

module(
    load="immark"
    interval="60"
)

module(
    load="imuxsock"
    SysSock.RateLimit.Interval="0"
)

global(
    workDirectory="/var/spool/rsyslog"
)

Make sure that the workDirectory path exists and that the user running rsyslog (often syslog) has permissions over it. To find out which user runs rsyslog, enter the following command:

ps -ouser= $(pgrep rsyslogd)

If it is not root it is recommended to perform the below command. Please note that in some distributions it runs by default as root and in others, a drop of privileges to syslog user is performed..

49-devo.conf

The 49-devo.conf file forwards the operating system log events to the Devo Relay. Create the file with the following contents.

/etc/rsyslog.d/49-devo.conf

Replace the Target and Port values with your relay IP address and port.
The queue.type, queue.filename, queue.saveonshutdown and action.resumeRetryCount parameters are optional but recommended to prevent data loss in the event of a connectivity problem between the machine and the relay.

In case you have more configuration files in the /etc/rsyslog.d/ directory, this one should be sequentially one of the last ones. This is because this action has no filter, so it will forward every message. By making this one of the last files to be processed in this directory, you can prevent the duplication of logs.

You may want to list the files in /etc/rsyslog.d/ to review and confirm the run order:.

Restart rsyslog

After creating and saving the new files, restart rsyslog to activate the new configuration:

With the configuration activated, rsyslog should begin to forward events to your Devo Relay.

Test the connection

You can make sure that the events are being forwarded to the Relay by using the logger command to write testing messages to the system log.

In the Devo web application, go to Data search. Open the box.unix data table to confirm that these logger events were forwarded and received correctly.

7.13