camel-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From build...@apache.org
Subject svn commit: r940838 - in /websites/production/camel/content: cache/main.pageCache ganglia.html
Date Fri, 20 Feb 2015 10:18:26 GMT
Author: buildbot
Date: Fri Feb 20 10:18:26 2015
New Revision: 940838

Log:
Production update by buildbot for camel

Modified:
    websites/production/camel/content/cache/main.pageCache
    websites/production/camel/content/ganglia.html

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

Modified: websites/production/camel/content/ganglia.html
==============================================================================
--- websites/production/camel/content/ganglia.html (original)
+++ websites/production/camel/content/ganglia.html Fri Feb 20 10:18:26 2015
@@ -85,7 +85,7 @@
 	<tbody>
         <tr>
         <td valign="top" width="100%">
-<div class="wiki-content maincontent"><h2 id="Ganglia-Gangliacomponent">Ganglia
component</h2><h4 id="Ganglia-AvailableasofCamel2.15.0">Available as of Camel
2.15.0</h4><p>Provides a mechanism to send a value (the message body) as a metric
to the <a shape="rect" class="external-link" href="http://ganglia.info" rel="nofollow">Ganglia</a>
monitoring system.&#160; Uses the gmetric4j library.&#160; Can be used in conjunction
with standard <a shape="rect" class="external-link" href="http://ganglia.info" rel="nofollow">Ganglia</a>
and <a shape="rect" class="external-link" href="https://github.com/ganglia/jmxetric" rel="nofollow">JMXetric</a>
for monitoring metrics from the OS, JVM and business processes through a single platform.</p><p>Maven
users will need to add the following dependency to their <code>pom.xml</code>
for this component:</p><div class="container" title="Hint: double-click to select
code"><p>&#160;</p><div class="code panel pdl" style="border-width:
1px;"><div class="codeC
 ontent panelContent pdl">
+<div class="wiki-content maincontent"><h2 id="Ganglia-Gangliacomponent">Ganglia
component</h2><h4 id="Ganglia-AvailableasofCamel2.15.0">Available as of Camel
2.15.0</h4><p>Provides a mechanism to send a value (the message body) as a metric
to the <a shape="rect" class="external-link" href="http://ganglia.info" rel="nofollow">Ganglia</a>
monitoring system.&#160; Uses the gmetric4j library.&#160; Can be used in conjunction
with standard <a shape="rect" class="external-link" href="http://ganglia.info" rel="nofollow">Ganglia</a>
and <a shape="rect" class="external-link" href="https://github.com/ganglia/jmxetric" rel="nofollow">JMXetric</a>
for monitoring metrics from the OS, JVM and business processes through a single platform.</p><p>You
should have a Ganglia gmond agent running on the machine where your JVM runs.&#160; The
gmond sends a heartbeat to the Ganglia infrastructure, camel-ganglia can't send the heartbeat
itself currently.</p><p>On most Linux systems (Debian, Ubuntu, Fedora a
 nd RHEL/CentOS with EPEL) you can just install the Ganglia agent package and it runs automatically
using multicast configuration.&#160; You can configure it to use regular UDP unicast if
you prefer.</p><p>Maven users will need to add the following dependency to their
<code>pom.xml</code> for this component:</p><div class="container" title="Hint:
double-click to select code"><p>&#160;</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[&lt;dependency&gt;
     &lt;groupId&gt;org.apache.camel&lt;/groupId&gt;
     &lt;artifactId&gt;camel-ganglia&lt;/artifactId&gt;
@@ -94,7 +94,24 @@
 &lt;/dependency&gt;]]></script>
 </div></div><h2 id="Ganglia-URIformat">URI format</h2><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[ganglia:address:port[?options]]]></script>
-</div></div><p class="line number1 index0 alt2">You can append query options
to the URI in the following format, <code>?option=value&amp;option=value&amp;...</code></p><h2
class="line number1 index0 alt2" id="Ganglia-GangliacomponentandendpointURIoptions">Ganglia
component and endpoint URI options</h2><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 value</th><th colspan="1" rowspan="1" class="confluenceTh">Description</th><th
colspan="1" rowspan="1" class="confluenceTh">Override with header</th></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd">mode</td><td colspan="1" rowspan="1"
class="confluenceTd">MULTICAST</td><td colspan="1" rowspan="1" class="confluenceTd">Send
the UDP metric packets using MULTICAST or UNICAST</td><td colspan="1" rowspan="1"
class="confluenceTd">&#160;</td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd">ttl</td>
 <td colspan="1" rowspan="1" class="confluenceTd">5</td><td colspan="1" rowspan="1"
class="confluenceTd">If using multicast, set the TTL of the packets</td><td colspan="1"
rowspan="1" class="confluenceTd">&#160;</td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd">wireFormat31x</td><td colspan="1" rowspan="1"
class="confluenceTd">true</td><td colspan="1" rowspan="1" class="confluenceTd">Use
the wire format of Ganglia 3.1.0 and later versions.&#160; Set this to false to use Ganglia
3.0.x or earlier.</td><td colspan="1" rowspan="1" class="confluenceTd">&#160;</td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd">groupName</td><td colspan="1" rowspan="1"
class="confluenceTd">Java</td><td colspan="1" rowspan="1" class="confluenceTd">The
group that the metric belongs to.</td><td colspan="1" rowspan="1" class="confluenceTd">&#160;</td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd">prefix</td><td colspan="1" rowspan="1"
class="confluenceTd">&#160;</td><td colspan
 ="1" rowspan="1" class="confluenceTd">(optional) Prefix the metric name with this string
and an underscore.</td><td colspan="1" rowspan="1" class="confluenceTd">&#160;</td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd">metricName</td><td colspan="1" rowspan="1"
class="confluenceTd">metric</td><td colspan="1" rowspan="1" class="confluenceTd">The
name to use for the metric.</td><td colspan="1" rowspan="1" class="confluenceTd">GangliaConstants.METRIC_NAME</td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd">type</td><td colspan="1" rowspan="1"
class="confluenceTd">STRING</td><td colspan="1" rowspan="1" class="confluenceTd">The
type of value, see GMetricType javadoc for permitted values. (Confluence not allowing the
link)</td><td colspan="1" rowspan="1" class="confluenceTd">GangliaConstants.METRIC_TYPE</td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd">slope</td><td colspan="1" rowspan="1"
class="confluenceTd">BOTH</td><td colspan="1" rowspan="1" class="co
 nfluenceTd">The slope, see GMetricSlope javadoc for permitted values. (Confluence not
allowing the link)</td><td colspan="1" rowspan="1" class="confluenceTd"><code
class="xml plain">GangliaConstants.METRIC_</code>SLOPE</td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd">units</td><td colspan="1" rowspan="1"
class="confluenceTd">&#160;</td><td colspan="1" rowspan="1" class="confluenceTd">(optional)
Any unit of measurement that qualifies the metric, e.g. widgets, litres, bytes.&#160;
Do not include a prefix such as k (kilo) or m (milli), other tools may scale the units later.&#160;
The value should be unscaled.</td><td colspan="1" rowspan="1" class="confluenceTd"><code
class="xml plain">GangliaConstants.METRIC_UNITS</code></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd">tmax</td><td colspan="1" rowspan="1"
class="confluenceTd">60</td><td colspan="1" rowspan="1" class="confluenceTd">Maximum
time in seconds that the value can be considered current.&#160; After th
 is, Ganglia considers the value to have expired.</td><td colspan="1" rowspan="1"
class="confluenceTd"><code class="xml plain">GangliaConstants.METRIC_</code>TMAX</td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd">dmax</td><td colspan="1" rowspan="1"
class="confluenceTd">0</td><td colspan="1" rowspan="1" class="confluenceTd">Minumum
time in seconds before Ganglia will purge the metric value if it expires.&#160; Set to
0 and the value will remain in Ganglia indefinitely until a gmond agent restart.</td><td
colspan="1" rowspan="1" class="confluenceTd"><code class="xml plain">GangliaConstants.METRIC_</code>DMAX</td></tr></tbody></table></div><h2
id="Ganglia-Messagebody">Message body</h2><p>Any value (such as a string or
numeric type) in the body is sent to the Ganglia system.</p><h2 id="Ganglia-Returnvalue/response">Return
value / response</h2><p>Ganglia sends metrics using unidirectional UDP or multicast.&#160;
There is no response or change to the message body.</p></div></d
 iv>
+</div></div><p class="line number1 index0 alt2">You can append query options
to the URI in the following format, <code>?option=value&amp;option=value&amp;...</code></p><h2
class="line number1 index0 alt2" id="Ganglia-GangliacomponentandendpointURIoptions">Ganglia
component and endpoint URI options</h2><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 value</th><th colspan="1" rowspan="1" class="confluenceTh">Description</th><th
colspan="1" rowspan="1" class="confluenceTh">Override with header</th></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd">mode</td><td colspan="1" rowspan="1"
class="confluenceTd">MULTICAST</td><td colspan="1" rowspan="1" class="confluenceTd">Send
the UDP metric packets using MULTICAST or UNICAST</td><td colspan="1" rowspan="1"
class="confluenceTd">&#160;</td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd">ttl</td>
 <td colspan="1" rowspan="1" class="confluenceTd">5</td><td colspan="1" rowspan="1"
class="confluenceTd">If using multicast, set the TTL of the packets</td><td colspan="1"
rowspan="1" class="confluenceTd">&#160;</td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd">wireFormat31x</td><td colspan="1" rowspan="1"
class="confluenceTd">true</td><td colspan="1" rowspan="1" class="confluenceTd">Use
the wire format of Ganglia 3.1.0 and later versions.&#160; Set this to false to use Ganglia
3.0.x or earlier.</td><td colspan="1" rowspan="1" class="confluenceTd">&#160;</td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd">groupName</td><td colspan="1" rowspan="1"
class="confluenceTd">Java</td><td colspan="1" rowspan="1" class="confluenceTd">The
group that the metric belongs to.</td><td colspan="1" rowspan="1" class="confluenceTd">&#160;</td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd">prefix</td><td colspan="1" rowspan="1"
class="confluenceTd">&#160;</td><td colspan
 ="1" rowspan="1" class="confluenceTd">(optional) Prefix the metric name with this string
and an underscore.</td><td colspan="1" rowspan="1" class="confluenceTd">&#160;</td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd">metricName</td><td colspan="1" rowspan="1"
class="confluenceTd">metric</td><td colspan="1" rowspan="1" class="confluenceTd">The
name to use for the metric.</td><td colspan="1" rowspan="1" class="confluenceTd">GangliaConstants.METRIC_NAME</td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd">type</td><td colspan="1" rowspan="1"
class="confluenceTd">STRING</td><td colspan="1" rowspan="1" class="confluenceTd">The
type of value, see GMetricType javadoc for permitted values. (Confluence not allowing the
link)</td><td colspan="1" rowspan="1" class="confluenceTd">GangliaConstants.METRIC_TYPE</td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd">slope</td><td colspan="1" rowspan="1"
class="confluenceTd">BOTH</td><td colspan="1" rowspan="1" class="co
 nfluenceTd">The slope, see GMetricSlope javadoc for permitted values. (Confluence not
allowing the link)</td><td colspan="1" rowspan="1" class="confluenceTd"><code
class="xml plain">GangliaConstants.METRIC_</code>SLOPE</td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd">units</td><td colspan="1" rowspan="1"
class="confluenceTd">&#160;</td><td colspan="1" rowspan="1" class="confluenceTd">(optional)
Any unit of measurement that qualifies the metric, e.g. widgets, litres, bytes.&#160;
Do not include a prefix such as k (kilo) or m (milli), other tools may scale the units later.&#160;
The value should be unscaled.</td><td colspan="1" rowspan="1" class="confluenceTd"><code
class="xml plain">GangliaConstants.METRIC_UNITS</code></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd">tmax</td><td colspan="1" rowspan="1"
class="confluenceTd">60</td><td colspan="1" rowspan="1" class="confluenceTd">Maximum
time in seconds that the value can be considered current.&#160; After th
 is, Ganglia considers the value to have expired.</td><td colspan="1" rowspan="1"
class="confluenceTd"><code class="xml plain">GangliaConstants.METRIC_</code>TMAX</td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd">dmax</td><td colspan="1" rowspan="1"
class="confluenceTd">0</td><td colspan="1" rowspan="1" class="confluenceTd">Minumum
time in seconds before Ganglia will purge the metric value if it expires.&#160; Set to
0 and the value will remain in Ganglia indefinitely until a gmond agent restart.</td><td
colspan="1" rowspan="1" class="confluenceTd"><code class="xml plain">GangliaConstants.METRIC_</code>DMAX</td></tr></tbody></table></div><h2
id="Ganglia-Messagebody">Message body</h2><p>Any value (such as a string or
numeric type) in the body is sent to the Ganglia system.</p><h2 id="Ganglia-Returnvalue/response">Return
value / response</h2><p>Ganglia sends metrics using unidirectional UDP or multicast.&#160;
There is no response or change to the message body.</p><h2 id="G
 anglia-Examples">Examples</h2><h3 id="Ganglia-SendingaStringmetric">Sending
a String metric</h3><p>The message body will be converted to a String and sent
as a metric value.&#160; Unlike numeric metrics, String values can't be charted but Ganglia
makes them available for reporting.&#160; The os_version string at the top of every Ganglia
host page is an example of a String metric.</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(&quot;direct:string.for.ganglia&quot;)
+    .setHeader(GangliaConstants.METRIC_NAME, simple(&quot;my_string_metric&quot;))
+    .setHeader(GangliaConstants.METRIC_TYPE, GMetricType.STRING)
+    .to(&quot;direct:ganglia.tx&quot;);
+
+from(&quot;direct:ganglia.tx&quot;)
+    .to(&quot;ganglia:239.2.11.71:8649?mode=MULTICAST&amp;prefix=test&quot;);]]></script>
+</div></div><h3 id="Ganglia-Sendinganumericmetric">Sending a numeric metric</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[from(&quot;direct:value.for.ganglia&quot;)
+    .setHeader(GangliaConstants.METRIC_NAME, simple(&quot;widgets_in_stock&quot;))
+    .setHeader(GangliaConstants.METRIC_TYPE, GMetricType.UINT32)
+    .setHeader(GangliaConstants.METRIC_UNITS, simple(&quot;widgets&quot;))
+    .to(&quot;direct:ganglia.tx&quot;);
+
+from(&quot;direct:ganglia.tx&quot;)
+    .to(&quot;ganglia:239.2.11.71:8649?mode=MULTICAST&amp;prefix=test&quot;);]]></script>
+</div></div></div></div>
         </td>
         <td valign="top">
           <div class="navigation">



Mime
View raw message