Added: incubator/activemq/site/JMX URL: http://svn.apache.org/viewcvs/incubator/activemq/site/JMX?rev=374430&view=auto ============================================================================== --- incubator/activemq/site/JMX (added) +++ incubator/activemq/site/JMX Thu Feb 2 08:31:10 2006 @@ -0,0 +1,399 @@ + + + + + + + + ActiveMQ - JMX + + + + + + + + + + + + + + + +
+ + + + + + +
+

Overview

+ +

Community

+ +

Using ActiveMQ

+ +

Features

+ +

Connectivitiy

+ +

Utilities

+ +

External Tools

+ +

Related Projects

+ +

Support

+ +

Developers

+ +

Tools we use

+ +

Feeds

+ + + + + + + + + +
+
+
+ Site +
+ + + News +
+
+ +
+ + + + + +
+ JMX + + +
+
+ + +
+
+

ActiveMQ 4.x or later has extensive support for JMX to allow you to monitor and control the behaviour of the broker.

+

Currently, one way to monitor AMQ is to enable JMX and use a JMX console.

+

For ActiveMQ 4.x:

+

1. Run a broker setting the broker property useJmx to true.

+

i.e.

+

For xbean configuration

+

+

+
<broker useJmx="true" brokerName="BROKER_1">
+...
+</broker>
+
+

+

 

+

For url configuration

+

+

+
broker:(tcp://localhost:61616)?useJmx=true
+
+

+

 

+

2. Run a JMX console (e.g. jconsole - JMX console included in the JDK <JAVA_HOME>/bin/jconsole.exe)

+

+

3. Connect to the given JMX URL:

+

+

+
jconsole service:jmx:rmi:///jndi/rmi://localhost:1099/jmxrmi
+
+
+

+

 

+

Using the Apache ActiveMQ version on OS X it appears as follows

+

+

For additional references provided below is a brief hierarchy of the mbeans and a listing of the properties, attributes, and operations of each mbeans.

+

ActiveMQ MBeans Hierarchy

+

+

ActiveMQ MBeans Reference

+

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
 Mbean Type
+
Properties / ObjectName  Attributes  Operations 
 Broker +
    +
  • Type=Broker
  • +
  • BrokerName=<broker identifier>
  • +
+
+
    +
  • BrokerId
  • +
  • TotalEnqueueCount
  • +
  • TotalDequeueCount
  • +
  • TotalConsumerCount
  • +
  • TotalMessages
  • +
  • TotalMessagesCached
  • +
  • MemoryLimit
  • +
  • MemoryPercentageUsed
  • +
+
+
    +
  • start
  • +
  • stop
  • +
  • terminateJVM
  • +
  • resetStatistics
  • +
  • gc
  • +
+
 Destination +
    +
  • Type=Queue|Topic
  • +
  • Destination=<destination identifier>
  • +
  • BrokerName=<name of broker>
  • +
+
+
    +
  • EnqueueCount
  • +
  • DequeueCount
  • +
  • ConsumerCount
  • +
  • Messages
  • +
  • MessagesCached
  • +
+
+
    +
  • resetStatistics
  • +
  • gc
  • +
+
 NetworkConnector +
    +
  • Type=NetworkConnector
  • +
  • BrokerName=<name of broker>
  • +
+
+
+
+
    +
  • start
  • +
  • stop
  • +
+
 Connector +
    +
  • Type=Connector
  • +
  • ConnectorName=<connector identifier>
  • +
  • BrokerName=<name of broker>
  • +
+
+
    +
  • EnqueueCount
  • +
  • DequeueCount
  • +
+
+
    +
  • start
  • +
  • stop
  • +
  • resetStatistics
  • +
+
 Connection +
    +
  • Type=Connection
  • +
  • Connection=<connection identifier>
  • +
  • BrokerName=<name of broker>
  • +
+
+
    +
  • EnqueueCount
  • +
  • DequeueCount
  • +
  • DispatchQueueSize
  • +
  • Active
  • +
  • Blocked
  • +
  • Connected
  • +
  • Slow
  • +
+
+
    +
  • start
  • +
  • stop
  • +
  • resetStatistics
  • +
+
+

+

Currently, we have just provided basic information to monitor, e.g. number of messages exchanged, consumer count, producer count, etc.

+

Command line utilities are also available to let you monitor ActiveMQ. Refer to ActiveMQ Command Line Tools Reference for usage information.

+
+
+ +   +