Remote Syslog


Schemes	`rsyslog://`
Cargo feature	`service-rsyslog`
Service	https://tools.ietf.org/html/rfc5424
Body formats	`text` (first is the default)
Attachments	no
Title length	250 characters
Body length	32,768 characters
Body lines	unlimited
Request throttle	none
Vendor URLs accepted	no

URL formats

{schema}://{host}
{schema}://{host}:{port}
{schema}://{host}/{facility}
{schema}://{host}:{port}/{facility}

{schema} is one of rsyslog://.

URL tokens

Token	Meaning	Type	Required	Default	Notes
`{facility}`	Facility	choice	yes	`user`	one of `kern`, `user`, `mail`, `daemon`, `auth`, `syslog`, `lpr`, `news`, `uucp`, `cron`, `local0`, `local1`, … (18 values)
`{host}`	Hostname	string	yes
`{port}`	Port	int, 1 to 65535	no	`514`

Query parameters

Parameter	Meaning	Type	Default	Notes
`facility`	Facility	choice		sets `{facility}`
`logpid`	Log PID	bool	`yes`

The common URL parameters (format, overflow, verify, redirect, cto, rto, retry, wait, store, tag, tz, user, password, port, optional, emojis) apply as well.

Examples

Accepted URLs (tokens are fake):

rsyslog://localhost
rsyslog://localhost/kern
rsyslog://localhost/kern/cron
rsyslog://localhost:9000/d?logpid=no
rsyslog://localhost/?facility=local5

Rejected URLs:

rsyslog://localhost/?facility=invalid

Send one from the command line:

mercurio -t 'Backup' -b 'Finished in 42s' 'rsyslog://localhost'

Notes

Remote syslog over UDP (rsyslog://): syslog messages to a remote host.

Payload: <PRI>- {pid} {message} (or <PRI>- {message} without logpid).

Differences with Apprise

Apprise computes PRI as level + facility * 8 with already shifted facility constants (user.info becomes <70>), while mercurio sends the RFC 5424 value (<14>).

Keyboard shortcuts