Bug 9060: Minor mdsaltrace_config.xml /this/will/never/exist

[controller.git] / opendaylight / md-sal / mdsal-trace / api / src / main / resources / initial / mdsaltrace_config.xml

diff --git a/opendaylight/md-sal/mdsal-trace/api/src/main/resources/initial/mdsaltrace_config.xml b/opendaylight/md-sal/mdsal-trace/api/src/main/resources/initial/mdsaltrace_config.xml
index 8e17c8b5feefd16e5e9b4ea914ad0d95b858cb0f..27c8bddce0363b11b1ba7137efa5a4c873174d78 100644 (file)
--- a/opendaylight/md-sal/mdsal-trace/api/src/main/resources/initial/mdsaltrace_config.xml
+++ b/opendaylight/md-sal/mdsal-trace/api/src/main/resources/initial/mdsaltrace_config.xml
@@ -1,5 +1,21 @@
 <config xmlns="urn:opendaylight:params:xml:ns:yang:mdsaltrace">
+    <!--  Both registration-watches as well as write-watches will
+          log EVERYTHING by default, if we do not constrain any paths;
+          therefore we set a fake one to get nothing out-of-the-box;
+          please remove this first fake one when you configure this
+          to watch what you are really interested in instead: -->
+    <registration-watches>/this/will/never/exist</registration-watches>
     <!-- <registration-watches>/neutron-router-dpns/router-dpn-list</registration-watches> -->
     <!-- <registration-watches>/tunnels_state/state-tunnel-list</registration-watches> -->
+
+    <write-watches>/this/will/never/exist</write-watches>
     <!-- <write-watches> /NetworkTopology/Topology</write-watches> -->
+
+    <!-- Enable or disable transaction context debug. This will preserve the call site trace for
+         transactions, so that the original caller of un-close'd() transaction can be identified.
+         NB: This is a different property from the equally named one in etc/org.opendaylight.controller.cluster.datastore.cfg;
+         that one does something somewhat similar, but serves to include the stack trace on failed transaction submit,
+         whereas this one is specific to odl-mdsal-trace's trace:transaction leak troubleshooting command.
+         [This documentation has been copy/pasted from mdsaltrace.yang, and should be kept in line.] -->
+    <transaction-debug-context-enabled>true</transaction-debug-context-enabled>
 </config>