Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

...

...

...

...

...

...

...

...

...

...

Table of Contents
minLevel2
maxLevel7
typeflat

This article describes how to manually configure rsyslog to send events to Devo using an encrypted and authenticated channel. This is the recommended procedure when you want to forward events over the internet, directly to the Devo Cloud. The configuration files are just the same as the ones described in in Simple sending using rsyslog, but with the addition of some security-related settings.

Table of Contents
maxLevel1

Install rsyslog-gnutls

In order to use SSL/TLS with rsyslog, you need to install the rsyslog-gnutls package. 

Info

If you are running Ubuntu 8.2 stable or later, you can skip this step because you will already have this package. Run rsyslogd -version to check what version of Ubuntu you are running.


In DEB environments

In RPM environments


Code Block
apt install rsyslog-gnutls



Code Block
yum install rsyslog-gnutls


Download and save the certificates

  1. Go to Administration → Credentials → X.509 Certificates in the Devo web application. Download the Certificate, Private key, and Chain CA. Save them all to /etc/rsyslog.d/.

  2. Restrict the access permissions to these files to the syslog user:

    Code Block
    cd /etc/rsyslog.d/ chmod 640 ca.crt user.crt user.key chown :syslog ca.crt user.crt user.key
    
    -rw-r----- 1 root syslog 2090 Oct 24 13:02 ca.crt
    -rw-r----- 1 root syslog 1529 Oct 24 13:18 user.crt
    -rw-r----- 1 root syslog 1675 Oct 24 13:18 user.key
    


Create the Devo configuration files

You need to create two files in the the /etc/rsyslog.d/ directory 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.

The 00-devo.conf file

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

...

Again, the added/modified parameters are:

Parameter

Value

StreamDriver, StreamDriverMode, StreamDriverAuthMode

They must be gtls, 1 and x509/name, respectively.

StreamDriverPermittedPeers

It must have the same value as Target

Target

This is the host address for the Devo Cloud for the region you are using. It should be one of:

  • collector-us.devo.io

  • collector-us.devo.io

  • collector-es.devo.io

Restart rsyslog

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

...

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.