Enable logging.conf & fluentd for nova

This change introduce ability to use log_config_append parameter with
new FluentdHandler to send logs directly to Fluentd.

To save per binary log streams as it is in the default logging states generates
separate logging.conf files per service and use /etc/default/<service name>
to pass dedicated logging.conf to every service.

Change-Id: I93f1838592b34d703bb60e823d11dbf33b98e3d5
Related-Prod: PROD-16324
diff --git a/README.rst b/README.rst
index c3a67f1..d6283be 100644
--- a/README.rst
+++ b/README.rst
@@ -644,6 +644,39 @@
     compute:
       max_concurrent_live_migrations: 1  # (1 is the default)
 
+Enhanced logging with logging.conf
+----------------------------------
+
+By default logging.conf is disabled.
+
+That is possible to enable per-binary logging.conf with new variables:
+  * openstack_log_appender - set it to true to enable log_config_append for all OpenStack services;
+  * openstack_fluentd_handler_enabled - set to true to enable FluentHandler for all Openstack services.
+
+Only WatchedFileHandler and FluentHandler is available.
+
+Also it is able to configure this with pillar:
+
+.. code-block:: yaml
+
+  nova:
+    controller:
+        logging:
+          log_appender: true
+          log_handlers:
+            watchedfile:
+              enabled: true
+            fluentd:
+              enabled: true
+
+    compute:
+        logging:
+          log_appender: true
+          log_handlers:
+            watchedfile:
+              enabled: true
+            fluentd:
+              enabled: true
 
 Documentation and Bugs
 ======================