Syslog Configuration

Syslog support is implemented by Syslog plugin. It is configured via Syslog node of Drivers/Plugin item in the System Tree.

The Syslog configuration includes Syslog Server Configuration and Syslog Message Sources Automatic Discovery settings described below. Note that Iotellect Server should be restarted to apply changes.

Syslog Monitoring Configuration

This table includes Syslog messages monitoring and consolidation parameters.

Property

Description

Enabled

Enables/disables Syslog messages monitoring.

UDP

Enables/disables using UDP for receiving Syslog messages.

TCP

Enables/disables using TCP for receiving Syslog messages.

Syslog Port

Specifies port to listen Syslog messages at.

UDP Socket Receive Buffer Size

Determines the size of the buffer allocated for receiving UDP packets. In systems handling bursts of incoming syslog messages, this should be set large enough to store all messages in a typical burst.

Buffer Size for Each UDP Datagram

Specifies the size of the buffer allocated for each individual UDP datagram received on the socket. Buffer should be configured to be larger than the largest expected datagram in order to ensure each message is received and processed without being truncated or lost.

Severity Conversion Table

Syslog severity level to Iotellect severity level mapping. See below.

Be sure to sufficiently increase the Buffer Size for Each UDP Datagram when Syslog messages are expected to carry large payloads, for example, JSON documents.

Severity Level Conversion

The Severity Conversion Table is used to calculate level of the generated %ag%> event based on original Syslog message severity level. See Syslog Events Monitoring and Consolidation for details about Syslog event generation.

The table maps each of the Syslog severity level values (as specified in RFC 5424) to an Iotellect severity level (see Event Levels section). If a Syslog severity value is absent in the table, the resulting Iotellect event level is None (code 0).

By default the table is specified as follows:

Syslog Severity Level

Iotellect Event Severity

Code

Name

Description

Code

Level

7

Debug

Debug-level message

1

Notice

6

Informational

Informational message

2

Info

5

Notice

Normal but significant condition

2

Info

4

Warning

Warning conditions

3

Warning

3

Error

Error conditions

4

Error

2

Critical

Critical conditions

4

Error

1

Alert

Action must be taken immediately

4

Error

0

Emergency

System is unusable

5

Fatal

This table can be modified to provide a desired conversion procedure.

Syslog Message Sources Automatic Discovery

This flag enables or disables automatic discovery of hosts sending Syslog messages to the Iotellect server.

Was this page helpful?