Syslog


Schemes	`syslog://`
Cargo feature	`service-syslog`
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}://
{schema}://{facility}

{schema} is one of syslog://.

URL tokens

Token	Meaning	Type	Required	Default	Notes
`{facility}`	Facility	choice	no	`user`	one of `kern`, `user`, `mail`, `daemon`, `auth`, `syslog`, `lpr`, `news`, `uucp`, `cron`, `local0`, `local1`, … (18 values)

Query parameters

Parameter	Meaning	Type	Default	Notes
`facility`	Facility	choice		sets `{facility}`
`logperror`	Log to STDERR	bool	`no`
`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):

syslog://
syslog://:@/
syslog://_/cron
syslog://kern?facility=d
syslog://_/?facility=local5
syslog://?logpid=no&logperror=yes

Rejected URLs:

syslog://_/?facility=invalid
syslog://notafacility

Send one from the command line:

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

Notes

Local syslog (syslog://): writes messages to the local syslog.

Writes the BSD-style datagram libc syslog would (<PRI>Mmm dd hh:mm:ss ident[pid]: msg) to the local syslog socket (/var/run/syslog on macOS, /dev/log elsewhere).

Differences with Apprise

logperror copies the line to stderr like LOG_PERROR.

Keyboard shortcuts