Author: buildbot Date: Sat Dec 5 09:19:57 2015 New Revision: 974626 Log: Production update by buildbot for camel
Modified: websites/production/camel/content/cache/main.pageCache websites/production/camel/content/camel-2170-release.html websites/production/camel/content/metrics-component.html Modified: websites/production/camel/content/cache/main.pageCache ============================================================================== Binary files - no diff available. Modified: websites/production/camel/content/camel-2170-release.html ============================================================================== --- websites/production/camel/content/camel-2170-release.html (original) +++ websites/production/camel/content/camel-2170-release.html Sat Dec 5 09:19:57 2015 @@ -85,7 +85,7 @@ <tbody> <tr> <td valign="top" width="100%"> -<div class="wiki-content maincontent"><h1 id="Camel2.17.0Release-Camel2.17.0release(currentlyinprogress)">Camel 2.17.0 release (currently in progress)</h1><div style="padding-right:20px;float:left;margin-left:-20px;"><p><span class="confluence-embedded-file-wrapper"><img class="confluence-embedded-image confluence-external-resource" src="http://camel.apache.org/download.data/camel-box-v1.0-150x200.png" data-image-src="http://camel.apache.org/download.data/camel-box-v1.0-150x200.png"></span></p></div><div style="min-height:200px"> </div><h2 id="Camel2.17.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>highlighted issue fixed</li><li>Upgraded camel-hbase to Hadoop 2.x and HBase 1.1.x</li><li><a shape="rect" href="tools.html">Camel commands</a> for <a shape="rect" href="spring-boot.html">Spring Boot</a></li><li>Many improvements to Camel 0;<a shape="rect" href="kura.html">Kura</a></li><li>Added transacted option to <a shape="rect" href="sql-component.html">SQL Component</a> when used as a consumer in a transacted route.</li><li>Added support for UPDATE operation to <a shape="rect" href="elasticsearch.html">ElasticSearch</a>.</li><li>Allow to reuse existing configured Elasticsearch Client on the <a shape="rect" href="elasticsearch.html">ElasticSearch</a> component, instead of creating a client per endpoint. </li><li>The <code>include</code> and <code>exclude</code> options on <a shape="rect" href="file2.html">File2</a> and <a shape="rect" href="ftp.html">FTP</a> endpoints is now case in-sensitive out of the box.</li><li>Resource based component such as <a shape="rect" href="xslt.html">XSLT</a>, <a shape="rect" href="velocity.html">Velocity</a> etc can load the resource file from the <a shape="rect" href="registry.html">Registry</a> by using <code>ref:</ code> as prefix.</li><li><span>Upgraded camel-amqp to the latest qpid-jms-client (also AMQP < 1.0 is not supported anymore).</span></li><li><span>Many improvements to Camel <a shape="rect" href="amqp.html">AMQP</a> component.</span></li></ul><p> </p><p>Fixed these issues</p><ul><li>The <a shape="rect" href="swagger-java.html">Swagger Java</a> now parses nested types in the POJO model that has been annotated with the swagger api annotations to use in the schema api model</li><li>Fixed <a shape="rect" href="rest-dsl.html">Rest DSL</a> with apiContextPath fail to start if there are 2 ore more rest's in use.</li><li>Paho component name is not limited to 4 characters anymore.</li><li>Fixed <a shape="rect" href="spring-boot.html">Spring Boot</a> not starting Camel routes if running in Spring Cloud.</li></ul><h3 id="Camel2.17.0Release-New">New <a shape="rect" href="enterprise-integration-patterns.html">Enterprise Integration Patterns</a></h3><h3 id="Camel2.17.0R elease-New.1">New <a shape="rect" href="components.html">Components</a></h3><ul><li>camel-kubernetes - Integrates Camel with Kubernetes</li></ul><h3 id="Camel2.17.0Release-NewDSL">New DSL</h3><h3 id="Camel2.17.0Release-NewAnnotations">New Annotations</h3><h3 id="Camel2.17.0Release-NewDataFormats">New <a shape="rect" href="data-format.html">Data Formats</a></h3><ul><li><a shape="rect" href="mime-multipart.html">MIME-Multipart</a> - mime based data format.</li></ul><h3 id="Camel2.17.0Release-New.2">New <a shape="rect" href="languages.html">Languages</a></h3><h3 id="Camel2.17.0Release-New.3">New <a shape="rect" href="examples.html">Examples</a></h3><ul><li>camel-example-spring-boot-metrics - showing a Camel spring-boot application that report metrics to Graphite. Requires Graphite running on your network.</li></ul><h3 id="Camel2.17.0Release-New.4">New <a shape="rect" href="tutorials.html">Tutorials</a></h3><h2 id="Camel2.17.0Release-APIbreaking">API breaking</h2><h2 id="Camel2.17.0Rele ase-KnownIssues">Known Issues</h2><h2 id="Camel2.17.0Release-Dependencyupgrades">Dependency upgrades</h2><ul><li>Spring 4.1.x to 4.2.x</li><li>Spring-Boot 1.2.x to 1.3.x</li><li>EHCache from 2.10.0 to 2.10.1</li><li>slf4j-api 1.6.x to 1.7.x</li></ul><h2 id="Camel2.17.0Release-Importantchangestoconsiderwhenupgrading">Important changes to consider when upgrading</h2><ul><li>Removed camel-hbase as Karaf feature as it did not really work well in OSGi</li><li>camel-infinispan requires Java 8.</li><li>Support for Spring 4.0.x is deprecated.</li><li>Moved some Camel tooling related dependencies (such as maven/plexus) from the Camel Parent BOM to the tooling BOM (to have them separated).</li></ul><h2 id="Camel2.17.0Release-GettingtheDistributions">Getting the Distributions</h2><h3 id="Camel2.17.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 co lspan="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.17.0Release-SourceDistributions">Source Distrib utions</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 for Windows</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><div class="table-wrap"><table class="confluenceTable"><tbody><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>So urce for Unix/Linux/Cygwin</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.tar.gz">apache-camel-x.y.x-src.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-src.tar.gz.asc">apache-camel-x.y.x-src.tar.gz.asc</a></p></td></tr></tbody></table></div><h3 id="Camel2.17.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"> +<div class="wiki-content maincontent"><h1 id="Camel2.17.0Release-Camel2.17.0release(currentlyinprogress)">Camel 2.17.0 release (currently in progress)</h1><div style="padding-right:20px;float:left;margin-left:-20px;"><p><span class="confluence-embedded-file-wrapper"><img class="confluence-embedded-image confluence-external-resource" src="http://camel.apache.org/download.data/camel-box-v1.0-150x200.png" data-image-src="http://camel.apache.org/download.data/camel-box-v1.0-150x200.png"></span></p></div><div style="min-height:200px"> </div><h2 id="Camel2.17.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>highlighted issue fixed</li><li>Upgraded camel-hbase to Hadoop 2.x and HBase 1.1.x</li><li><a shape="rect" href="tools.html">Camel commands</a> for <a shape="rect" href="spring-boot.html">Spring Boot</a></li><li>Many improvements to Camel 0;<a shape="rect" href="kura.html">Kura</a></li><li>Added transacted option to <a shape="rect" href="sql-component.html">SQL Component</a> when used as a consumer in a transacted route.</li><li>Added support for UPDATE operation to <a shape="rect" href="elasticsearch.html">ElasticSearch</a>.</li><li>Allow to reuse existing configured Elasticsearch Client on the <a shape="rect" href="elasticsearch.html">ElasticSearch</a> component, instead of creating a client per endpoint. </li><li>The <code>include</code> and <code>exclude</code> options on <a shape="rect" href="file2.html">File2</a> and <a shape="rect" href="ftp.html">FTP</a> endpoints is now case in-sensitive out of the box.</li><li>Resource based component such as <a shape="rect" href="xslt.html">XSLT</a>, <a shape="rect" href="velocity.html">Velocity</a> etc can load the resource file from the <a shape="rect" href="registry.html">Registry</a> by using <code>ref:</ code> as prefix.</li><li><span>Upgraded camel-amqp to the latest qpid-jms-client (also AMQP < 1.0 is not supported anymore).</span></li><li><span>Many improvements to Camel <a shape="rect" href="amqp.html">AMQP</a> component.</span></li><li><span>The <a shape="rect" href="metrics-component.html">Metrics Component</a> allows to capture <a shape="rect" href="message-history.html">Message History</a> performance statistics with the <code>MetricsMessageHistoryFactory</code></span></li></ul><p> </p><p>Fixed these issues</p><ul><li>The <a shape="rect" href="swagger-java.html">Swagger Java</a> now parses nested types in the POJO model that has been annotated with the swagger api annotations to use in the schema api model</li><li>Fixed <a shape="rect" href="rest-dsl.html">Rest DSL</a> with apiContextPath fail to start if there are 2 ore more rest's in use.</li><li>Paho component name is not limited to 4 characters anymore.</li><li>Fixed <a shape="r ect" href="spring-boot.html">Spring Boot</a> not starting Camel routes if running in Spring Cloud.</li></ul><h3 id="Camel2.17.0Release-New">New <a shape="rect" href="enterprise-integration-patterns.html">Enterprise Integration Patterns</a></h3><h3 id="Camel2.17.0Release-New.1">New <a shape="rect" href="components.html">Components</a></h3><ul><li>camel-kubernetes - Integrates Camel with Kubernetes</li></ul><h3 id="Camel2.17.0Release-NewDSL">New DSL</h3><h3 id="Camel2.17.0Release-NewAnnotations">New Annotations</h3><h3 id="Camel2.17.0Release-NewDataFormats">New <a shape="rect" href="data-format.html">Data Formats</a></h3><ul><li><a shape="rect" href="mime-multipart.html">MIME-Multipart</a> - mime based data format.</li></ul><h3 id="Camel2.17.0Release-New.2">New <a shape="rect" href="languages.html">Languages</a></h3><h3 id="Camel2.17.0Release-New.3">New <a shape="rect" href="examples.html">Examples</a></h3><ul><li>camel-example-spring-boot-metrics - showing a Camel spring-boot applica tion that report metrics to Graphite. Requires Graphite running on your network.</li></ul><h3 id="Camel2.17.0Release-New.4">New <a shape="rect" href="tutorials.html">Tutorials</a></h3><h2 id="Camel2.17.0Release-APIbreaking">API breaking</h2><h2 id="Camel2.17.0Release-KnownIssues">Known Issues</h2><h2 id="Camel2.17.0Release-Dependencyupgrades">Dependency upgrades</h2><ul><li>Spring 4.1.x to 4.2.x</li><li>Spring-Boot 1.2.x to 1.3.x</li><li>EHCache from 2.10.0 to 2.10.1</li><li>slf4j-api 1.6.x to 1.7.x</li></ul><h2 id="Camel2.17.0Release-Importantchangestoconsiderwhenupgrading">Important changes to consider when upgrading</h2><ul><li>Removed camel-hbase as Karaf feature as it did not really work well in OSGi</li><li>camel-infinispan requires Java 8.</li><li>Support for Spring 4.0.x is deprecated.</li><li>Moved some Camel tooling related dependencies (such as maven/plexus) from the Camel Parent BOM to the tooling BOM (to have them separated).</li><li>camel-amqp do not support 0.9 anymor e. </li></ul><h2 id="Camel2.17.0Release-GettingtheDistributions">Getting the Distributions</h2><h3 id="Camel2.17.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.17.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 for Windows</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><div class="table-wrap"><table class="confluenceTable"><tbody><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>Source for Unix/Linux/Cygwin</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.tar.gz">apache-camel-x.y.x-src.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-src.tar.gz.asc">apache-camel-x.y.x-src.tar.gz.asc</a></p></td></tr></tbody></table></div><h3 id="Camel2.17.0Release-GettingtheBinariesusingMaven2">Getting the Binaries using Maven 2</h3><p>To use this release in your maven project, the proper depe ndency 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"> <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/metrics-component.html ============================================================================== --- websites/production/camel/content/metrics-component.html (original) +++ websites/production/camel/content/metrics-component.html Sat Dec 5 09:19:57 2015 @@ -200,18 +200,26 @@ from("direct:in") .setHeader(MetricsConstants.HEADER_TIMER_ACTION, TimerAction.start) .to("metric:timer:simple.timer") .to("direct:out");]]></script> -</div></div><p> </p><h3 id="MetricsComponent-MetricsRoutePolicyFactory">MetricsRoutePolicyFactory</h3><p>This factory allows to add a <a shape="rect" href="routepolicy.html">RoutePolicy</a> for each route which exposes route utilization statistics using codehale metrics. This factory can be used in Java and XML as the examples below demonstrates. </p><div class="confluence-information-macro confluence-information-macro-tip"><span class="aui-icon aui-icon-small aui-iconfont-approve confluence-information-macro-icon"></span><div class="confluence-information-macro-body"><p>Instead of using the MetricsRoutePolicyFactory you can define a MetricsRoutePolicy per route you want to instrument, in case you only want to instrument a few selected routes.</p></div></div><p>From Java you just add the factory to the <code>CamelContext</code> as shown below:</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl"> +</div></div><h3 id="MetricsComponent-MetricsRoutePolicyFactory">MetricsRoutePolicyFactory</h3><p>This factory allows to add a <a shape="rect" href="routepolicy.html">RoutePolicy</a> for each route which exposes route utilization statistics using codehale metrics. This factory can be used in Java and XML as the examples below demonstrates. </p><div class="confluence-information-macro confluence-information-macro-tip"><span class="aui-icon aui-icon-small aui-iconfont-approve confluence-information-macro-icon"></span><div class="confluence-information-macro-body"><p>Instead of using the MetricsRoutePolicyFactory you can define a MetricsRoutePolicy per route you want to instrument, in case you only want to instrument a few selected routes.</p></div></div><p>From Java you just add the factory to the <code>CamelContext</code> as shown below:</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl"> <script class="brush: java; gutter: false; theme: Default" type="syntaxhighlighter"><![CDATA[context.addRoutePolicyFactory(new MetricsRoutePolicyFactory());]]></script> </div></div><p>And from XML DSL you define a <bean> as follows:</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl"> <script class="brush: java; gutter: false; theme: Default" type="syntaxhighlighter"><![CDATA[ <!-- use camel-metrics route policy to gather metrics for all routes --> <bean id="metricsRoutePolicyFactory" class="org.apache.camel.component.metrics.routepolicy.MetricsRoutePolicyFactory"/>]]></script> -</div></div><p>The <code>MetricsRoutePolicyFactory</code> and <code>MetricsRoutePolicy</code> supports the following options:</p><div class="table-wrap"><table class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1" class="confluenceTh">Name</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">useJmx</td><td colspan="1" rowspan="1" class="confluenceTd">false</td><td colspan="1" rowspan="1" class="confluenceTd">Whether to report fine grained statistics to JMX by using the <code>com.codahale.metrics.JmxReporter</code>.<br clear="none">Notice that if JMX is enabled on <a shape="rect" href="camelcontext.html">CamelContext</a> then a <code>MetricsRegistryService</code> mbean is enlisted under the services type in the JMX tree. That mbean has a single operation to output the statistics using json. Setting <code>useJmx</code> to true is onl y needed if you want fine grained mbeans per statistics type.</td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">jmxDomain</td><td colspan="1" rowspan="1" class="confluenceTd">org.apache.camel.metrics</td><td colspan="1" rowspan="1" class="confluenceTd">The JMX domain name</td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">prettyPrint</td><td colspan="1" rowspan="1" class="confluenceTd">false</td><td colspan="1" rowspan="1" class="confluenceTd">Whether to use pretty print when outputting statistics in json format</td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">metricsRegistry</td><td colspan="1" rowspan="1" class="confluenceTd"> </td><td colspan="1" rowspan="1" class="confluenceTd">Allow to use a shared <code>com.codahale.metrics.MetricRegistry</code>. If none is provided then Camel will create a shared instance used by the this CamelContext.</td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">rateUnit</td><td colspan="1" rowspan="1 " class="confluenceTd">TimeUnit.SECONDS</td><td colspan="1" rowspan="1" class="confluenceTd">The unit to use for rate in the metrics reporter or when dumping the statistics as json.</td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">durationUnit</td><td colspan="1" rowspan="1" class="confluenceTd">TimeUnit.MILLISECONDS</td><td colspan="1" rowspan="1" class="confluenceTd">The unit to use for duration in the metrics reporter or when dumping the statistics as json.</td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">namePattern</td><td colspan="1" rowspan="1" class="confluenceTd">##name##.##routeId##.##type##</td><td colspan="1" rowspan="1" class="confluenceTd"><strong>Camel 2.17:</strong> The name pattern to use. Uses dot as separators, but you can change that. The values ##name##, ##routeId##, and ##type## will be replaced with actual value.</td></tr></tbody></table></div><p> </p><p>From Java code tou can get hold of the <code>com.codahale.metrics.Metri cRegistry</code><span> from the <code>org.apache.camel.component.metrics.routepolicy.MetricsRegistryService</code> as shown below:</span></p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl"> +</div></div><p>The <code>MetricsRoutePolicyFactory</code> and <code>MetricsRoutePolicy</code> supports the following options:</p><div class="table-wrap"><table class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1" class="confluenceTh">Name</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">useJmx</td><td colspan="1" rowspan="1" class="confluenceTd">false</td><td colspan="1" rowspan="1" class="confluenceTd">Whether to report fine grained statistics to JMX by using the <code>com.codahale.metrics.JmxReporter</code>.<br clear="none">Notice that if JMX is enabled on <a shape="rect" href="camelcontext.html">CamelContext</a> then a <code>MetricsRegistryService</code> mbean is enlisted under the services type in the JMX tree. That mbean has a single operation to output the statistics using json. Setting <code>useJmx</code> to true is onl y needed if you want fine grained mbeans per statistics type.</td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">jmxDomain</td><td colspan="1" rowspan="1" class="confluenceTd">org.apache.camel.metrics</td><td colspan="1" rowspan="1" class="confluenceTd">The JMX domain name</td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">prettyPrint</td><td colspan="1" rowspan="1" class="confluenceTd">false</td><td colspan="1" rowspan="1" class="confluenceTd">Whether to use pretty print when outputting statistics in json format</td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">metricsRegistry</td><td colspan="1" rowspan="1" class="confluenceTd"> </td><td colspan="1" rowspan="1" class="confluenceTd">Allow to use a shared <code>com.codahale.metrics.MetricRegistry</code>. If none is provided then Camel will create a shared instance used by the this CamelContext.</td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">rateUnit</td><td colspan="1" rowspan="1 " class="confluenceTd">TimeUnit.SECONDS</td><td colspan="1" rowspan="1" class="confluenceTd">The unit to use for rate in the metrics reporter or when dumping the statistics as json.</td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">durationUnit</td><td colspan="1" rowspan="1" class="confluenceTd">TimeUnit.MILLISECONDS</td><td colspan="1" rowspan="1" class="confluenceTd">The unit to use for duration in the metrics reporter or when dumping the statistics as json.</td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">namePattern</td><td colspan="1" rowspan="1" class="confluenceTd">##name##.##routeId##.##type##</td><td colspan="1" rowspan="1" class="confluenceTd"><strong>Camel 2.17:</strong> The name pattern to use. Uses dot as separators, but you can change that. The values ##name##, ##routeId##, and ##type## will be replaced with actual value. Where ###name### is the name of the CamelContext. ###routeId### is the name of the route. And ###type### is the value of re sponses.</td></tr></tbody></table></div><p> </p><p>From Java code tou can get hold of the <code>com.codahale.metrics.MetricRegistry</code><span> from the <code>org.apache.camel.component.metrics.routepolicy.MetricsRegistryService</code> as shown below:</span></p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl"> <script class="brush: java; gutter: false; theme: Default" type="syntaxhighlighter"><![CDATA[MetricRegistryService registryService = context.hasService(MetricsRegistryService.class); if (registryService != null) { MetricsRegistry registry = registryService.getMetricsRegistry(); ... }]]></script> -</div></div></div> +</div></div><h3 id="MetricsComponent-MetricsMessageHistoryFactory">MetricsMessageHistoryFactory</h3><p><strong>Available as of Camel 2.17</strong></p><p>This factory allows to use metrics to capture <a shape="rect" href="message-history.html">Message History</a> performance statistics while routing messages. It works by using a metrics Timer for each node in all the routes. This factory can be used in Java and XML as the examples below demonstrates. </p><p>From Java you just set the factory to the <code>CamelContext</code> as shown below:</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl"> +<script class="brush: java; gutter: false; theme: Default" type="syntaxhighlighter"><![CDATA[context.setMessageHistoryFactory(new MetricsMessageHistoryFactory());]]></script> +</div></div><p>And from XML DSL you define a <bean> as follows:</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl"> +<script class="brush: java; gutter: false; theme: Default" type="syntaxhighlighter"><![CDATA[ <!-- use camel-metrics message history to gather metrics for all messages being routed --> + <bean id="metricsMessageHistoryFactory" class="org.apache.camel.component.metrics.messagehistory.MetricsMessageHistoryFactory"/>]]></script> +</div></div><p>The following options is supported on the factory:</p><div class="table-wrap"><table class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1" class="confluenceTh">Name</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">useJmx</td><td colspan="1" rowspan="1" class="confluenceTd">false</td><td colspan="1" rowspan="1" class="confluenceTd">Whether to report fine grained statistics to JMX by using the <code>com.codahale.metrics.JmxReporter</code>.<br clear="none">Notice that if JMX is enabled on <a shape="rect" href="camelcontext.html">CamelContext</a> then a <code>MetricsRegistryService</code> mbean is enlisted under the services type in the JMX tree. That mbean has a single operation to output the statistics using json. Setting <code>useJmx</code> to true is only needed if you want fine grained mbeans per statistics type.</td></tr ><tr><td colspan="1" rowspan="1" class="confluenceTd">jmxDomain</td><td >colspan="1" rowspan="1" class="confluenceTd">org.apache.camel.metrics</td><td >colspan="1" rowspan="1" class="confluenceTd">The JMX domain >name</td></tr><tr><td colspan="1" rowspan="1" >class="confluenceTd">prettyPrint</td><td colspan="1" rowspan="1" >class="confluenceTd">false</td><td colspan="1" rowspan="1" >class="confluenceTd">Whether to use pretty print when outputting statistics >in json format</td></tr><tr><td colspan="1" rowspan="1" >class="confluenceTd">metricsRegistry</td><td colspan="1" rowspan="1" >class="confluenceTd"> </td><td colspan="1" rowspan="1" >class="confluenceTd">Allow to use a shared ><code>com.codahale.metrics.MetricRegistry</code>. If none is provided then >Camel will create a shared instance used by the this >CamelContext.</td></tr><tr><td colspan="1" rowspan="1" >class="confluenceTd">rateUnit</td><td colspan="1" rowspan="1" >class="confluenceTd">TimeUnit.SECONDS</td><td colspan="1" rowspan="1 " class="confluenceTd">The unit to use for rate in the metrics reporter or when dumping the statistics as json.</td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">durationUnit</td><td colspan="1" rowspan="1" class="confluenceTd">TimeUnit.MILLISECONDS</td><td colspan="1" rowspan="1" class="confluenceTd">The unit to use for duration in the metrics reporter or when dumping the statistics as json.</td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">namePattern</td><td colspan="1" rowspan="1" class="confluenceTd">##name##.##routeId##.<span>###id###.</span>##type##</td><td colspan="1" rowspan="1" class="confluenceTd">The name pattern to use. Uses dot as separators, but you can change that. The values ##name##, ##routeId##, ##type##, and ###id### will be replaced with actual value. <span>Where ###name### is the name of the CamelContext. ###routeId### is the name of the route. </span>The ###id### pattern represents the node id. And ###type### is the value of history.</t d></tr></tbody></table></div><p>At runtime the metrics can be accessed from Java API or JMX which allows to gather the data as json output.</p><p>From Java code you can do get the service from the CamelContext as shown:</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl"> +<script class="brush: java; gutter: false; theme: Default" type="syntaxhighlighter"><![CDATA[MetricsMessageHistoryService service = context.hasService(MetricsMessageHistoryService.class); +String json = service.dumpStatisticsAsJson();]]></script> +</div></div><p>And the JMX API the MBean is registered in the <code>type=services</code> tree with <code>name=MetricsMessageHistoryService</code>. </p><p> </p></div> </td> <td valign="top"> <div class="navigation">