1 files changed, 17 insertions, 0 deletions
diff --git a/doc/source/admin/logging.inc b/doc/source/admin/logging.inc
new file mode 100644
index 000000000..abd6672e2
--- /dev/null
+++ b/doc/source/admin/logging.inc
@@ -0,0 +1,17 @@
+.. -*- rst -*-
+
+Logging
+=======
+
+You configure logging externally to the rest of Identity. The name of
+the file specifying the logging configuration is set using the
+``log_config_append`` option in the ``[DEFAULT]`` section of the
+``/etc/keystone/keystone.conf`` file. To route logging through syslog,
+set ``use_syslog=true`` in the ``[DEFAULT]`` section.
+
+A sample logging configuration file is available with the project in
+``etc/logging.conf.sample``. Like other OpenStack projects, Identity
+uses the `Python logging module`_, which provides extensive configuration
+options that let you define the output levels and formats.
+
+.. _`Python logging module`: https://docs.python.org/library/logging.html