From 494986be5a76446669c58bee0723ce8846629bf2 Mon Sep 17 00:00:00 2001 From: Chris Caron Date: Fri, 11 Oct 2019 21:22:03 -0400 Subject: [PATCH] Created Notify_syslog (markdown) --- Notify_syslog.md | 29 +++++++++++++++++++++++++++++ 1 file changed, 29 insertions(+) create mode 100644 Notify_syslog.md diff --git a/Notify_syslog.md b/Notify_syslog.md new file mode 100644 index 0000000..de87067 --- /dev/null +++ b/Notify_syslog.md @@ -0,0 +1,29 @@ +## Syslog Notifications +* **Source**: https://tools.ietf.org/html/rfc5424 +* **Icon Support**: No +* **Message Format**: Text +* **Message Limit**: 32768 Characters per message + +Syslog is a way for network devices to send event messages to a logging server – usually known as a Syslog server. The Syslog protocol is supported by a wide range of devices and can be used to log different types of events. + +### Syntax +Valid syntaxes are as follows: +* `syslog://` + +One might change the facility from it's default like so: +* `syslog://_/?facility=local5` + +### Parameter Breakdown +| Variable | Required | Description +| ----------- | -------- | ----------- +| facility | No | The facility to use, by default it is `user`. Valid options are **kern**, **user**, **mail**, **daemon**, **auth**, **syslog**, **lpr**, **news**, **uucp**, **cron**, **local0**, **local1**, **local2**, **local3**, **local4**, **local5**, **local6**, and **local7** +| log_perror | No | Additionally send the log message to _stderr_ +| log_pid | Yes | Include PID as part of the log output. + +#### Example +Send a Syslog notification +```bash +# The following sends a syslog notification to the `user` +# facility +apprise syslog:// +``` \ No newline at end of file