List of Attributes
| Attribute | Description | Default value |
| name | JMX ObjectName query string — Catalina:type=Manager,* | |
| ref | JMX Connection reference | jmx.server |
| echo | Echo command usage (access and result) | false |
| resultproperty | Prefix project property name to all founded MBeans (mbeans.[0..N].objectname) | |
| attributebinduing | bind ALL MBean attributes in addition to name | false |
| delimiter | Split result with delimiter (java.util.StringTokenizier) and use resultproperty as prefix to store tokens. | |
| separatearrayresults | When return value is an array, save result as property list ($resultproperty.[0..N] and $resultproperty.length) | true |
Get all Manager ObjectNames from all services and Hosts
<jmx:query
name=”Catalina:type=Manager,*
resultproperty=”manager” />
Now you can find the Session Manager at ${manager.[0..N].name} properties and access the result object counter with ${manager.length} property.
Example to get the Manager from servlet-examples application an bind all MBean properties
<jmx:query
name=”Catalina:type=Manager,context=/servlet-examples,host=localhost*”
attributebinding=”true”
resultproperty=”manager.servletExamples” />
Now you can find the manager at ${manager.servletExamples.0.name} property and can access all properties from this manager with ${manager.servletExamples.0.[manager attribute names]}. The result object counter from MBeans is stored ad ${manager.length} property.
Example to get all MBeans from a server and store inside an external XML property file
<project name=”jmx.query”
xmlns:jmx=”antlib:org.apache.catalina.ant.jmx”
default=”query-all” basedir=”.”>
<property name=”jmx.host” value=”localhost”/>
<property name=”jmx.port” value=”8050″/>
<property name=”jmx.username” value=”controlRole”/>
<property name=”jmx.password” value=”tomcat”/>
<target name=”query-all” description=”Query all MBeans of a server”>
<!– Configure connection –>
<jmx:open
host=”${jmx.host}”
port=”${jmx.port}”
ref=”jmx.server”
username=”${jmx.username}”
password=”${jmx.password}”/>
<!– Query MBean list –>
<jmx:query
name=”*:*”
resultproperty=”mbeans”
attributebinding=”false”/>
<echoproperties
destfile=”mbeans.properties”
prefix=”mbeans.”
format=”xml”/>
<!– Print results –>
<echo message=
“Number of MBeans in server ${jmx.host}:${jmx.port} is ${mbeans.length}”/>
</target>
</project>
Now you can find all MBeans inside the file mbeans.properties.
