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><camelContext trace="true"
...></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"> </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"> </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>
![https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif"](https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif"){kind=link}