summaryrefslogtreecommitdiffstats
path: root/docs/drools/feature_controllerlogging.rst
diff options
context:
space:
mode:
authorSaryu Shah <ss3917@att.com>2019-06-03 16:23:04 +0000
committerSaryu Shah <ss3917@att.com>2019-06-03 16:27:51 +0000
commitf96ef833d3b00f84639b712579d6e2824e6063b4 (patch)
tree7bd13b47fb88e8b4859e55ad5c8629cebd7eadcd /docs/drools/feature_controllerlogging.rst
parent1000b605908e4ff18e5a077026d5eadbc0ae46d8 (diff)
Create Drools PDP documentation - features
Create Drools PDP documentation in parent - features Change-Id: Ie710842a7921fd46ffdef4628d50637093111cc8 Issue-ID: POLICY-1678 Signed-off-by: Saryu Shah <ss3917@att.com>
Diffstat (limited to 'docs/drools/feature_controllerlogging.rst')
-rw-r--r--docs/drools/feature_controllerlogging.rst50
1 files changed, 50 insertions, 0 deletions
diff --git a/docs/drools/feature_controllerlogging.rst b/docs/drools/feature_controllerlogging.rst
new file mode 100644
index 00000000..0677030e
--- /dev/null
+++ b/docs/drools/feature_controllerlogging.rst
@@ -0,0 +1,50 @@
+
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+
+***************************
+Feature: Controller Logging
+***************************
+
+.. contents::
+ :depth: 3
+
+Summary
+^^^^^^^
+The controller logging feature provides a way to log network topic messages to a separate controller log file for each controller. This allows a clear separation of network traffic between all of the controllers.
+
+Enabling Controller Logging
+^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Type "features enable controller-logging". The feature will now display as "enabled".
+
+ .. image:: ctrlog_enablefeature.png
+
+When the feature's enable script is executed, it will search the $POLICY_HOME/config directory for any logback files containing the prefix "logback-include-". These logger configuration files are typically provided with a feature that installs a controlloop (ex: controlloop-amsterdam and controlloop-casablanca features). Once these configuration files are found by the enable script, the logback.xml config file will be updated to include the configurations.
+
+ .. image:: ctrlog_logback.png
+
+
+Controller Logger Configuration
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+The contents of a logback-include-``*``.xml file follows the same configuration syntax as the logback.xml file. It will contain the configurations for the logger associated with the given controller.
+
+ .. note:: A controller logger MUST be configured with the same name as the controller (ex: a controller named "casablanca" will have a logger named "casablanca").
+
+ .. image:: ctrlog_config.png
+
+
+Viewing the Controller Logs
+^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Once a logger for the controller is configured, start the drools-pdp and navigate to the $POLICY_LOGS directory. A new controller specific network log will be added that contains all the network topic traffic of the controller.
+
+ .. image:: ctrlog_view.png
+
+The original network log remains and will append traffic information from all topics regardless of which controller it is for. To abbreviate and customize messages for the network log, refer to the `Feature MDC Filters <feature_mdcfilters.html>`_ documentation.
+
+
+End of Document
+
+