Author: buildbot
Date: Mon Jul 29 16:21:09 2013
New Revision: 871741
Log:
Production update by buildbot for camel
Modified:
websites/production/camel/content/cache/main.pageCache
websites/production/camel/content/camel-jmx.html
Modified: websites/production/camel/content/cache/main.pageCache
==============================================================================
Binary files - no diff available.
Modified: websites/production/camel/content/camel-jmx.html
==============================================================================
--- websites/production/camel/content/camel-jmx.html (original)
+++ websites/production/camel/content/camel-jmx.html Mon Jul 29 16:21:09 2013
@@ -93,7 +93,7 @@ Camel also provides a <a shape="rect" hr
<h3><a shape="rect" name="CamelJMX-ActivatingJMXinCamel"></a>Activating JMX in
Camel</h3>
<div>
-<ul><li><a shape="rect" href="#CamelJMX-CamelJMX">Camel JMX</a></li><ul><li><a
shape="rect" href="#CamelJMX-ActivatingJMXinCamel">Activating JMX in
Camel</a></li><ul><li><a shape="rect"
href="#CamelJMX-UsingJMXtomanageApacheCamel">Using JMX to manage Apache
Camel</a></li><li><a shape="rect"
href="#CamelJMX-DisablingJMXinstrumentationagentinCamel">Disabling JMX
instrumentation agent in Camel</a></li><li><a shape="rect"
href="#CamelJMX-LocatingaMBeanServerintheJavaVM">Locating a MBeanServer in the
Java VM</a></li><li><a shape="rect"
href="#CamelJMX-CreatingJMXRMIConnectorServer">Creating JMX RMI Connector
Server</a></li><li><a shape="rect" href="#CamelJMX-JMXServiceURL">JMX Service
URL</a></li><li><a shape="rect"
href="#CamelJMX-TheSystemPropertiesforCamelJMXsupport">The SystemProperties for
Camel JMX support</a></li><li><a shape="rect"
href="#CamelJMX-HowtouseauthenticationwithJMX">How to use authentication with
JMX</a></li><li><a shape="rect" href="#CamelJMX-JMXinsideanApplicationSe
rver">JMX inside an Application Server</a></li><ul><li><a shape="rect"
href="#CamelJMX-Tomcat6">Tomcat 6</a></li><li><a shape="rect"
href="#CamelJMX-JBossAS4">JBoss AS 4</a></li><li><a shape="rect"
href="#CamelJMX-WebSphere">WebSphere</a></li><li><a shape="rect"
href="#CamelJMX-OracleOC4j">Oracle OC4j</a></li></ul><li><a shape="rect"
href="#CamelJMX-AdvancedJMXConfiguration">Advanced JMX
Configuration</a></li><li><a shape="rect"
href="#CamelJMX-Example%3A">Example:</a></li><li><a shape="rect"
href="#CamelJMX-jmxAgentPropertiesReference">jmxAgent Properties
Reference</a></li><li><a shape="rect"
href="#CamelJMX-Configuringwhethertoregistermbeansalways%2Cfornewroutesorjustbydefault">Configuring
whether to register mbeans always, for new routes or just by
default</a></li></ul><li><a shape="rect"
href="#CamelJMX-MonitoringCamelusingJMX">Monitoring Camel using
JMX</a></li><ul><li><a shape="rect"
href="#CamelJMX-UsingJConsoletomonitorCamel">Using JConsole to monitor
Camel</a></li><li><a sh
ape="rect" href="#CamelJMX-Whichendpointsareregistered">Which endpoints are
registered</a></li><li><a shape="rect"
href="#CamelJMX-Whichprocessorsareregistered">Which processors are
registered</a></li><li><a shape="rect"
href="#CamelJMX-HowtousetheJMXNotificationListenertolistenthecamelevents%3F">How
to use the JMX NotificationListener to listen the camel events?</a></li><li><a
shape="rect" href="#CamelJMX-UsingtheTracermbeantogetfinegrainedtracing">Using
the Tracer mbean to get fine grained tracing</a></li></ul><li><a shape="rect"
href="#CamelJMX-UsingJMXforyourownCamelCode">Using JMX for your own Camel
Code</a></li><ul><li><a shape="rect"
href="#CamelJMX-RegisteringyourownManagedEndpoints">Registering your own
Managed Endpoints</a></li><li><a shape="rect"
href="#CamelJMX-ProgrammingyourownManagedServices">Programming your own Managed
Services</a></li><li><a shape="rect"
href="#CamelJMX-ManagementNamingStrategy">ManagementNamingStrategy</a></li><li><a
shape="rect" href="#CamelJMX-M
anagementnamingpattern">Management naming pattern</a></li><li><a shape="rect"
href="#CamelJMX-ManagementStrategy">ManagementStrategy</a></li><li><a
shape="rect"
href="#CamelJMX-Configuringlevelofgranularityforperformancestatistics">Configuring
level of granularity for performance statistics</a></li></ul><li><a
shape="rect" href="#CamelJMX-Hidingsensitiveinformation">Hiding sensitive
information</a></li><li><a shape="rect" href="#CamelJMX-SeeAlso">See
Also</a></li></ul></ul></div>
+<ul><li><a shape="rect" href="#CamelJMX-CamelJMX">Camel JMX</a></li><ul><li><a
shape="rect" href="#CamelJMX-ActivatingJMXinCamel">Activating JMX in
Camel</a></li><ul><li><a shape="rect"
href="#CamelJMX-UsingJMXtomanageApacheCamel">Using JMX to manage Apache
Camel</a></li><li><a shape="rect"
href="#CamelJMX-DisablingJMXinstrumentationagentinCamel">Disabling JMX
instrumentation agent in Camel</a></li><li><a shape="rect"
href="#CamelJMX-LocatingaMBeanServerintheJavaVM">Locating a MBeanServer in the
Java VM</a></li><li><a shape="rect"
href="#CamelJMX-CreatingJMXRMIConnectorServer">Creating JMX RMI Connector
Server</a></li><li><a shape="rect" href="#CamelJMX-JMXServiceURL">JMX Service
URL</a></li><li><a shape="rect"
href="#CamelJMX-TheSystemPropertiesforCamelJMXsupport">The SystemProperties for
Camel JMX support</a></li><li><a shape="rect"
href="#CamelJMX-HowtouseauthenticationwithJMX">How to use authentication with
JMX</a></li><li><a shape="rect" href="#CamelJMX-JMXinsideanApplicationSe
rver">JMX inside an Application Server</a></li><ul><li><a shape="rect"
href="#CamelJMX-Tomcat6">Tomcat 6</a></li><li><a shape="rect"
href="#CamelJMX-JBossAS4">JBoss AS 4</a></li><li><a shape="rect"
href="#CamelJMX-WebSphere">WebSphere</a></li><li><a shape="rect"
href="#CamelJMX-OracleOC4j">Oracle OC4j</a></li></ul><li><a shape="rect"
href="#CamelJMX-AdvancedJMXConfiguration">Advanced JMX
Configuration</a></li><li><a shape="rect"
href="#CamelJMX-Example%3A">Example:</a></li><li><a shape="rect"
href="#CamelJMX-jmxAgentPropertiesReference">jmxAgent Properties
Reference</a></li><li><a shape="rect"
href="#CamelJMX-Configuringwhethertoregistermbeansalways%2Cfornewroutesorjustbydefault">Configuring
whether to register mbeans always, for new routes or just by
default</a></li></ul><li><a shape="rect"
href="#CamelJMX-MonitoringCamelusingJMX">Monitoring Camel using
JMX</a></li><ul><li><a shape="rect"
href="#CamelJMX-UsingJConsoletomonitorCamel">Using JConsole to monitor
Camel</a></li><li><a sh
ape="rect" href="#CamelJMX-Whichendpointsareregistered">Which endpoints are
registered</a></li><li><a shape="rect"
href="#CamelJMX-Whichprocessorsareregistered">Which processors are
registered</a></li><li><a shape="rect"
href="#CamelJMX-HowtousetheJMXNotificationListenertolistenthecamelevents%3F">How
to use the JMX NotificationListener to listen the camel events?</a></li><li><a
shape="rect" href="#CamelJMX-UsingtheTracermbeantogetfinegrainedtracing">Using
the Tracer mbean to get fine grained tracing</a></li></ul><li><a shape="rect"
href="#CamelJMX-UsingJMXforyourownCamelCode">Using JMX for your own Camel
Code</a></li><ul><li><a shape="rect"
href="#CamelJMX-RegisteringyourownManagedEndpoints">Registering your own
Managed Endpoints</a></li><li><a shape="rect"
href="#CamelJMX-ProgrammingyourownManagedServices">Programming your own Managed
Services</a></li><li><a shape="rect"
href="#CamelJMX-ManagementNamingStrategy">ManagementNamingStrategy</a></li><li><a
shape="rect" href="#CamelJMX-M
anagementnamingpattern">Management naming pattern</a></li><li><a shape="rect"
href="#CamelJMX-ManagementStrategy">ManagementStrategy</a></li><li><a
shape="rect"
href="#CamelJMX-Configuringlevelofgranularityforperformancestatistics">Configuring
level of granularity for performance statistics</a></li></ul><li><a
shape="rect" href="#CamelJMX-Hidingsensitiveinformation">Hiding sensitive
information</a></li><ul><li><a shape="rect"
href="#CamelJMX-DeclaringwhichJMXattributesandoperationstosanitize%28hidesensitiveinformation%29">Declaring
which JMX attributes and operations to sanitize (hide sensitive
information)</a></li></ul><li><a shape="rect" href="#CamelJMX-SeeAlso">See
Also</a></li></ul></ul></div>
<div class="panelMacro"><table class="infoMacro"><colgroup span="1"><col
span="1" width="24"><col span="1"></colgroup><tr><td colspan="1" rowspan="1"
valign="top"><img align="middle"
src="https://cwiki.apache.org/confluence/images/icons/emoticons/information.gif";
width="16" height="16" alt="" border="0"></td><td colspan="1"
rowspan="1"><b>Spring JAR dependency, required for Camel 2.8 or older</b><br
clear="none"><tt>spring-context.jar</tt>, <tt>spring-aop.jar</tt>,
<tt>spring-beans.jar</tt>, and <tt>spring-core.jar</tt> are needed on the
classpath by Camel to be able to use JMX instrumentation. If these .jars are
not on the classpath, Camel will fallback to non JMX mode. This situation is
logged at <tt>WARN</tt> level using logger name
<tt>org.apache.camel.impl.DefaultCamelContext</tt>.
@@ -697,7 +697,18 @@ These information can be hidden by enabl
<p>This will mask <span class="error">[URI]</span>s having options such as
password and passphrase, and use <tt>xxxxxx</tt> as the replacement value.</p>
-<div class="panelMacro"><table class="infoMacro"><colgroup span="1"><col
span="1" width="24"><col span="1"></colgroup><tr><td colspan="1" rowspan="1"
valign="top"><img align="middle"
src="https://cwiki.apache.org/confluence/images/icons/emoticons/information.gif";
width="16" height="16" alt="" border="0"></td><td colspan="1"
rowspan="1">Setting sanitize=true will only mask password and passphrase
configured in <a shape="rect" href="uris.html" title="URIs">URIs</a>. If any
custom Camel <a shape="rect" href="component.html"
title="Component">Component</a> exposes custom JMX attributes then these
attributes is shown <em>as is</em>.</td></tr></table></div>
+<h4><a shape="rect"
name="CamelJMX-DeclaringwhichJMXattributesandoperationstosanitize%28hidesensitiveinformation%29"></a>Declaring
which JMX attributes and operations to sanitize (hide sensitive
information)</h4>
+
+<p>On the <tt>org.apache.camel.api.management.ManagedAttribute</tt> and
<tt>org.apache.camel.api.management.ManagedOperation</tt> the attribute
<tt>sanitize</tt> can be set to <tt>true</tt> to indicate that the result of
this JMX attribute/operation should be sanitized (if enabled on JMX agent, see
above).</p>
+
+<p>For example on the out of the box managed endpoints from camel-core
<tt>org.apache.camel.api.management.mbean.ManagedEndpointMBean</tt> we have
declared that the <tt>EndpointUri</tt> JMX attribute is sanitized.</p>
+<div class="code panel" style="border-width: 1px;"><div class="codeContent
panelContent">
+<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[
+ @ManagedAttribute(description = "Endpoint URI", sanitize = true)
+ String getEndpointUri();
+]]></script>
+</div></div>
+
<h3><a shape="rect" name="CamelJMX-SeeAlso"></a>See Also</h3>
![https://cwiki.apache.org/confluence/images/icons/emoticons/information.gif"](https://cwiki.apache.org/confluence/images/icons/emoticons/information.gif"){kind=link}