Author: buildbot
Date: Mon May 29 19:19:42 2017
New Revision: 1013115
Log:
Production update by buildbot for camel
Modified:
websites/production/camel/content/cache/main.pageCache
websites/production/camel/content/camel-2200-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-2200-release.html
==============================================================================
--- websites/production/camel/content/camel-2200-release.html (original)
+++ websites/production/camel/content/camel-2200-release.html Mon May 29
19:19:42 2017
@@ -91,7 +91,7 @@
<div style="min-height:200px"> </div>
-<h2 id="Camel2.20.0Release-NewandNoteworthy">New and Noteworthy</h2><p>Welcome
to the x.y.z release which approx XXX issues resolved (new features,
improvements and bug fixes such as...)</p><ul><li>Many internal optimisations
in the Camel routing engine, such as reducing thread contention when updating
JMX statistics, reducing internal state objects to claim less memory, and
reducing the number of allocated objects to reduce overhead on GC etc, and much
more. </li><li>The <a shape="rect" class="external-link"
href="https://github.com/apache/camel/blob/master/tooling/maven/camel-maven-plugin/src/main/docs/camel-maven-plugin.adoc"
rel="nofollow">Camel Maven Plugin</a> can now validate for duplicate route ids
in your source code.</li><li>Splitted <a shape="rect"
href="twitter.html">Twitter</a> component into 4, now directmessage,
seach, streaming and timeline has its own endpoint and scheme. See <a
shape="rect" class="external-link" href="https://github.com/apache/c
amel/blob/master/components/camel-twitter/src/main/docs/twitter.adoc"
rel="nofollow">documentation</a> for more
details</li><li>Introduced <code>HeadersMapFactory</code> SPI which allows
to plugin different implementations, or to use case sensitive maps that are
faster than the default.</li><li>Allow <a shape="rect"
href="kafka.html">Kafka</a> consumer to break on first unhandled exception,
sync the offset from last known good, and then re-connect after one timeout
cycle, to restart consuming again. This avoids loosing the failed message, but
retry it again on either this consumer, or another consume which was
re-balanced by Kafka. This requires to be turned on with the new option
breakOnFirstError which can be set on both component or endpoint
level.</li><li>Starting and stoping the CamelContext when used with Spring
framework (SpringCamelContext) was revised to ensure that the Camel context is
started last - when all resources should be available, and stopped first
- while all resources are still available</li><li>Tracing via <a
shape="rect" href="tracer.html">Tracer</a> has been refactored to be using
the <a shape="rect" href="message-history.html">Message History</a> EIP
which allows Camel to use same logic instead of doing twice the tracing/capture
during runtime. This reduced the memory footprint.</li></ul><p>Fixed these
issues</p><ul><li>Fixed a infinitive recursion in Camel's <a shape="rect"
href="error-handler.html">Error Handler</a> when an onException was routing to
another route using direct endpoint and this route would throw a new exception
that would circle back to the same onException or at a later point, which will
cause an endless recursion.</li><li>Fixed a potential issue with masking
password from URI using RAW(xxx) would reveal part of the password if the
password contains a & character.</li><li>The <a shape="rect"
href="restlet.html">Restlet</a> component is now internally using curly
brackets f
or its uri patterns instead of regular parentheses so it works similar to the
other REST component and as Restlet framework itself does</li><li>Fixed <a
shape="rect" href="hystrix-eip.html">Hystrix EIP</a> having wrong default for
circuitBreakerForceClose when using camel-hystrix-starter with Spring Boot. The
default should be false and not true</li><li>Fixed <a shape="rect"
href="hystrix-eip.html">Hystrix EIP</a> when failing and running fallback not
signaling to Hystrix itself so it can keep state of the failure and react
accordingly to run in half-open mode as well.</li><li>Fixed <a
shape="rect" href="mdc-logging.html">MDC logging</a> loosing route id after
calling a direct route from within a transacted route</li><li>Fixed a
regression with <a shape="rect" href="bean.html">Bean</a> and <a
shape="rect" href="simple.html">Simple</a> OGNL expressions causing ambiguous
method call exception <span>when calling method implemented by super class
when method is
defined by interface and abstract class</span></li><li><span>Fixed <a
shape="rect" href="rest-dsl.html">Rest DSL</a> (server side) not returning
response on all valid uri paths when clients call using a HTTP OPTIONS
request</span></li><li><span>Fixed <a shape="rect"
href="rest.html">Rest</a> producer not using HTTP method (verb such as
PUT) from the endpoint uri when calling a remote REST
service</span></li><li><span>Fixed <a shape="rect"
href="timer.html">Timer</a> routes to shutdown more graceful and allow pending
tasks to complete while they are in-flight.</span></li></ul><h3
id="Camel2.20.0Release-New">New <a shape="rect"
href="enterprise-integration-patterns.html">Enterprise Integration
Patterns</a></h3><h3 id="Camel2.20.0Release-New.1">New <a shape="rect"
href="components.html">Components</a></h3><ul><li>camel-reactor - a reactor
based back-end for camel's reactive streams component</li></ul><h3
id="Camel2.20.0Release-NewDSL">New DSL</h3><h3 id="Camel2.20.0
Release-NewAnnotations">New Annotations</h3><h3
id="Camel2.20.0Release-NewDataFormats">New <a shape="rect"
href="data-format.html">Data Formats</a></h3><h3
id="Camel2.20.0Release-New.2">New <a shape="rect"
href="languages.html">Languages</a></h3><h3 id="Camel2.20.0Release-New.3">New
<a shape="rect" href="examples.html">Examples</a></h3><h3
id="Camel2.20.0Release-New.4">New <a shape="rect"
href="tutorials.html">Tutorials</a></h3><h2
id="Camel2.20.0Release-APIbreaking">API breaking</h2><ul><li>The old <a
shape="rect" href="tracer.html">Tracer</a> which is based on
the <code>org.apache.camel.processor.interceptor.Tracer</code> class
has been disabled and are not in use/working. Instead rely on custom tracing
implementation via <a shape="rect" href="message-history.html">Message
History</a> EIP. </li></ul><p> </p><h2
id="Camel2.20.0Release-KnownIssues">Known Issues</h2><h2
id="Camel2.20.0Release-Importantchangestoconsiderwhenupgrading">Important
changes to consi
der when upgrading</h2><ul><li>Maven 3.3.3 or newer is required to build the
project</li><li><p>camel-infinispan - the result is not more set in the
CamelInfinispanOperationResult header but in the in body. To change this
behavior you can set the header CamelInfinispanOperationResultHeader with the
name of the header that should contains the result or with the resultHeader uri
option</p></li><li><span style="color: rgb(24,54,145);"><span style="color:
rgb(24,54,145);"><span style="color: rgb(36,41,46);">camel-infinispan - the uri
option <em>command</em> has been deprecated and replaced by <em>operation</em>
for consistency</span></span></span></li><li><span style="color:
rgb(24,54,145);"><span style="color: rgb(24,54,145);"><span style="color:
rgb(36,41,46);">camel-infinispan - the commands are now int the short form PUT,
GET etc. old operation names like CamelInfinispanOperationPut,
CamelInfinispanOperationGet etc have been
deprecated.</span></span></span></li><li><span style="colo
r: rgb(24,54,145);"><span style="color: rgb(24,54,145);"><span style="color:
rgb(36,41,46);">camel-undertow - <span style="color:
rgb(0,0,0);">matchOnUriPrefix option is defaulted to be FALSE in order to make
it consistent with other components like Camel HTTP
components.</span></span></span></span></li><li>Splitted <a shape="rect"
href="twitter.html">Twitter</a> component into 4, now directmessage,
seach, streaming and timeline has its own endpoint and scheme. See <a
shape="rect" class="external-link"
href="https://github.com/apache/camel/blob/master/components/camel-twitter/src/main/docs/twitter.adoc"
rel="nofollow">documentation</a> for more details<span style="color:
rgb(24,54,145);"><span style="color: rgb(24,54,145);"><span style="color:
rgb(36,41,46);"><span style="color: rgb(0,0,0);"><br
clear="none"></span></span></span></span></li></ul><h2
id="Camel2.20.0Release-GettingtheDistributions">Getting the
Distributions</h2><h3 id="Camel2.20.0Release-
BinaryDistributions">Binary Distributions</h3><div class="table-wrap"><table
class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1"
class="confluenceTh"><p>Description</p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p>Download Link</p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p>PGP Signature file of download</p></th></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p>Windows
Distribution</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><a
shape="rect" class="external-link"
href="http://www.apache.org/dyn/closer.cgi/camel/apache-camel/x.y.x/apache-camel-x.y.x.zip">apache-camel-x.y.x.zip</a></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect"
class="external-link"
href="http://www.apache.org/dist/camel/apache-camel/x.y.x/apache-camel-x.y.x.zip.asc">apache-camel-x.y.x.zip.asc</a></p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p>Unix/Linux/Cygwin
Distribution</p></td><td colspan="1" rowspan="1
" class="confluenceTd"><p><a shape="rect" class="external-link"
href="http://www.apache.org/dyn/closer.cgi/camel/apache-camel/x.y.x/apache-camel-x.y.x.tar.gz">apache-camel-x.y.x.tar.gz</a></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect"
class="external-link"
href="http://www.apache.org/dist/camel/apache-camel/x.y.x/apache-camel-x.y.x.tar.gz.asc">apache-camel-x.y.x.tar.gz.asc</a></p></td></tr></tbody></table></div><div
class="confluence-information-macro
confluence-information-macro-information"><p class="title">The above URLs use
redirection</p><span class="aui-icon aui-icon-small aui-iconfont-info
confluence-information-macro-icon"></span><div
class="confluence-information-macro-body"><p>The above URLs use the Apache
Mirror system to redirect you to a suitable mirror for your download. Some
users have experienced issues with some versions of browsers (e.g. some Safari
browsers). If the download doesn't seem to work for you from the above URL then
try usi
ng <a shape="rect" class="external-link"
href="http://www.mozilla.com/en-US/firefox/"
rel="nofollow">FireFox</a></p></div></div><h3
id="Camel2.20.0Release-SourceDistributions">Source Distributions</h3><div
class="table-wrap"><table class="confluenceTable"><tbody><tr><th colspan="1"
rowspan="1" class="confluenceTh"><p>Description</p></th><th colspan="1"
rowspan="1" class="confluenceTh"><p>Download Link</p></th><th colspan="1"
rowspan="1" class="confluenceTh"><p>PGP Signature file of
download</p></th></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>Source (zip)</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><a shape="rect" class="external-link"
href="http://www.apache.org/dyn/closer.cgi/camel/apache-camel/x.y.x/apache-camel-x.y.x-src.zip">apache-camel-x.y.x-src.zip</a></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect"
class="external-link"
href="http://www.apache.org/dist/camel/apache-camel/x.y.x/apache-camel-x.y.x-src.zip.asc">apache
-camel-x.y.x-src.zip.asc</a></p></td></tr></tbody></table></div><h3
id="Camel2.20.0Release-GettingtheBinariesusingMaven2">Getting the Binaries
using Maven 2</h3><p>To use this release in your maven project, the proper
dependency configuration that you should use in your <a shape="rect"
class="external-link"
href="http://maven.apache.org/guides/introduction/introduction-to-the-pom.html">Maven
POM</a> is:</p><div class="code panel pdl" style="border-width: 1px;"><div
class="codeContent panelContent pdl">
+<h2 id="Camel2.20.0Release-NewandNoteworthy">New and Noteworthy</h2><p>Welcome
to the x.y.z release which approx XXX issues resolved (new features,
improvements and bug fixes such as...)</p><ul><li>Many internal optimisations
in the Camel routing engine, such as reducing thread contention when updating
JMX statistics, reducing internal state objects to claim less memory, and
reducing the number of allocated objects to reduce overhead on GC etc, and much
more. </li><li>The <a shape="rect" class="external-link"
href="https://github.com/apache/camel/blob/master/tooling/maven/camel-maven-plugin/src/main/docs/camel-maven-plugin.adoc"
rel="nofollow">Camel Maven Plugin</a> can now validate for duplicate route ids
in your source code.</li><li>Splitted <a shape="rect"
href="twitter.html">Twitter</a> component into 4, now directmessage,
seach, streaming and timeline has its own endpoint and scheme. See <a
shape="rect" class="external-link" href="https://github.com/apache/c
amel/blob/master/components/camel-twitter/src/main/docs/twitter.adoc"
rel="nofollow">documentation</a> for more
details</li><li>Introduced <code>HeadersMapFactory</code> SPI which allows
to plugin different implementations, or to use case sensitive maps that are
faster than the default.</li><li>Allow <a shape="rect"
href="kafka.html">Kafka</a> consumer to break on first unhandled exception,
sync the offset from last known good, and then re-connect after one timeout
cycle, to restart consuming again. This avoids loosing the failed message, but
retry it again on either this consumer, or another consume which was
re-balanced by Kafka. This requires to be turned on with the new option
breakOnFirstError which can be set on both component or endpoint
level.</li><li>Starting and stoping the CamelContext when used with Spring
framework (SpringCamelContext) was revised to ensure that the Camel context is
started last - when all resources should be available, and stopped first
- while all resources are still available</li><li>Tracing via <a
shape="rect" href="tracer.html">Tracer</a> has been refactored to be using
the <a shape="rect" href="message-history.html">Message History</a> EIP
which allows Camel to use same logic instead of doing twice the tracing/capture
during runtime. This reduced the memory footprint.</li></ul><p>Fixed these
issues</p><ul><li>Fixed a infinitive recursion in Camel's <a shape="rect"
href="error-handler.html">Error Handler</a> when an onException was routing to
another route using direct endpoint and this route would throw a new exception
that would circle back to the same onException or at a later point, which will
cause an endless recursion.</li><li>Fixed a potential issue with masking
password from URI using RAW(xxx) would reveal part of the password if the
password contains a & character.</li><li>The <a shape="rect"
href="restlet.html">Restlet</a> component is now internally using curly
brackets f
or its uri patterns instead of regular parentheses so it works similar to the
other REST component and as Restlet framework itself does</li><li>Fixed <a
shape="rect" href="hystrix-eip.html">Hystrix EIP</a> having wrong default for
circuitBreakerForceClose when using camel-hystrix-starter with Spring Boot. The
default should be false and not true</li><li>Fixed <a shape="rect"
href="hystrix-eip.html">Hystrix EIP</a> when failing and running fallback not
signaling to Hystrix itself so it can keep state of the failure and react
accordingly to run in half-open mode as well.</li><li>Fixed <a
shape="rect" href="mdc-logging.html">MDC logging</a> loosing route id after
calling a direct route from within a transacted route</li><li>Fixed a
regression with <a shape="rect" href="bean.html">Bean</a> and <a
shape="rect" href="simple.html">Simple</a> OGNL expressions causing ambiguous
method call exception <span>when calling method implemented by super class
when method is
defined by interface and abstract class</span></li><li><span>Fixed <a
shape="rect" href="rest-dsl.html">Rest DSL</a> (server side) not returning
response on all valid uri paths when clients call using a HTTP OPTIONS
request</span></li><li><span>Fixed <a shape="rect"
href="rest.html">Rest</a> producer not using HTTP method (verb such as
PUT) from the endpoint uri when calling a remote REST
service</span></li><li><span>Fixed <a shape="rect"
href="timer.html">Timer</a> routes to shutdown more graceful and allow pending
tasks to complete while they are in-flight.</span></li></ul><h3
id="Camel2.20.0Release-New">New <a shape="rect"
href="enterprise-integration-patterns.html">Enterprise Integration
Patterns</a></h3><h3 id="Camel2.20.0Release-New.1">New <a shape="rect"
href="components.html">Components</a></h3><ul><li>camel-reactor - a reactor
based back-end for camel's reactive streams component</li></ul><h3
id="Camel2.20.0Release-NewDSL">New DSL</h3><h3 id="Camel2.20.0
Release-NewAnnotations">New Annotations</h3><h3
id="Camel2.20.0Release-NewDataFormats">New <a shape="rect"
href="data-format.html">Data Formats</a></h3><h3
id="Camel2.20.0Release-New.2">New <a shape="rect"
href="languages.html">Languages</a></h3><h3 id="Camel2.20.0Release-New.3">New
<a shape="rect" href="examples.html">Examples</a></h3><h3
id="Camel2.20.0Release-New.4">New <a shape="rect"
href="tutorials.html">Tutorials</a></h3><h2
id="Camel2.20.0Release-APIbreaking">API breaking</h2><h2
id="Camel2.20.0Release-KnownIssues">Known Issues</h2><h2
id="Camel2.20.0Release-Importantchangestoconsiderwhenupgrading">Important
changes to consider when upgrading</h2><ul><li>Maven 3.3.3 or newer is required
to build the project</li><li><p>camel-infinispan - the result is not more set
in the CamelInfinispanOperationResult header but in the in body. To change this
behavior you can set the header CamelInfinispanOperationResultHeader with the
name of the header that should contains the result or wit
h the resultHeader uri option</p></li><li><span style="color:
rgb(24,54,145);"><span style="color: rgb(24,54,145);"><span style="color:
rgb(36,41,46);">camel-infinispan - the uri option <em>command</em> has been
deprecated and replaced by <em>operation</em> for
consistency</span></span></span></li><li><span style="color:
rgb(24,54,145);"><span style="color: rgb(24,54,145);"><span style="color:
rgb(36,41,46);">camel-infinispan - the commands are now int the short form PUT,
GET etc. old operation names like CamelInfinispanOperationPut,
CamelInfinispanOperationGet etc have been
deprecated.</span></span></span></li><li><span style="color:
rgb(24,54,145);"><span style="color: rgb(24,54,145);"><span style="color:
rgb(36,41,46);">camel-undertow - <span style="color:
rgb(0,0,0);">matchOnUriPrefix option is defaulted to be FALSE in order to make
it consistent with other components like Camel HTTP
components.</span></span></span></span></li><li>Splitted <a shape="rect"
href="tw
itter.html">Twitter</a> component into 4, now directmessage, seach,
streaming and timeline has its own endpoint and scheme. See <a
shape="rect" class="external-link"
href="https://github.com/apache/camel/blob/master/components/camel-twitter/src/main/docs/twitter.adoc"
rel="nofollow">documentation</a> for more details<span style="color:
rgb(24,54,145);"><span style="color: rgb(24,54,145);"><span style="color:
rgb(36,41,46);"><span style="color: rgb(0,0,0);"><br
clear="none"></span></span></span></span></li></ul><h2
id="Camel2.20.0Release-GettingtheDistributions">Getting the
Distributions</h2><h3 id="Camel2.20.0Release-BinaryDistributions">Binary
Distributions</h3><div class="table-wrap"><table
class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1"
class="confluenceTh"><p>Description</p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p>Download Link</p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p>PGP Signature file of download</p></th></tr><tr
><td colspan="1" rowspan="1" class="confluenceTd"><p>Windows
>Distribution</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><a
>shape="rect" class="external-link"
>href="http://www.apache.org/dyn/closer.cgi/camel/apache-camel/x.y.x/apache-camel-x.y.x.zip">apache-camel-x.y.x.zip</a></p></td><td
> colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect"
>class="external-link"
>href="http://www.apache.org/dist/camel/apache-camel/x.y.x/apache-camel-x.y.x.zip.asc">apache-camel-x.y.x.zip.asc</a></p></td></tr><tr><td
> colspan="1" rowspan="1" class="confluenceTd"><p>Unix/Linux/Cygwin
>Distribution</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><a
>shape="rect" class="external-link"
>href="http://www.apache.org/dyn/closer.cgi/camel/apache-camel/x.y.x/apache-camel-x.y.x.tar.gz">apache-camel-x.y.x.tar.gz</a></p></td><td
> colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect"
>class="external-link"
>href="http://www.apache.org/dist/camel/apache-camel/x.y.x/apache-camel
-x.y.x.tar.gz.asc">apache-camel-x.y.x.tar.gz.asc</a></p></td></tr></tbody></table></div><div
class="confluence-information-macro
confluence-information-macro-information"><p class="title">The above URLs use
redirection</p><span class="aui-icon aui-icon-small aui-iconfont-info
confluence-information-macro-icon"></span><div
class="confluence-information-macro-body"><p>The above URLs use the Apache
Mirror system to redirect you to a suitable mirror for your download. Some
users have experienced issues with some versions of browsers (e.g. some Safari
browsers). If the download doesn't seem to work for you from the above URL then
try using <a shape="rect" class="external-link"
href="http://www.mozilla.com/en-US/firefox/"
rel="nofollow">FireFox</a></p></div></div><h3
id="Camel2.20.0Release-SourceDistributions">Source Distributions</h3><div
class="table-wrap"><table class="confluenceTable"><tbody><tr><th colspan="1"
rowspan="1" class="confluenceTh"><p>Description</p></th><th colspan="1" ro
wspan="1" class="confluenceTh"><p>Download Link</p></th><th colspan="1"
rowspan="1" class="confluenceTh"><p>PGP Signature file of
download</p></th></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>Source (zip)</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><a shape="rect" class="external-link"
href="http://www.apache.org/dyn/closer.cgi/camel/apache-camel/x.y.x/apache-camel-x.y.x-src.zip">apache-camel-x.y.x-src.zip</a></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect"
class="external-link"
href="http://www.apache.org/dist/camel/apache-camel/x.y.x/apache-camel-x.y.x-src.zip.asc">apache-camel-x.y.x-src.zip.asc</a></p></td></tr></tbody></table></div><h3
id="Camel2.20.0Release-GettingtheBinariesusingMaven2">Getting the Binaries
using Maven 2</h3><p>To use this release in your maven project, the proper
dependency configuration that you should use in your <a shape="rect"
class="external-link" href="http://maven.apache.org/guides/introductio
n/introduction-to-the-pom.html">Maven POM</a> is:</p><div class="code panel
pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
<script class="brush: xml; gutter: false; theme: Default"
type="syntaxhighlighter"><![CDATA[<dependency>
<groupId>org.apache.camel</groupId>
<artifactId>camel-core</artifactId>
Modified: websites/production/camel/content/tracer.html
==============================================================================
--- websites/production/camel/content/tracer.html (original)
+++ websites/production/camel/content/tracer.html Mon May 29 19:19:42 2017
@@ -86,7 +86,7 @@
<tbody>
<tr>
<td valign="top" width="100%">
-<div class="wiki-content maincontent"><h2 id="Tracer-TracerInterceptor">Tracer
Interceptor</h2><div class="confluence-information-macro
confluence-information-macro-warning"><span class="aui-icon aui-icon-small
aui-iconfont-error confluence-information-macro-icon"></span><div
class="confluence-information-macro-body"><p>The Tracer Interceptor has been
deprecated and will be disabled/not-functioning from Camel 2.20 onwards. If you
enable tracing via camelContext.setTracing(true) then Camel uses a different
implementation internally to conduct the tracing. This newer implementation
works faster and has less memory footprint. Custom tracers can still be
implemented via InterceptStrategy, or EventNotifier
etc.</p></div></div><p> </p><p> </p><p>Camel's tracer interceptor can
be used for logging, by default at the <strong><code>INFO</code></strong>
level, a route's execution. The tracer is an instance of
<strong><code>org.apache.camel.spi.InterceptStrategy</code></strong>. It ca
n be applied to either
a <strong><code>DefaultCamelContext</code></strong> or a
<strong><code>SpringCamelContext</code></strong> to ensure that there is
a <strong><code>TracerInterceptor</code></strong> created for every node
in the route. The tracer's logging can be enabled/disabled dynamically by
calling its <strong><code>setEnabled</code></strong> method.</p><div
class="confluence-information-macro confluence-information-macro-tip"><p
class="title">Logging dependencies</p><span class="aui-icon aui-icon-small
aui-iconfont-approve confluence-information-macro-icon"></span><div
class="confluence-information-macro-body"><p>Checkout which <a shape="rect"
href="camel-jar-dependencies.html">dependencies</a> are required by Camel for
logging purpose.</p></div></div><div class="confluence-information-macro
confluence-information-macro-information"><span class="aui-icon aui-icon-small
aui-iconfont-info confluence-information-macro-icon"></span><div
class="confluence-information-m
acro-body"><p>From <strong>Camel 2.12</strong>: the <a shape="rect"
href="camelcontext.html">CamelContext</a> must be explicitly configured for
tracing:</p><ul><li>XML:  <strong><code><camelContext trace="true"
...></code></strong></li><li>Java:
<strong><code>camelContext.setTracing(true)</code></strong>.</li></ul></div></div><h3
id="Tracer-Options">Options</h3><div class="confluenceTableSmall"><div
class="table-wrap"><table class="confluenceTable"><tbody><tr><th colspan="1"
rowspan="1" class="confluenceTh"><p>Option</p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p>Default</p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p>Description</p></th></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>destinationUri</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>Optional destination URI to
route <a shape="rect" class="external-link" href="http://cam
el.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">JPA</a>.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>enabled</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>true</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Enable/disable the
tracer.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>formatter</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Sets the Trace Formatter to use.</p><p>Default: <stro
ng><code>org.apache.camel.processor.interceptor.DefaultTraceFormatter</code></strong>.</p></td></tr><tr><td
colspan="1" rowspan="1"
class="confluenceTd"><p><code>jpaTraceEventMessageClassName</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><strong>Camel 2.3:</strong>
Fully qualified class name for a custom
<strong><code>org.apache.camel.processor.interceptor.TraceEventMessage</code></strong>
class which contains the traced information.</p><p>For example you can use
your custom JPA @Entity class to store traced information in a database
according to your schema layout.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>logLevel</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>INFO</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>The logging level to use:
<strong><code>FATAL</code>, <code>ERROR</code></strong>, <strong><code
>WARN</code>, <code>INFO</code></strong>, <strong><code>DEBUG</code>,
><code>TRACE</code></strong>, <strong><code>OFF</code></strong></p></td></tr><tr><td
> colspan="1" rowspan="1"
>class="confluenceTd"><p><code>logName</code></p></td><td colspan="1"
>rowspan="1" class="confluenceTd"><p> </p></td><td colspan="1"
>rowspan="1" class="confluenceTd"><p>The log name to use.</p><p>Default:
><strong><code>org.apache.camel.processor.interceptor.TraceInterceptor</code></strong>.</p></td></tr><tr><td
> colspan="1" rowspan="1"
>class="confluenceTd"><p><code>logStackTrace</code></p></td><td colspan="1"
>rowspan="1" class="confluenceTd"><p><code>false</code></p></td><td
>colspan="1" rowspan="1" class="confluenceTd"><p>Controls whether the stack
>trace of a traced exception should be logged.
>If <strong><code>false</code></strong> only the exception's class and
>message are logged.</p></td></tr><tr><td colspan="1" rowspan="1"
>class="confluenceTd"><p><code>traceFilter</code></p></td><td colspan="1
" rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>An Exchange <a shape="rect"
href="predicate.html">Predicate</a> to filter the tracing.</p></td></tr><tr><td
colspan="1" rowspan="1"
class="confluenceTd"><p><code>traceInterceptors</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>false</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Enable/disable tracing of
interceptors.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>traceExceptions</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>true</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Enable/disable tracing of an exception
thrown during the processing of an Exchange.</p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>traceHandler</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td
colspan="1
" rowspan="1" class="confluenceTd"><p><strong>Camel 2.3:</strong> To use a
custom
<strong><code>org.apache.camel.processor.interceptor.TraceEventHandler</code></strong>
where you can control what happens when a trace event
occurs.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>traceInterceptorFactory</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><strong>Camel 2.3:</strong> To
use a custom
<strong><code>org.apache.camel.processor.interceptor.TraceInterceptorFactory</code></strong>
where you can create the runtime trace instance which does the actual tracing.
It should be a <strong><code>Processor</code></strong> instance.</p><p>Default:
<strong><code>org.apache.camel.processor.interceptor.TraceInterceptor</code></strong>.</p></td></tr><tr><td
colspan="1" rowspan="1"
class="confluenceTd"><p><code>traceOutExchanges</code></p></td><td colspan="1"
rowspan="1" cla
ss="confluenceTd"><p><code>false</code></p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Enable/disable fine grained tracing, using a callback,
for both <strong><code>IN</code></strong> (before)
and <strong><code>OUT</code></strong> (after).</p><p>By default only one
trace callback is executed.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>useJpa</code></p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>false</code></p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>To use a
<strong><code>JpaTraceEventMessage</code></strong> from
<strong>camel-jpa</strong> component as the
<strong><code>TraceEventMessage</code></strong>. This requires that
<strong>camel-jpa.jar</strong> is on the
classpath.</p></td></tr></tbody></table></div></div>
+<div class="wiki-content maincontent"><h2 id="Tracer-TracerInterceptor">Tracer
Interceptor</h2><div class="confluence-information-macro
confluence-information-macro-warning"><span class="aui-icon aui-icon-small
aui-iconfont-error confluence-information-macro-icon"></span><div
class="confluence-information-macro-body"><p>Implementing custom tracing via
TracingInterceptor has been deprecated. However turning tracing on via
setTracing(true) is okay.</p></div></div><p> </p><p>Camel's tracer
interceptor can be used for logging, by default at the
<strong><code>INFO</code></strong> level, a route's execution. The tracer is an
instance of
<strong><code>org.apache.camel.spi.InterceptStrategy</code></strong>. It can be
applied to either a <strong><code>DefaultCamelContext</code></strong> or a
<strong><code>SpringCamelContext</code></strong> to ensure that there is
a <strong><code>TracerInterceptor</code></strong> created for every node
in the route. The tracer's logging can be
enabled/disabled dynamically by calling its
<strong><code>setEnabled</code></strong> method.</p><div
class="confluence-information-macro confluence-information-macro-tip"><p
class="title">Logging dependencies</p><span class="aui-icon aui-icon-small
aui-iconfont-approve confluence-information-macro-icon"></span><div
class="confluence-information-macro-body"><p>Checkout which <a shape="rect"
href="camel-jar-dependencies.html">dependencies</a> are required by Camel for
logging purpose.</p></div></div><div class="confluence-information-macro
confluence-information-macro-information"><span class="aui-icon aui-icon-small
aui-iconfont-info confluence-information-macro-icon"></span><div
class="confluence-information-macro-body"><p>From <strong>Camel 2.12</strong>:
the <a shape="rect" href="camelcontext.html">CamelContext</a> must be
explicitly configured for tracing:</p><ul><li>XML: 
<strong><code><camelContext trace="true"
...></code></strong></li><li>Java: <strong><code>camelCo
ntext.setTracing(true)</code></strong>.</li></ul></div></div><h3
id="Tracer-Options">Options</h3><div class="confluenceTableSmall"><div
class="table-wrap"><table class="confluenceTable"><tbody><tr><th colspan="1"
rowspan="1" class="confluenceTh"><p>Option</p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p>Default</p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p>Description</p></th></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>destinationUri</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>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/inter
ceptor/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">JPA</a>.</p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>enabled</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><code>true</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>Enable/disable the
tracer.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>formatter</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Sets the Trace Formatter to use.</p><p>Default:
<strong><code>org.apache.camel.processor.interceptor.DefaultTraceFormatter</code></strong>.</p></td></tr><tr><td
colspan="1" rowspan="1"
class="confluenceTd"><p><code>jpaTraceEventMessageClassName</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><code>null</code></
p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><strong>Camel
2.3:</strong> Fully qualified class name for a custom
<strong><code>org.apache.camel.processor.interceptor.TraceEventMessage</code></strong>
class which contains the traced information.</p><p>For example you can use
your custom JPA @Entity class to store traced information in a database
according to your schema layout.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>logLevel</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>INFO</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>The logging level to use:
<strong><code>FATAL</code>, <code>ERROR</code></strong>,
<strong><code>WARN</code>, <code>INFO</code></strong>,
<strong><code>DEBUG</code>,
<code>TRACE</code></strong>, <strong><code>OFF</code></strong></p></td></tr><tr><td
colspan="1" rowspan="1"
class="confluenceTd"><p><code>logName</code></p></td><td colspan="1"
rowspan="1" class="conflue
nceTd"><p> </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>The log name to use.</p><p>Default:
<strong><code>org.apache.camel.processor.interceptor.TraceInterceptor</code></strong>.</p></td></tr><tr><td
colspan="1" rowspan="1"
class="confluenceTd"><p><code>logStackTrace</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>false</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Controls whether the stack trace of a
traced exception should be logged. If <strong><code>false</code></strong>
only the exception's class and message are logged.</p></td></tr><tr><td
colspan="1" rowspan="1"
class="confluenceTd"><p><code>traceFilter</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>An Exchange <a shape="rect"
href="predicate.html">Predicate</a> to filter the tracing.</p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p><code>
traceInterceptors</code></p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>false</code></p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Enable/disable tracing of
interceptors.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>traceExceptions</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>true</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Enable/disable tracing of an exception
thrown during the processing of an Exchange.</p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>traceHandler</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><strong>Camel 2.3:</strong> To
use a custom
<strong><code>org.apache.camel.processor.interceptor.TraceEventHandler</code></strong>
where you can control what happens when a trace event
occurs.</p></td></tr><tr><td colspan="1" rowspan="1" cl
ass="confluenceTd"><p><code>traceInterceptorFactory</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><code>null</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><strong>Camel 2.3:</strong> To
use a custom
<strong><code>org.apache.camel.processor.interceptor.TraceInterceptorFactory</code></strong>
where you can create the runtime trace instance which does the actual tracing.
It should be a <strong><code>Processor</code></strong> instance.</p><p>Default:
<strong><code>org.apache.camel.processor.interceptor.TraceInterceptor</code></strong>.</p></td></tr><tr><td
colspan="1" rowspan="1"
class="confluenceTd"><p><code>traceOutExchanges</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>false</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Enable/disable fine grained tracing, using
a callback, for both <strong><code>IN</code></strong> (before)
and <strong><code>OUT</code></strong> (after).</p><p>By defaul
t only one trace callback is executed.</p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>useJpa</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>false</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>To use a
<strong><code>JpaTraceEventMessage</code></strong> from
<strong>camel-jpa</strong> component as the
<strong><code>TraceEventMessage</code></strong>. This requires that
<strong>camel-jpa.jar</strong> is on the
classpath.</p></td></tr></tbody></table></div></div>
<h3 id="Tracer-Formatting">Formatting</h3><p>The tracer formats the execution
of exchanges to log lines. They are logged
at <strong><code>INFO</code></strong> level in the log category:
<strong><code>org.apache.camel.processor.interceptor.TraceInterceptor</code></strong>.
By default the tracer uses:
<strong><code>org.apache.camel.processor.interceptor.DefaultTraceFormatter</code></strong>
to format the log
line.</p><p><strong><code>DefaultTraceFormatter</code></strong> has the
following options:</p><div class="confluenceTableSmall"><div
class="table-wrap"><table class="confluenceTable"><tbody><tr><th colspan="1"
rowspan="1" class="confluenceTh"><p>Option</p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p>Default</p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p>Description</p></th></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>breadCrumbLength</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><code>0</code></p></td><td col
span="1" rowspan="1" class="confluenceTd"><p>Fixed length of the bread
crumb. </p><p><code>0</code> = no fixed length.</p><p>Setting a value to
e.g. <code>80</code> allows the tracer logs to be aligned for easier
reading.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>maxChars</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p> </p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Limits the number of chars logged per line.</p><p>From
<strong>Camel 2.9</strong>: the default value is
<strong><code>10000</code>.</strong></p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>multiline</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><code>false</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><strong>Camel 2.18:</strong> If
<strong><code>true</code></strong> each piece of information is logged on a new
line.</p></td></tr><tr><td colspan="1" rowspan="1" class="confl
uenceTd"><p><code>nodeLength</code></p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>0</code></p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Fixed length of the node. </p><p><code>0</code> =
no fixed length.</p><p>Setting a value to e.g. <code>40</code> allows the
tracer logs to be aligned for easier reading.</p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>showBody</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><code>true</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>Output
the <strong><code>IN</code></strong> body.</p></td></tr><tr><td
colspan="1" rowspan="1"
class="confluenceTd"><p><code>showBodyType</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>true</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Output
the <strong><code>IN</code></strong> body Java type.</p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd
"><p><code>showBreadCrumb</code></p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>true</code></p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Outputs the unique UnitOfWork for the
exchange.</p><p>Can be used for correlation to identify a particular
Exchange.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>showException</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>true</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Output the exception if the processing of
an Exchange has failed.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>showExchangeId</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>false</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Enable/disable the output of an Exchange's
unique <strong><code>id</code></strong>.</p><p>Currently the breadcrumb is
sufficient.</p></td></tr><tr><td colspan="1" rowspan="1
" class="confluenceTd"><p><code>showExchangePattern</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><code>true</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>Output the Message Exchange
Pattern (MEP).</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>showHeaders</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>true</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Output
the <strong><code>IN</code></strong> message headers.</p></td></tr><tr><td
colspan="1" rowspan="1"
class="confluenceTd"><p><code>showNode</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>true</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Previous and destination
node.</p><p>Displayed as: <strong><code>from ->
to</code></strong>.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>showOutBody</code></p></td><td colspan="1"
rowspan="1" clas
s="confluenceTd"><p><code>false</code></p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Output the <strong><code>OUT</code></strong> (if
any) body.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>showOutBodyType</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>false</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Output
the <strong><code>OUT</code></strong> (if any) body Java
type.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>showOutHeaders</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>false</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Output
the <strong><code>OUT</code></strong> (if any) message
headers.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>showProperties</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>false</code></p></td><td colspan="1"
rowspan="
1" class="confluenceTd"><p>Output the Exchange's
properties.</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><code>showRouteId</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><code>true</code></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><strong>Camel 2.8:</strong> output
the <strong><code>id</code></strong> of the route.</p></td></tr><tr><td
colspan="1" rowspan="1"
class="confluenceTd"><p><code>showShortExchangeId</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><code>false</code></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>To output the Exchange's unique
<strong><code>id</code></strong> in short form, without the
hostname.</p></td></tr></tbody></table></div></div>