pmnull: Syslog Null Parser Module

Author: Pascal Withopf <pascalwithopf1@gmail.com>

When a message is received it is tried to match a set of parsers to get properties populated. This parser module sets all attributes to “” but rawmsg. There usually should be no need to use this module. It may be useful to process certain known-not-syslog messages.

Parser Parameters

Note: parameter names are case-insensitive.

tag <string>

Default: Empty (“”)

This setting sets the tag value to the message.

syslogfacility <int>

Default: 1

This setting sets the syslog facility value. The default comes from the rfc3164 standard.

syslogseverity <int>

Default: 5

This setting sets the syslog severity value. The default comes from the rfc3164 standard.

Example

In this example messages are received through imtcp on port 13514. The ruleset uses the parser pmnull which has the parameters tag, syslogfacility and syslogseverity given.

module(load="imtcp")
module(load="pmnull")

input(type="imtcp" port="13514" ruleset="ruleset")
parser(name="custom.pmnull" type="pmnull" tag="mytag" syslogfacility="3"
       syslogseverity="1")

ruleset(name="ruleset" parser=["custom.pmnull", "rsyslog.pmnull"]) {
      action(type="omfile" file="rsyslog.out.log")
}

In this example the ruleset uses the parser pmnull with the default parameters because no specifics were given.

module(load="imtcp")
module(load="pmnull")

input(type="imtcp" port="13514" ruleset="ruleset")
parser(name="custom.pmnull" type="pmnull")

ruleset(name="ruleset" parser="custom.pmnull") {
      action(type="omfile" file="rsyslog.out.log")
}

See also

Help with configuring/using Rsyslog:

  • Mailing list - best route for general questions
  • GitHub: rsyslog source project - detailed questions, reporting issues that are believed to be bugs with Rsyslog
  • Stack Exchange (View, Ask) - experimental support from rsyslog community

See also

Contributing to Rsyslog: