You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@camel.apache.org by bu...@apache.org on 2013/05/21 15:19:22 UTC

svn commit: r862616 - in /websites/production/camel/content: cache/main.pageCache camel-2120-release.html tracer.html

Author: buildbot
Date: Tue May 21 13:19:22 2013
New Revision: 862616

Log:
Production update by buildbot for camel

Modified:
    websites/production/camel/content/cache/main.pageCache
    websites/production/camel/content/camel-2120-release.html
    websites/production/camel/content/tracer.html

Modified: websites/production/camel/content/cache/main.pageCache
==============================================================================
Binary files - no diff available.

Modified: websites/production/camel/content/camel-2120-release.html
==============================================================================
--- websites/production/camel/content/camel-2120-release.html (original)
+++ websites/production/camel/content/camel-2120-release.html Tue May 21 13:19:22 2013
@@ -120,7 +120,7 @@
 
 
 <h2><a shape="rect" name="Camel2.12.0Release-Changesthatmayaffectendusers"></a>Changes that may affect end users</h2>
-<ul><li>The <a shape="rect" href="file2.html" title="File2">File</a> and <a shape="rect" href="ftp2.html" title="FTP2">FTP</a> consumers when using idempotent repository will no longer invoke <tt>contains</tt> with a directory name; this has been changed to only be checked for files.</li><li>Shutting down using <a shape="rect" href="graceful-shutdown.html" title="Graceful Shutdown">Graceful Shutdown</a> now requires the timeout value to be positive. And improved logic to avoid getting stuck in waiting for inflight messages, and having counter go negative.</li><li><a shape="rect" href="tracer.html" title="Tracer">Tracer</a> now requires explicitly to be enabled on <tt>CamelContext</tt> to be available and in use.</li></ul>
+<ul><li>The <a shape="rect" href="file2.html" title="File2">File</a> and <a shape="rect" href="ftp2.html" title="FTP2">FTP</a> consumers when using idempotent repository will no longer invoke <tt>contains</tt> with a directory name; this has been changed to only be checked for files.</li><li>Shutting down using <a shape="rect" href="graceful-shutdown.html" title="Graceful Shutdown">Graceful Shutdown</a> now requires the timeout value to be positive. And improved logic to avoid getting stuck in waiting for inflight messages, and having counter go negative.</li><li><a shape="rect" href="tracer.html" title="Tracer">Tracer</a> now requires explicitly to be enabled on <tt>CamelContext</tt> to be available and in use.</li><li>The class <tt>org.apache.camel.processor.interceptor.BacklogTracerInterceptor</tt> has been removed as it was no longer needed due internal optimizations.</li></ul>
 
 
 <h2><a shape="rect" name="Camel2.12.0Release-Importantchangestoconsiderwhenupgrading"></a>Important changes to consider when upgrading</h2>

Modified: websites/production/camel/content/tracer.html
==============================================================================
--- websites/production/camel/content/tracer.html (original)
+++ websites/production/camel/content/tracer.html Tue May 21 13:19:22 2013
@@ -85,6 +85,8 @@
 
 <div class="panelMacro"><table class="tipMacro"><colgroup span="1"><col span="1" width="24"><col span="1"></colgroup><tr><td colspan="1" rowspan="1" valign="top"><img align="middle" src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" width="16" height="16" alt="" border="0"></td><td colspan="1" rowspan="1"><b>Logging dependencies</b><br clear="none">Checkout which <a shape="rect" href="camel-jar-dependencies.html" title="Camel jar dependencies">dependencies</a> are required by Camel for logging purpose.</td></tr></table></div>
 
+<p>From <b>Camel 2.12</b> onwards you must explicit enable tracing on <a shape="rect" href="camelcontext.html" title="CamelContext">CamelContext</a> to use it. In XML DSL you do this by setting <tt>&lt;camelContext trace="true" ...&gt;</tt> and in Java you do <tt>camelContext.setTracing(true)</tt>.</p>
+
 <h3><a shape="rect" name="Tracer-Options"></a>Options</h3>
 <div class="confluenceTableSmall"><div class="table-wrap">
 <table class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1" class="confluenceTh"> Option </th><th colspan="1" rowspan="1" class="confluenceTh"> Default </th><th colspan="1" rowspan="1" class="confluenceTh"> Description </th></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> formatter </td><td colspan="1" rowspan="1" class="confluenceTd">&#160;</td><td colspan="1" rowspan="1" class="confluenceTd"> Sets the Trace Formatter to use. Will default use <tt>org.apache.camel.processor.interceptor.DefaultTraceFormatter</tt>. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> enabled </td><td colspan="1" rowspan="1" class="confluenceTd"> true </td><td colspan="1" rowspan="1" class="confluenceTd"> Flag to enable or disable this tracer </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> logLevel </td><td colspan="1" rowspan="1" class="confluenceTd"> <tt>INFO</tt> </td><td colspan="1" rowspan="1" class="confluenceTd"> The logging level to use: FA
 TAL, ERROR, WARN, INFO, DEBUG, TRACE, OFF </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> logName </td><td colspan="1" rowspan="1" class="confluenceTd">&#160;</td><td colspan="1" rowspan="1" class="confluenceTd"> The log name to use. Will default use <tt>org.apache.camel.processor.interceptor.TraceInterceptor</tt>.</td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> traceFilter </td><td colspan="1" rowspan="1" class="confluenceTd"> null </td><td colspan="1" rowspan="1" class="confluenceTd"> An exchange <a shape="rect" href="predicate.html" title="Predicate">Predicate</a> to filter the tracing. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> traceInterceptors </td><td colspan="1" rowspan="1" class="confluenceTd"> false </td><td colspan="1" rowspan="1" class="confluenceTd"> Flag to enable or disable tracing of interceptors </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> traceExceptions </td><td colspan="1" rowspan="1" 
 class="confluenceTd"> true</td><td colspan="1" rowspan="1" class="confluenceTd"> Flag to enable or disable tracing of thrown exception during processing of the exchange </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> traceOutExchanges </td><td colspan="1" rowspan="1" class="confluenceTd"> false </td><td colspan="1" rowspan="1" class="confluenceTd"> Flag to enable fine grained tracing with a callback for both IN (before) and OUT (after). Is disabled by default which means there is only one trace callback executed. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> logStackTrace </td><td colspan="1" rowspan="1" class="confluenceTd"> false </td><td colspan="1" rowspan="1" class="confluenceTd"> When tracing exception you can control whether the stack trace should be logged also. If <b>not</b> then only the exception class and message is logged. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> useJpa </td><td colspan="1" rowspan="1" cla
 ss="confluenceTd"> false </td><td colspan="1" rowspan="1" class="confluenceTd"> To use a <tt>JpaTraceEventMessage</tt> from <b>camel-jpa</b> component as the <tt>TraceEventMessage</tt>. This requires that <b>camel-jpa.jar</b> is on the classpath. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> destinationUri </td><td colspan="1" rowspan="1" class="confluenceTd"> null </td><td colspan="1" rowspan="1" class="confluenceTd"> Optional destination uri to route <a shape="rect" class="external-link" href="http://camel.apache.org/maven/current/camel-core/apidocs/org/apache/camel/processor/interceptor/TraceEventExchange.html">TraceEventExchange</a> containing <a shape="rect" class="external-link" href="http://camel.apache.org/maven/current/camel-core/apidocs/org/apache/camel/processor/interceptor/TraceEventMessage.html">TraceEventMessage</a> with details about the trace. Can be used for custom processing to store traces in database using <a shape="rect" href="jpa.html"
  title="JPA">JPA</a>. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> jpaTraceEventMessageClassName </td><td colspan="1" rowspan="1" class="confluenceTd"> null </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.3:</b> Fully class name for a custom  <tt>org.apache.camel.processor.interceptor.TraceEventMessage</tt> class which contains the traced information. For example you can use your custom JPA @Entity class to store traced information in a database according to your schema layout. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> traceHandler </td><td colspan="1" rowspan="1" class="confluenceTd"> null </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.3:</b> To use a custom <tt>org.apache.camel.processor.interceptor.TraceEventHandler</tt> where you can control what happens when a trace event occurs. </td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"> traceInterceptorFactory </td><td colspan="1" rowspa
 n="1" class="confluenceTd"> null </td><td colspan="1" rowspan="1" class="confluenceTd"> <b>Camel 2.3:</b> To use a custom <tt>org.apache.camel.processor.interceptor.TraceInterceptorFactory</tt> where you can create the runtime trace instance which does the actual tracing. It should be a <tt>Processor</tt> instance. The default tracer is implemented in the class <tt>org.apache.camel.processor.interceptor.TraceInterceptor</tt>. </td></tr></tbody></table>