systemd/systemd-netlogd

Name: systemd-netlogd

Owner: systemd

Description: Forwards messages from the journal to other hosts over the network using syslog format RFC 5424

Created: 2016-07-14 08:09:05.0

Updated: 2018-05-23 05:09:31.0

Pushed: 2018-05-23 05:09:30.0

Homepage:

Size: 202

Language: C

GitHub Committers

UserMost Recent Commit# Commits

Other Committers

UserEmailMost Recent Commit# Commits

README

systemd-netlogd

Forwards messages from the journal to other hosts over the network using the Syslog Protocol (RFC 5424). It can be configured to send messages to both unicast and multicast addresses. systemd-netlogd runs with own user systemd-journal-netlog. Starts sending logs when network is up and stops sending as soon as network is down (uses sd-network).


Installing from source

Install build dependencies:

# On Debian/Ubuntu
sudo apt install build-essential gperf libcap-dev libsystemd-dev pkg-config meson python3-sphinx
# On CentOS/RHEL/Fedora
sudo dnf group install 'Development Tools'
sudo dnf install gperf libcap-devel pkg-config systemd-devel meson python3-sphinx

Build and install:

make
sudo make install
sudo useradd -r -d / -s /usr/sbin/nologin -g systemd-journal systemd-journal-netlog
Configuration

systemd-networkd reads configuration files named /etc/systemd/systemd-netlogd.conf and /etc/systemd/systemd-netlogd.conf.d/*.conf.

[NETWORK] SECTION OPTIONS

   The "[Network]" section only applies for UDP multicast address and Port:

   Address=
       Controls whether log messages received by the systemd daemon shall be forwarded
       to a unicast UDP address or multicast UDP network group in syslog RFC 5424 format.

       The the address string format is similar to socket units. See systemd.socket(1)

   Optional settings

   StructuredData=
       Meta information about the syslog message, which can be used for Cloud Based
       syslog servers, such as Loggly

EXAMPLE

Example 1. /etc/systemd/systemd-netlogd.conf

[Network]
Address=239.0.0.1:6000

Example 2. /etc/systemd/systemd-netlogd.conf

[Network]
Address=192.168.8.101:514

Example 3. /etc/systemd/systemd-netlogd.conf

[Network]
Address=192.168.8.101:514
StructuredData=[1ab456b6-90bb-6578-abcd-5b734584aaaa@41058]

This work is supported by the National Institutes of Health's National Center for Advancing Translational Sciences, Grant Number U24TR002306. This work is solely the responsibility of the creators and does not necessarily represent the official views of the National Institutes of Health.