From b8b194c994725f7fdadc7bb4688a3af03f17aca9 Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Tue, 9 Jun 2015 16:24:45 +0200 Subject: [PATCH 1/4] add syslog page --- source/components/notify.syslog.markdown | 48 ++++++++++++++++++++++++ 1 file changed, 48 insertions(+) create mode 100644 source/components/notify.syslog.markdown diff --git a/source/components/notify.syslog.markdown b/source/components/notify.syslog.markdown new file mode 100644 index 00000000000..ef77b9a9fd4 --- /dev/null +++ b/source/components/notify.syslog.markdown @@ -0,0 +1,48 @@ +--- +layout: page +title: "Syslog notification support" +description: "Instructions how to add syslog notifications to Home Assistant." +date: 2015-06-09 16:00 +sidebar: false +comments: false +sharing: true +footer: true +--- + +The syslog platform allows you to deliver notifications from Home Assistant to the local syslog. + +To enable syslog notifications in your installation, add the following to your `configuration.yaml` file: + +```yaml +# Example configuration.yaml entry +notify: + platform: syslog + facility: SYSLOG_FACILITY + option: SYSLOG_LOG_OPTION + priority: SYSLOG_PRIORITY +``` + +| facility | option | priority | +| --------- |:-------:| ---------:| +| kernel | pid | 5 | +| user | cons | 4 | +| mail | ndelay | 3 | +| daemon | nowait | 2 | +| auth | perror | 1 | +| LPR | | 0 | +| news | | -1 | +| uucp | | -2 | +| cron | | | +| syslog | | | +| local0 | | | +| local1 | | | +| local2 | | | +| local3 | | | +| local4 | | | +| local5 | | | +| local6 | | | +| local7 | | | + +For details about facility, option, and priority please consulte the [wikpedia article](http://en.wikipedia.org/wiki/Syslog) and [RFC 3164](http://tools.ietf.org/html/rfc3164). + +To use notifications, please see the [getting started with automation page]({{site_root}}/components/automation.html). From eeb5eea919224a4b7946a9e3f19f2d61b7977476 Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Tue, 9 Jun 2015 16:36:56 +0200 Subject: [PATCH 2/4] add entry for syslog --- source/components/index.markdown | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/source/components/index.markdown b/source/components/index.markdown index fc87e875cd2..e616ad946f8 100644 --- a/source/components/index.markdown +++ b/source/components/index.markdown @@ -213,6 +213,12 @@ the manufacturers of these devices. Allow sending e-mail messages. + + +Syslog +Allow sending messages to a local syslog. + + Jabber (XMPP) From c94c562b5281d296670252cbfbf3b94f914bf6a5 Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Tue, 9 Jun 2015 16:37:23 +0200 Subject: [PATCH 3/4] add a line for the table --- source/components/notify.syslog.markdown | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/source/components/notify.syslog.markdown b/source/components/notify.syslog.markdown index ef77b9a9fd4..10a9ba76c91 100644 --- a/source/components/notify.syslog.markdown +++ b/source/components/notify.syslog.markdown @@ -22,8 +22,10 @@ notify: priority: SYSLOG_PRIORITY ``` +The table contains values to use in your `configuration.yaml` file. + | facility | option | priority | -| --------- |:-------:| ---------:| +| :-------- |:--------| :---------| | kernel | pid | 5 | | user | cons | 4 | | mail | ndelay | 3 | From e936d4c39915929576d946ac3e1d717920397949 Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Tue, 9 Jun 2015 16:39:55 +0200 Subject: [PATCH 4/4] fix typo --- source/components/notify.syslog.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/components/notify.syslog.markdown b/source/components/notify.syslog.markdown index 10a9ba76c91..d04ecfab058 100644 --- a/source/components/notify.syslog.markdown +++ b/source/components/notify.syslog.markdown @@ -45,6 +45,6 @@ The table contains values to use in your `configuration.yaml` file. | local6 | | | | local7 | | | -For details about facility, option, and priority please consulte the [wikpedia article](http://en.wikipedia.org/wiki/Syslog) and [RFC 3164](http://tools.ietf.org/html/rfc3164). +For details about facility, option, and priority please consult the [wikpedia article](http://en.wikipedia.org/wiki/Syslog) and [RFC 3164](http://tools.ietf.org/html/rfc3164). To use notifications, please see the [getting started with automation page]({{site_root}}/components/automation.html).