From 601d85f8e6655c66d88bc4613c4706c64388b7bd Mon Sep 17 00:00:00 2001
From: Alessio Treglia <quadrispro@ubuntu.com>
Date: Fri, 3 Jul 2015 12:07:38 +0100
Subject: [PATCH] Create logging.md

Needless to say, this need review.
---
 docs/logging.md | 14 ++++++++++++++
 1 file changed, 14 insertions(+)
 create mode 100644 docs/logging.md

diff --git a/docs/logging.md b/docs/logging.md
new file mode 100644
index 000000000..102b06a9b
--- /dev/null
+++ b/docs/logging.md
@@ -0,0 +1,14 @@
+# Events
+
+Docker provides an _events_ command to show system's real time events. Likewise, Dokku can record events as syslog entries and also provides a plugin to display the last ones.
+
+```
+events [-t]                                     Show the last events (-t follows)
+events:list                                     List logged events
+events:on                                       Enable events logger
+events:off                                      Disable events logger
+```
+
+## System logs
+
+The _events_ plugin writes log entries to ``/var/log/syslog`` as well as a Dokku-specific logs sub-directory ``/var/log/dokku/events.log``.