This project is a Hyperic HQ plugin for monitoring HornetQ
This HornetQ plugin is intended for monitoring stand-alone installations of HornetQ. It should also support embedded HornetQ installations.
Source code is available at github.com/ClarityServices/hyperic-hornetq
Should support HornetQ Server running on any platform
After installing the hyperic plugin add the server "HornetQ V2.x" to the platform being monitored.
For the complete list of Metrics available, please see the HyperForge HornetQ documentation
Metrics Being Gathered:
-
HornetQ Connection Count
-
Queue Depth
-
Message Processing Rates
-
Java Heap Free and Used
-
Thread Count
-
Garbage Collection Count & Time per Minute
Messages are optionally reported from hornetq.log and can be filtered by regex include/exclude.
The hornetq config file can be monitored for changes. See client installation instructions below
For a queue:
-
pause
-
resume
-
sendMessagesToDeadLetterAddress
-
listMessages
-
moveMessages
-
listMessageCounterAsHTML
-
listMessageCounterHistoryAsHTML
Remote JMX must be enabled first for the HornetQ server
Tested on Red Hat Enterprise Linux 5 with HornetQ 2.1.2.Final
Tested with Hyperic HQ version 4.4
Server Installation
-
Copy the file hyperic-hornetq.xml into the following folder under the server installation: hq-engine/server/default/deploy/hq.ear/hq-plugins
-
Output similar to the following should appear in the server logfile (logs/server.log)
2011-02-21 13:53:53,972 INFO [ScannerThread] [org.hyperic.hq.product.server.mbean.ProductPluginDeployer@654] HQ plugin hornetq-plugin.xml undeployed 2011-02-21 13:53:53,995 INFO [ScannerThread] [org.hyperic.hq.product.server.mbean.ProductPluginDeployer@654] HQ plugin hornetq registered 2011-02-21 13:53:54,001 INFO [ScannerThread] [org.hyperic.hq.product.server.session.ProductManagerEJBImpl@320] hornetq unknown -- registering 2011-02-21 13:53:54,217 INFO [ScannerThread] [org.hyperic.hq.product.server.mbean.ProductPluginDeployer@654] HQ plugin hornetq deployed
-
Add this line to the run.sh file which starts HornetQ, before the line that starts with: "export JVM_ARGS"
export CLUSTER_PROPS="$CLUSTER_PROPS -Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.port=6969 -Dcom.sun.management.jmxremote.ssl=false -Dcom.sun.management.jmxremote.authenticate=false"
-
Copy the file hyperic-hornetq.xml into the plugins folder under the client installation. The path should be similar to: agent/bundles/agent-4.4.0-1509/pdk/plugins/
-
Restart the agent to pull in the new plugin file
- Code:
git clone git://github.com/ClarityServices/hyperic-hornetq.git
- Home: https://github.com/ClarityServices/hyperic-hornetq
- Bugs: https://github.com/ClarityServices/hyperic-hornetq/issues
To generate updated documentation for the HyperForge Wiki, run the following command:
java -jar bundles/agent-4.4.0-1509/pdk/lib/hq-product.jar -Dplugins.exclude=vsphere -m generate -a metrics-wiki
Then update the page on HyperForge
Reid Morrison :: [email protected] :: @reidmorrison
Copyright 2011 Clarity Services, Inc.
Licensed 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.