added rsyslog export documentation

Author: Matthew Fisher

docs/operations/index.rst

@@ -17,3 +17,4 @@ Operations Guide
     provision-controller
     register-admin-user
     deploy-formation
+    send-rsyslog-messages

docs/operations/send-rsyslog-messages.rst

@@ -0,0 +1,24 @@
+:title: Sending Logs to a Remote Syslog Server
+:description: Guide to dumping the deis cluster's logs to a remote Syslog server
+:keywords: tutorial, guide, walkthrough, howto, deis, sysadmins, operations, rsyslog
+
+.. _send-rsyslog-messages:
+
+Exporting Syslog Messages
+=========================
+
+In this document, we will demonstrate forwarding messages from Deis's syslog server to
+another one. This is used in a number of cases:
+
+- there is a legal requirement to consolidate all logs on a single system
+- the remote server needs to have a full picture of the cluster's activity to perform
+  correctly
+
+In our case, you can forward all messages from your Deis cluster to your remote syslog
+server by setting two keys in :ref:`Discovery`. SSH into your controller and run the
+following commands:
+
+.. code-block:: console
+
+    $ etcdctl set /deis/logger/remoteHost <your_remote_syslog_hostname>
+    $ etcdctl set /deis/logger/remotePort <your_remote_syslog_port>