Modified: websites/production/camel/content/component-list.html ============================================================================== --- websites/production/camel/content/component-list.html (original) +++ websites/production/camel/content/component-list.html Wed Aug 13 14:18:28 2014 @@ -338,7 +338,9 @@ disruptor-vm:someName[?<option>] </div></div></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Uses Jakarta Commons Logging to log the message exchange to some underlying logging system like log4j</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" href="lucene.html">Lucene</a> / camel-lucene</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl"> <script class="theme: Default; brush: plain; gutter: false" type="syntaxhighlighter"><![CDATA[lucene:searcherName:<insert|query>[?options] ]]></script> -</div></div></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Uses Apache Lucene to perform Java-based indexing and full text based searches using advanced analysis/tokenization capabilities</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" href="mina.html">MINA</a> / camel-mina</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl"> +</div></div></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Uses Apache Lucene to perform Java-based indexing and full text based searches using advanced analysis/tokenization capabilities</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" href="metrics-component.html">Metrics</a> / camel-metrics</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl"> +<script class="theme: Default; brush: plain; gutter: false" type="syntaxhighlighter"><![CDATA[Â metrics:[meter|counter|histogram|timer]:metricname[?options]]]></script> +</div></div></td><td colspan="1" rowspan="1" class="confluenceTd"><p><span style="line-height: 1.4285715;">Uses </span><a shape="rect" class="external-link" href="http://metrics.codahale.com/"; style="line-height: 1.4285715;" rel="nofollow">Metrics</a><span style="line-height: 1.4285715;"> </span><span style="line-height: 1.4285715;"> to collect application statistics directly from Camel routes.</span></p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" href="mina.html">MINA</a> / camel-mina</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl"> <script class="theme: Default; brush: plain; gutter: false" type="syntaxhighlighter"><![CDATA[mina:[tcp|udp|vm]:host[:port][?options] ]]></script> </div></div></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Working with <a shape="rect" class="external-link" href="http://mina.apache.org/";>Apache MINA 1.x</a></p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" href="mina2.html">MINA2</a> / camel-mina2</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
Modified: websites/production/camel/content/components.html ============================================================================== --- websites/production/camel/content/components.html (original) +++ websites/production/camel/content/components.html Wed Aug 13 14:18:28 2014 @@ -347,7 +347,9 @@ disruptor-vm:someName[?<option>] </div></div></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Uses Jakarta Commons Logging to log the message exchange to some underlying logging system like log4j</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" href="lucene.html">Lucene</a> / camel-lucene</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl"> <script class="theme: Default; brush: plain; gutter: false" type="syntaxhighlighter"><![CDATA[lucene:searcherName:<insert|query>[?options] ]]></script> -</div></div></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Uses Apache Lucene to perform Java-based indexing and full text based searches using advanced analysis/tokenization capabilities</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" href="mina.html">MINA</a> / camel-mina</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl"> +</div></div></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Uses Apache Lucene to perform Java-based indexing and full text based searches using advanced analysis/tokenization capabilities</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" href="metrics-component.html">Metrics</a> / camel-metrics</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl"> +<script class="theme: Default; brush: plain; gutter: false" type="syntaxhighlighter"><![CDATA[Â metrics:[meter|counter|histogram|timer]:metricname[?options]]]></script> +</div></div></td><td colspan="1" rowspan="1" class="confluenceTd"><p><span style="line-height: 1.4285715;">Uses </span><a shape="rect" class="external-link" href="http://metrics.codahale.com/"; style="line-height: 1.4285715;" rel="nofollow">Metrics</a><span style="line-height: 1.4285715;"> </span><span style="line-height: 1.4285715;"> to collect application statistics directly from Camel routes.</span></p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" href="mina.html">MINA</a> / camel-mina</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl"> <script class="theme: Default; brush: plain; gutter: false" type="syntaxhighlighter"><![CDATA[mina:[tcp|udp|vm]:host[:port][?options] ]]></script> </div></div></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Working with <a shape="rect" class="external-link" href="http://mina.apache.org/";>Apache MINA 1.x</a></p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" href="mina2.html">MINA2</a> / camel-mina2</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl"> Added: websites/production/camel/content/metrics-component.html ============================================================================== --- websites/production/camel/content/metrics-component.html (added) +++ websites/production/camel/content/metrics-component.html Wed Aug 13 14:18:28 2014 @@ -0,0 +1,278 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd";> +<!-- + + Licensed to the Apache Software Foundation (ASF) under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + The ASF licenses this file to You under the Apache License, Version 2.0 + (the "License"); you may not use this file except in compliance with + the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> +<html> +<head> + <link href="//camel.apache.org/styles/site.css" rel="stylesheet" type="text/css"> + <link href="//camel.apache.org/styles/type-settings.css" rel="stylesheet" type="text/css"> + <script src="//camel.apache.org/styles/prototype.js" type="text/javascript"></script> + <script src="//camel.apache.org/styles/rico.js" type="text/javascript"></script> + <script src="//camel.apache.org/styles/site.js" type="text/javascript"></script> + + <meta http-equiv="Content-type" content="text/html;charset=UTF-8"> + + <style type="text/css"> + .maincontent { overflow:hidden; } + </style> + <!--[if IE]> + <style type="text/css"> + .maincontent { width:100%; } + </style> + <![endif]--> + + + <link href='//camel.apache.org/styles/highlighter/styles/shCoreCamel.css' rel='stylesheet' type='text/css' /> + <link href='//camel.apache.org/styles/highlighter/styles/shThemeCamel.css' rel='stylesheet' type='text/css' /> + <script src='//camel.apache.org/styles/highlighter/scripts/shCore.js' type='text/javascript'></script> + <script src='//camel.apache.org/styles/highlighter/scripts/shBrushJava.js' type='text/javascript'></script> + <script src='//camel.apache.org/styles/highlighter/scripts/shBrushXml.js' type='text/javascript'></script> + <script src='//camel.apache.org/styles/highlighter/scripts/shBrushPlain.js' type='text/javascript'></script> + + <script type="text/javascript"> + SyntaxHighlighter.defaults['toolbar'] = false; + SyntaxHighlighter.all(); + </script> + + <title> + Apache Camel: Metrics Component + </title> +</head> +<body> +<div class="white_box"> +<div class="header"> + <div class="header_l"> + <div class="header_r"> + </div> + </div> +</div> +<div class="content"> + <div class="content_l"> + <div class="content_r"> + <div> + <!-- Banner --> +<div id="banner-content"><div id="asf_logo"> + <div id="activemq_logo" style="height:108px; background:transparent url(banner.data/apache-camel-7.png) no-repeat scroll left top;"> + <a shape="rect" style="float:left; width:310px;display:block;text-indent:-5000px;text-decoration:none;line-height:140px; margin-top:20px; margin-left:18px;" href="http://camel.apache.org/";>Camel</a> + <a shape="rect" style="float:right; width:180px;display:block;text-indent:-5000px;text-decoration:none;line-height:80px; margin-top:45px; margin-right:10px;" href="http://www.apache.org";>Apache</a> + </div> +</div></div> + <!-- Banner --> + <div class="top_red_bar"> + <div id="site-breadcrumbs"> + <!-- Breadcrumbs --> +<a href="index.html">Apache Camel</a> > <a href="documentation.html">Documentation</a> > <a href="components.html">Components</a> > <a href="metrics-component.html">Metrics Component</a> + </div> + <!-- Quicklinks --> +<div id="site-quicklinks"><p><a shape="rect" href="download.html">Download</a> | <a shape="rect" href="javadoc.html">JavaDoc</a> | <a shape="rect" href="source.html">Source</a> | <a shape="rect" href="discussion-forums.html">Forums</a> | <a shape="rect" href="support.html">Support</a></p></div> + <!-- Quicklinks --> + </div> + + <table border="0"> + <tbody> + <tr> + <td valign="top" width="100%"> +<div class="wiki-content maincontent"><h2 id="MetricsComponent-MetricsComponent">Metrics Component</h2><p><strong>Available as of Camel 2.14</strong></p><p>The <strong>metrics:</strong> component allows to collect various metrics directly from Camel routes. Supported metric types are <a shape="rect" href="#MetricsComponent-counter">counter</a>, <a shape="rect" href="#MetricsComponent-histogram">histogram</a>, <a shape="rect" href="#MetricsComponent-meter">meter</a> and <a shape="rect" href="#MetricsComponent-timer">timer</a>. <a shape="rect" class="external-link" href="http://metrics.codahale.com/"; rel="nofollow">Metrics</a> provides simple way to measure behaviour of application. Configurable reporting backend is enabling different integration options for collecting and visualizing statistics.</p><p>Maven users will need to add the following dependency to their <code>pom.xml</code> for this component:</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl"> +<script class="theme: Default; brush: xml; gutter: false" type="syntaxhighlighter"><![CDATA[<dependency> + <groupId>org.apache.camel</groupId> + <artifactId>camel-metrics</artifactId> + <version>x.x.x</version> + <!-- use the same version as your Camel core version --> +</dependency>]]></script> +</div></div><h3 id="MetricsComponent-URIformat">URI format</h3><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl"> +<script class="theme: Default; brush: java; gutter: false" type="syntaxhighlighter"><![CDATA[metrics:[ meter | counter | histogram | timer ]:metricname[?options]]]></script> +</div></div><h3 id="MetricsComponent-registryMetricRegistry"><span class="confluence-anchor-link" id="MetricsComponent-registry"></span><span style="line-height: 1.5625;">Metric Registry</span></h3><p>Camel Metrics Component uses by default <code>MetricRegistry</code> with <code>Slf4jReporter</code> and 60 second reporting interval. Default registry can be replaced with custom one by providing bean with name <code>metricRegistry</code> in Camel registry. <span style="line-height: 1.4285715;">For example using Spring Java Configuration.</span></p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl"> +<script class="theme: Default; brush: java; gutter: false" type="syntaxhighlighter"><![CDATA[@Configuration +public static class MyConfig extends SingleRouteCamelConfiguration { + + @Bean + @Override + public RouteBuilder route() { + return new RouteBuilder() { + @Override + public void configure() throws Exception { + // define Camel routes here + } + }; + } + + @Bean(name = MetricsComponent.METRIC_REGISTRY_NAME) + public MetricRegistry getMetricRegistry() { + MetricRegistry registry = ...; + return registry; + } +}]]></script> +</div></div> <div class="aui-message problem shadowed information-macro"> + <span class="aui-icon icon-problem">Icon</span> + <div class="message-content"> + <p><code>MetricRegistry</code> uses internal thread(s) for reporting. There is no public API in version 3.0.1 for users to clean up on exit. Thus using Camel Metrics Component leads to Java classloader leak and my cause <code>OutOfMemoryErrors</code> in some cases.</p> + </div> + </div> +<h3 id="MetricsComponent-Usage">Usage</h3><p>Each metric has type and name. Supported types are <a shape="rect" href="#MetricsComponent-counter">counter</a>, <a shape="rect" href="#MetricsComponent-histogram">histogram</a>, <a shape="rect" href="#MetricsComponent-meter">meter</a> and <a shape="rect" href="#MetricsComponent-timer">timer</a>. Metric name is simple string. If metric type is not provided then type meter is used by default.</p><h4 id="MetricsComponent-Headers">Headers</h4><p>Metric name defined in URI can be overridden by using header with name <code>CamelMetricsName</code>.</p><p>For example</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl"> +<script class="theme: Default; brush: java; gutter: false" type="syntaxhighlighter"><![CDATA[from("direct:in") + .setHeader(MetricsConstants.HEADER_METRIC_NAME, constant("new.name")) + .to("metrics:counter:name.not.used") + .to("direct:out");]]></script> +</div></div><p>will update counter with name <code>new.name</code> instead of <code>name.not.used</code>.</p><p>All Metrics specific headers are removed from the message once Metrics endpoint finishes processing of exchange. While processing exchange Metrics endpoint will catch all exceptions and write log entry using level <code>warn</code>.</p><h3 id="MetricsComponent-counterMetricstypecounter"><span class="confluence-anchor-link" id="MetricsComponent-counter"></span>Metrics type counter</h3><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl"> +<script class="theme: Default; brush: text; gutter: false" type="syntaxhighlighter"><![CDATA[metrics:counter:metricname[?options]]]></script> +</div></div><h4 id="MetricsComponent-Options"><span style="line-height: 1.5;">Options</span></h4><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">increment </td><td colspan="1" rowspan="1" class="confluenceTd">-</td><td colspan="1" rowspan="1" class="confluenceTd">Long value to add to the counter</td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">decrement</td><td colspan="1" rowspan="1" class="confluenceTd">-</td><td colspan="1" rowspan="1" class="confluenceTd">Long value to subtract from the counter</td></tr></tbody></table></div><p>If neither <code>increment</code> or <code>decrement</code> is defined then counter value will be incremented by one. If <code>increment</code> and <code>decrement</code> are both d efined only increment operation is called.<span style="line-height: 1.4285715;"> </span></p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl"> +<script class="theme: Default; brush: java; gutter: false" type="syntaxhighlighter"><![CDATA[// update counter simple.counter by 7 +from("direct:in") + .to("metric:counter:simple.counter?increment=7") + .to("direct:out");]]></script> +</div></div><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl"> +<script class="theme: Default; brush: java; gutter: false" type="syntaxhighlighter"><![CDATA[// increment counter simple.counter by 1 +from("direct:in") + .to("metric:counter:simple.counter") + .to("direct:out");]]></script> +</div></div><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl"> +<script class="theme: Default; brush: java; gutter: false" type="syntaxhighlighter"><![CDATA[// decrement counter simple.counter by 3 +from("direct:in") + .to("metric:counter:simple.counter?decrement=3") + .to("direct:out");]]></script> +</div></div><h4 id="MetricsComponent-Headers.1">Headers</h4><p><span style="line-height: 1.4285715;">Message headers can be used to override <code>increment</code> and <code>decrement</code> values specified in Metrics component URI.</span></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">Description</th><th colspan="1" rowspan="1" class="confluenceTh">Expected type</th></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">CamelMetricsCounterIncrement </td><td colspan="1" rowspan="1" class="confluenceTd">Override increment value in URI</td><td colspan="1" rowspan="1" class="confluenceTd">Long</td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">CamelMetricsCounterDecrement </td><td colspan="1" rowspan="1" class="confluenceTd">Override decrement value in URI</td><td colspan="1" rowspan="1" class="confluenceTd">Long</td></tr></tbody></ta ble></div><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl"> +<script class="theme: Default; brush: java; gutter: false" type="syntaxhighlighter"><![CDATA[// update counter simple.counter by 417 +from("direct:in") + .setHeader(MetricsConstants.HEADER_COUNTER_INCREMENT, constant(417L)) + .to("metric:counter:simple.counter?increment=7") + .to("direct:out");]]></script> +</div></div><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl"> +<script class="theme: Default; brush: java; gutter: false" type="syntaxhighlighter"><![CDATA[// updates counter using simple language to evaluate body.length +from("direct:in") + .setHeader(MetricsConstants.HEADER_COUNTER_INCREMENT, simple("${body.length}")) + .to("metrics:counter:body.length") + .to("mock:out");]]></script> +</div></div><h3 id="MetricsComponent-histogramMetrictypehistogram"><span class="confluence-anchor-link" id="MetricsComponent-histogram"></span>Metric type histogram</h3><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl"> +<script class="theme: Default; brush: text; gutter: false" type="syntaxhighlighter"><![CDATA[metrics:histogram:metricname[?options]]]></script> +</div></div><h4 id="MetricsComponent-Options.1">Options</h4><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">value</td><td colspan="1" rowspan="1" class="confluenceTd">-</td><td colspan="1" rowspan="1" class="confluenceTd">Value to use in histogram</td></tr></tbody></table></div><p>If no <code>value</code> is not set nothing is added to histogram and warning is logged.</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl"> +<script class="theme: Default; brush: java; gutter: false" type="syntaxhighlighter"><![CDATA[// adds value 9923 to simple.histogram +from("direct:in") + .to("metric:histogram:simple.histogram?value=9923") + .to("direct:out");]]></script> +</div></div><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl"> +<script class="theme: Default; brush: java; gutter: false" type="syntaxhighlighter"><![CDATA[// nothing is added to simple.histogram; warning is logged +from("direct:in") + .to("metric:histogram:simple.histogram") + .to("direct:out");]]></script> +</div></div><h4 id="MetricsComponent-Headers.2">Headers</h4><p>Message header can be used to override value specified in Metrics component URI.</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">Description</th><th colspan="1" rowspan="1" class="confluenceTh">Expected type</th></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">CamelMetricsHistogramValue</td><td colspan="1" rowspan="1" class="confluenceTd">Override histogram value in URI</td><td colspan="1" rowspan="1" class="confluenceTd">Long</td></tr></tbody></table></div><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl"> +<script class="theme: Default; brush: java; gutter: false" type="syntaxhighlighter"><![CDATA[// adds value 992 to simple.histogram +from("direct:in") + .setHeader(MetricsConstants.HEADER_HISTOGRAM_VALUE, constant(992L)) + .to("metric:histogram:simple.histogram?value=700") + .to("direct:out")]]></script> +</div></div><h3 id="MetricsComponent-meterMetrictypemeter"><span class="confluence-anchor-link" id="MetricsComponent-meter"></span>Metric type meter</h3><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl"> +<script class="theme: Default; brush: text; gutter: false" type="syntaxhighlighter"><![CDATA[metrics:meter:metricname[?options]]]></script> +</div></div><h4 id="MetricsComponent-Options.2"><span style="line-height: 1.4285715;">Options</span></h4><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">mark </td><td colspan="1" rowspan="1" class="confluenceTd">-</td><td colspan="1" rowspan="1" class="confluenceTd">Long value to use as mark</td></tr></tbody></table></div><p><span style="line-height: 1.4285715;">If <code>mark</code> is not set then <code>meter.mark()</code> is called without argument.</span></p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl"> +<script class="theme: Default; brush: java; gutter: false" type="syntaxhighlighter"><![CDATA[// marks simple.meter without value +from("direct:in") + .to("metric:simple.meter") + .to("direct:out");]]></script> +</div></div><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl"> +<script class="theme: Default; brush: java; gutter: false" type="syntaxhighlighter"><![CDATA[// marks simple.meter with value 81 +from("direct:in") + .to("metric:meter:simple.meter?mark=81") + .to("direct:out");]]></script> +</div></div><h4 id="MetricsComponent-Headers.3">Headers</h4><p>Message header can be used to override <code>mark</code> value specified in Metrics component URI.</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">Description</th><th colspan="1" rowspan="1" class="confluenceTh">Expected type</th></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">CamelMetricsMeterMark</td><td colspan="1" rowspan="1" class="confluenceTd">Override mark value in URI</td><td colspan="1" rowspan="1" class="confluenceTd">Long</td></tr></tbody></table></div><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl"> +<script class="theme: Default; brush: java; gutter: false" type="syntaxhighlighter"><![CDATA[// updates meter simple.meter with value 345 +from("direct:in") + .setHeader(MetricsConstants.HEADER_METER_MARK, constant(345L)) + .to("metric:meter:simple.meter?mark=123") + .to("direct:out");]]></script> +</div></div><h3 id="MetricsComponent-timerMetricstypetimer"><span class="confluence-anchor-link" id="MetricsComponent-timer"></span>Metrics type timer</h3><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl"> +<script class="theme: Default; brush: text; gutter: false" type="syntaxhighlighter"><![CDATA[metrics:timer:metricname[?options]]]></script> +</div></div><h4 id="MetricsComponent-Options.3"><span style="line-height: 1.4285715;">Options</span></h4><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">action</td><td colspan="1" rowspan="1" class="confluenceTd">-</td><td colspan="1" rowspan="1" class="confluenceTd">start or stop</td></tr></tbody></table></div><p><span style="line-height: 1.4285715;">If no <code>action</code> or invalid value is provided then warning is logged without any timer update. If action <code>start</code> is called on already running timer or <code>stop</code> is called on not running timer then nothing is updated and warning is logged.</span></p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl"> +<script class="theme: Default; brush: java; gutter: false" type="syntaxhighlighter"><![CDATA[// measure time taken by route "calculate" +from("direct:in") + .to("metrics:timer:simple.timer?action=start") + .to("direct:calculate") + .to("metrics:timer:simple.timer?action=stop");]]></script> +</div></div><p><code>TimerContext</code> objects are stored as Exchange properties between different Metrics component calls.</p><h4 id="MetricsComponent-Headers.4">Headers</h4><p>Message header can be used to override action value specified in Metrics component URI.</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">Description</th><th colspan="1" rowspan="1" class="confluenceTh">Expected type</th></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">CamelMetricsTimerAction</td><td colspan="1" rowspan="1" class="confluenceTd">Override timer action in URI</td><td colspan="1" rowspan="1" class="confluenceTd"><code>org.apache.camel.component.metrics.timer.TimerEndpoint.TimerAction</code></td></tr></tbody></table></div><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl"> +<script class="theme: Default; brush: java; gutter: false" type="syntaxhighlighter"><![CDATA[// sets timer action using header +from("direct:in") + .setHeader(MetricsConstants.HEADER_TIMER_ACTION, TimerAction.start) + .to("metric:timer:simple.timer") + .to("direct:out");]]></script> +</div></div></div> + </td> + <td valign="top"> + <div class="navigation"> + <div class="navigation_top"> + <!-- NavigationBar --> +<div class="navigation_bottom" id="navigation_bottom"><h3 id="Navigation-Overview"><a shape="rect" href="overview.html">Overview</a></h3><ul class="alternate"><li><a shape="rect" href="index.html">Home</a></li><li><a shape="rect" href="download.html">Download</a></li><li><a shape="rect" href="getting-started.html">Getting Started</a></li><li><a shape="rect" href="faq.html">FAQ</a></li></ul><h3 id="Navigation-Documentation"><a shape="rect" href="documentation.html">Documentation</a></h3><ul class="alternate"><li><a shape="rect" href="user-guide.html">User Guide</a></li><li><a shape="rect" href="manual.html">Manual</a></li><li><a shape="rect" href="books.html">Books</a></li><li><a shape="rect" href="tutorials.html">Tutorials</a></li><li><a shape="rect" href="examples.html">Examples</a></li><li><a shape="rect" href="cookbook.html">Cookbook</a></li><li><a shape="rect" href="architecture.html">Architecture</a></li><li><a shape="rect" href="enterprise-integration-patterns.html">Enterprise Integration Patterns</a></li><li><a shape="rect" href="dsl.html">DSL</a></li><li><a shape="rect" href="components.html">Components</a></li><li><a shape="rect" href="data-format.html">Data Format</a></li><li><a shape="rect" href="languages.html">Languages</a></li><li><a shape="rect" href="security.html">Security</a></li><li><a shape="rect" href="security-advisories.html">Security Advisories</a></li></ul><h3 id="Navigation-Search">Search</h3><form enctype="application/x-www-form-urlencoded" method="get" id="cse-search-box" action="http://www.google.com/cse";> + <div> + <input type="hidden" name="cx" value="007878419884033443453:m5nhvy4hmyq"> + <input type="hidden" name="ie" value="UTF-8"> + <input type="text" name="q" size="21"> + <input type="submit" name="sa" value="Search"> + </div> +</form> +<script type="text/javascript" src="http://www.google.com/coop/cse/brand?form=cse-search-box&lang=en";></script><h3 id="Navigation-Community"><a shape="rect" href="community.html">Community</a></h3><ul class="alternate"><li><a shape="rect" href="support.html">Support</a></li><li><a shape="rect" href="contributing.html">Contributing</a></li><li><a shape="rect" href="discussion-forums.html">Discussion Forums</a></li><li><a shape="rect" href="mailing-lists.html">Mailing Lists</a></li><li><a shape="rect" href="user-stories.html">User Stories</a></li><li><a shape="rect" href="news.html">News</a></li><li><a shape="rect" href="articles.html">Articles</a></li><li><a shape="rect" href="site.html">Site</a></li><li><a shape="rect" href="team.html">Team</a></li><li><a shape="rect" class="external-link" href="http://camel-extra.googlecode.com/"; rel="nofollow">Camel Extra</a></li></ul><h3 id="Navigation-Developers"><a shape="rect" href="developers.html">Developers</a></h3><ul class="alternate" ><li><a shape="rect" href="developers.html">Developer Guide</a></li><li><a >shape="rect" href="source.html">Source</a></li><li><a shape="rect" >href="building.html">Building</a></li><li><a shape="rect" >href="javadoc.html">JavaDoc</a></li><li><a shape="rect" >href="irc-room.html">IRC Room</a></li></ul><h3 >id="Navigation-ApacheSoftwareFoundation">Apache Software Foundation</h3><ul >class="alternate"><li><a shape="rect" class="external-link" >href="http://www.apache.org/licenses/";>License</a></li><li><a shape="rect" >class="external-link" >href="http://www.apache.org/foundation/sponsorship.html";>Sponsorship</a></li><li><a > shape="rect" class="external-link" >href="http://www.apache.org/foundation/thanks.html";>Thanks</a></li><li><a >shape="rect" class="external-link" >href="http://www.apache.org/security/";>Security</a></li></ul></div> + <!-- NavigationBar --> + </div> + </div> + </td> + </tr> + </tbody> + </table> + + + <div class="bottom_red_bar"></div> + </div> + </div> + </div> +</div> +<div class="black_box"> +<div class="footer"> + <div class="footer_l"> + <div class="footer_r"> + <div> + <a href="$base/privacy-policy.html">Privacy Policy</a> - + (<a href="https://cwiki.apache.org/confluence/pages/editpage.action?pageId=44994369";>edit page</a>) + (<a href="https://cwiki.apache.org/confluence/pages/viewpage.action?pageId=44994369&showComments=true&showCommentArea=true#addcomment";>add comment</a>) + </div> + </div> + </div> +</div> +</div> +</div> +<div class="design_attribution"> +© 2004-2014 The Apache Software Foundation. +<br> +Apache Camel, Camel, Apache, the Apache feather logo, and the Apache Camel project logo are trademarks of The Apache Software Foundation. All other marks mentioned may be trademarks or registered trademarks of their respective owners. +<br> +<a href="http://hiramchirino.com";>Graphic Design By Hiram</a> +</div> + +<!-- Camel committers that would like access to the Analytics, send a note to priv...@camel.apache.org --> +<script type="text/javascript"> + + var _gaq = _gaq || []; + _gaq.push(['_setAccount', 'UA-25976253-1']); + _gaq.push(['_trackPageview']); + + (function() { + var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); + })(); + +</script> + +</body> +</html> + + Modified: websites/production/camel/content/transport.html ============================================================================== --- websites/production/camel/content/transport.html (original) +++ websites/production/camel/content/transport.html Wed Aug 13 14:18:28 2014 @@ -351,7 +351,9 @@ disruptor-vm:someName[?<option>] </div></div></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Uses Jakarta Commons Logging to log the message exchange to some underlying logging system like log4j</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" href="lucene.html">Lucene</a> / camel-lucene</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl"> <script class="theme: Default; brush: plain; gutter: false" type="syntaxhighlighter"><![CDATA[lucene:searcherName:<insert|query>[?options] ]]></script> -</div></div></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Uses Apache Lucene to perform Java-based indexing and full text based searches using advanced analysis/tokenization capabilities</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" href="mina.html">MINA</a> / camel-mina</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl"> +</div></div></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Uses Apache Lucene to perform Java-based indexing and full text based searches using advanced analysis/tokenization capabilities</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" href="metrics-component.html">Metrics</a> / camel-metrics</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl"> +<script class="theme: Default; brush: plain; gutter: false" type="syntaxhighlighter"><![CDATA[Â metrics:[meter|counter|histogram|timer]:metricname[?options]]]></script> +</div></div></td><td colspan="1" rowspan="1" class="confluenceTd"><p><span style="line-height: 1.4285715;">Uses </span><a shape="rect" class="external-link" href="http://metrics.codahale.com/"; style="line-height: 1.4285715;" rel="nofollow">Metrics</a><span style="line-height: 1.4285715;"> </span><span style="line-height: 1.4285715;"> to collect application statistics directly from Camel routes.</span></p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" href="mina.html">MINA</a> / camel-mina</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl"> <script class="theme: Default; brush: plain; gutter: false" type="syntaxhighlighter"><![CDATA[mina:[tcp|udp|vm]:host[:port][?options] ]]></script> </div></div></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Working with <a shape="rect" class="external-link" href="http://mina.apache.org/";>Apache MINA 1.x</a></p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" href="mina2.html">MINA2</a> / camel-mina2</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl"> Modified: websites/production/camel/content/uris.html ============================================================================== --- websites/production/camel/content/uris.html (original) +++ websites/production/camel/content/uris.html Wed Aug 13 14:18:28 2014 @@ -356,7 +356,9 @@ disruptor-vm:someName[?<option>] </div></div></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Uses Jakarta Commons Logging to log the message exchange to some underlying logging system like log4j</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" href="lucene.html">Lucene</a> / camel-lucene</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl"> <script class="theme: Default; brush: plain; gutter: false" type="syntaxhighlighter"><![CDATA[lucene:searcherName:<insert|query>[?options] ]]></script> -</div></div></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Uses Apache Lucene to perform Java-based indexing and full text based searches using advanced analysis/tokenization capabilities</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" href="mina.html">MINA</a> / camel-mina</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl"> +</div></div></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Uses Apache Lucene to perform Java-based indexing and full text based searches using advanced analysis/tokenization capabilities</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" href="metrics-component.html">Metrics</a> / camel-metrics</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl"> +<script class="theme: Default; brush: plain; gutter: false" type="syntaxhighlighter"><![CDATA[Â metrics:[meter|counter|histogram|timer]:metricname[?options]]]></script> +</div></div></td><td colspan="1" rowspan="1" class="confluenceTd"><p><span style="line-height: 1.4285715;">Uses </span><a shape="rect" class="external-link" href="http://metrics.codahale.com/"; style="line-height: 1.4285715;" rel="nofollow">Metrics</a><span style="line-height: 1.4285715;"> </span><span style="line-height: 1.4285715;"> to collect application statistics directly from Camel routes.</span></p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" href="mina.html">MINA</a> / camel-mina</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl"> <script class="theme: Default; brush: plain; gutter: false" type="syntaxhighlighter"><![CDATA[mina:[tcp|udp|vm]:host[:port][?options] ]]></script> </div></div></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Working with <a shape="rect" class="external-link" href="http://mina.apache.org/";>Apache MINA 1.x</a></p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" href="mina2.html">MINA2</a> / camel-mina2</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
