JON Performance Metrics Reference
Red Hat JBoss A-MQ
Monitoring the broker's performance
Version 6.2
Copyright © 2011-2015 Red Hat, Inc. and/or its affiliates.
15 Jun 2018
Abstract
Red Hat JBoss A-MQ provides a number of metrics that can be used to monitor a broker's performance.
Chapter 1. Monitoring Fuse Resources
Abstract
Using Red Hat JBoss Operations Network (JON), you can discover, import, and monitor Red Hat JBoss Fuse resources, including Red Hat JBoss A-MQ.
1.1. Installation Procedure
This section describes how to install the JON plug-in for Fuse.
Important
The JBoss ON for A-MQ plugin pack is not installed with the JON base distribution. You must download and install it separately after you have installed the JON base distribution.
To install
JBoss ON for A-MQ:
- Navigate to the Red Hat Customer Portal>Downloads>View All Downloads by Category.
- Under the category JBoss Development and Management, select Red Hat JBoss Operations Network
- Click Download next to Red Hat JBoss ON 3.x.0 Plugin Pack for Red Hat JBoss A-MQ 6.2.
- Unzip the plugin package (JON-3.X.0-Fuse/jon-plugin-pack-fuse-3.X.0.GA.zip) into a temporary location.
- Install the jar files in one of two ways:
- Hot DeployCopy the unpacked jar files into the JON
/installDir/server/plugins/directory. For details, see the JBoss Operations Network Installation Guide. - JON Server GUIFor details, see the JBoss Operations Network Installation Guide, or watch the video Installing JBoss Operations Network - Part 4, Installing JON Agent Plugins.
Chapter 2. JBoss ON Managed Fuse Resources
Overview
Metrics are collected for managed resources that are deployed in Red Hat JBoss Fuse.
- Apache ActiveMQ managed resources
- Apache Camel managed resources
- Apache CXF managed resources
- Apache ServiceMix 3.x managed resources
- Apache ServiceMix 4.x managed resources
- JBoss Fuse managed resources
- Fuse Fabric managed resources
Note
This guide descibes the metrics collected on Apache ActiveMQ-managed resources only. The Performance Metrics Reference for Red Hat JBoss Fuse describes the metrics collected on the other JBoss ON managed resources.
Important
Newly added resources, such as ActiveMQ queues and topics, will not appear in JON's list of resources until the JON agent discovers and adds them into inventory. By default, the agent scans for services at twenty-four hour intervals, but you can easily change the default interval either through the JON console or by resetting it in the agent's configuration file. For details, see Setting Discovery Scan Intervals in the Configuring JBoss ON Servers and Agents guide at https://access.redhat.com/site/documentation/.
Based on a managed resource's metrics, you can invoke Control Operations on the resource to avoid or correct throughput and performance problems.
Availability Status
For all JBoss Fuse managed resources, this metric is of category Availability and of measurement type Dynamic. It indicates the availability status of a resource during a given time slice.
Table 2.1. Availability Indicators
| Icon | State | Description |
|---|---|---|
 | Available (Up) | Resource is running and responding to availability checks. |
 | Down | Resource is not responding to availability checks. |
 | Unknown |
The agent has no record of the resource's state.
This could be due to the resource having been newly added to inventory, so has not yet been checked for availability. Or it could be that the agent is down.
|
 | Disabled |
The resource has been administratively marked as unavailable.
In reality, the resource could be running or stopped. When a resource is disabled, the server ignores availability reports from the agent to prevent unnecessary alerts triggered by known down (or cycling) states.
|
 | Mixed (resource groups only) | Members in a resource group have different availability states. |
Per Minute metrics
Because metrics of type Trends Up and category Throughput continuously increase, the rate of change becomes more important to track than the total number of exchanges. So JBoss ON automatically calculates and creates a secondary Per Minute metric for many of these type of exchanges. By default, the Per Minute metrics, rather than their counterparts, are enabled and charted.
Referencing properties in Dynamic Group Definition expressions
To reference configuration properties and traits in Dynamic Group Definition expressions, you must use the item's internal name.
Chapter 3. ActiveMQ Server
Overview
| Description: | ActiveMQ Server Process |
|---|---|
| Singleton: | no |
| Plugin: | ActiveMQ |
Parent Resource Types
- Managed Platforms
Child Resource Types
- ActiveMQ Server JVM Server
Autodiscovery Process Scans
Table 3.1. Metrics
| Name | Query |
|---|---|
${processScan.name} | process|basename|match=^java.*,arg|
-Dactivemq.home|match=.*
|
Connection Properties
Table 3.2. Connection Properties
| Name | Required | Description | Internal Name |
|---|---|---|---|
| Log Event Sources | yes | The list of log files that can be tracked | logEventSources |
| ActiveMQ Home | yes | The home directory of the Server | activemq.home |
| Server Resource Key | yes | Java system property that uniquely identifies this Server | resourceKey |
| Version File Pattern | yes | File name with Server version | versionFile |
| Home Directory | yes | System property for home directory | homeProperty |
| Log File | yes | Name of the log file to track | logFile |
| Connector Address | no | JMX Service URL | connectorAddress |
| Principal | no | JMX login principal/username | principal |
| Credentials | no | JMX login credentials/password | credentials |
Note
You must use the internal name to reference Configuration Properties in Dynamic Group Definition expressions.
Metrics
none
Configuration Properties
none
Operations
none
Package Types
none
Chapter 4. Broker Service
Overview
| Description: | ActiveMQ Broker |
|---|---|
| Singleton: | no |
| Plugin: | ActiveMQ |
Parent Resource Types
- ActiveMQ Server Platform
- JMX Server Platform
- Servicemix 3 Server Platform
- Servicemix 4 Server Platform
- Fabric Container Platform
- JBoss Fuse Container Platform
- JBossAS Server Platform
Child Resource Types
Connection Properties
Table 4.1. Connection Properties
| Name | Required | Description | Internal Name |
|---|---|---|---|
| Broker Version | no | The version of the broker | BrokerVersion |
| Object Name | yes | objectName | |
| Name Template | yes | nameTemplate | |
| Description Template | yes | descriptionTemplate | |
| Broker Name | yes | The name of the broker | brokerName |
Note
You must use the internal name to reference Configuration Properties in Dynamic Group Definition expressions.
Metrics
Table 4.2. Metrics
| Name | Type | Description | Internal Name |
|---|---|---|---|
| Total Consumer Count | measurement | Number of message consumers subscribed to destinations on the broker. | TotalConsumerCount |
| Total Enqueue Count | measurement | Number of messages that have been sent to the broker. | TotalEnqueueCount |
| Total Enqueue Count per Minute | measurement | Number of messages per minute that have been sent to the broker. | TotalEnqueueCount |
| Total Dequeue Count | measurement | Number of messages that have been acknowledged on the broker. | TotalDequeueCount |
| Total Dequeue Count per Minute | measurement | Number of messages per minute that have been acknowledged on the broker. | TotalDequeueCount |
| Total Message Count | measurement | Number of unacknowledged messages on the broker. | TotalMessageCount |
| Total Message Count per Minute | measurement | Number of unacknowledged messages on the broker per minute. | TotalMessageCount |
| Total Forward Count | measurement | Number of messages forwarded from the destination to a networked broker. | TotalForwardCount |
| Total Forward Count per Minute | measurement | Number of messages forwarded per minute from the destination to a networked broker. | TotalForwardCount |
| Memory Percent Usage | measurement | Percent of memory limit used. | MemoryPercentUsage |
| Memory Limit | measurement | Memory limit, in bytes, used for holding undelivered messages before paging to temporary storage. | MemoryLimit |
Note
You must use the internal name to reference Traits in Dynamic Group Definition expressions.
Configuration Properties
none
Operations
Table 4.3. Operations
| Name | Description |
|---|---|
| Start | Starts the Broker |
| Stop | Stops the Broker and all its components |
| Gc | Flushes Broker caches so that the garbage collector can reclaim more memory |
| Add Connector | Adds a Connector to the broker. |
| Remove Connector | Removes a Connector from the broker. |
| Reset Statistics | Reset all broker statistics. |
| Enable Statistics | Enable broker statistics. |
| Disable Statistics | Disable broker statistics. |
| Add Network Connector | Adds a Network Connector to the broker. |
| Remove Network Connector | Removes a Network Connector from the broker. |
| Stop Gracefully | Polls queues matching queueName for empty state before stopping |
| Terminate JVM | Shuts down the JVM. |
| Add Topic | Adds a Topic destination to the broker. |
| Add Queue | Adds a Queue destination to the broker. |
| Remove Topic | Removes a Topic destination from the Broker |
| Remove Queue | Removes a Queue destination from the Broker |
| Reload Log 4j Properties | Reloads log4j.properties from the classpath. |
| Get Transport Connector By Type | The url of transport connector by it's type; e.g. tcp, stomp, ssl, etc. |
Package Types
none
Chapter 5. Client Connector Service
Overview
| Description: | ActiveMQ Connector |
|---|---|
| Singleton: | no |
| Plugin: | ActiveMQ |
Parent Resource Types
Child Resource Types
none
Connection Properties
Table 5.1. Connection Properties
| Name | Required | Description | Internal Name |
|---|---|---|---|
| Object Name | yes | objectName | |
| Name Template | yes | nameTemplate | |
| Description Template | yes | descriptionTemplate | |
| Connector Name | yes | The name of the connector | connectorName |
Note
You must use the internal name to reference Configuration Properties in Dynamic Group Definition expressions.
Metrics
none
Configuration Properties
none
Operations
Table 5.2. Operations
| Name | Description |
|---|---|
| Connection Count | Returns the connection count |
| Reset Statistics | Resets the statistics |
| Enable Statistics | Enables statistics gathering |
| Disable Statistics | Disables statistics gathering |
| Start | Starts the Connector |
| Stop | Stops the Connector |
Package Types
none
Chapter 6. Connector Service
Overview
| Description: | ActiveMQ Connector |
|---|---|
| Singleton: | no |
| Plugin: | ActiveMQ |
Parent Resource Types
Child Resource Types
none
Connection Properties
Table 6.1. Connection Properties
| Name | Required | Description | Internal Name |
|---|---|---|---|
| Object Name | yes | objectName | |
| Name Template | yes | nameTemplate | |
| Description Template | yes | descriptionTemplate | |
| Connector Name | yes | The name of the connector | connectorName |
Note
You must use the internal name to reference Configuration Properties in Dynamic Group Definition expressions.
Metrics
none
Configuration Properties
none
Operations
Table 6.2. Operations
| Name | Description |
|---|---|
| Connection Count | Returns the connection count |
| Reset Statistics | Resets the statistics |
| Enable Statistics | Enables statistics gathering |
| Disable Statistics | Disables statistics gathering |
| Start | Starts the Connector |
| Stop | Stops the Connector |
Package Types
none
Chapter 7. Network Connector Service
Overview
| Description: | ActiveMQ Connector |
|---|---|
| Singleton: | no |
| Plugin: | ActiveMQ |
Parent Resource Types
Child Resource Types
none
Connection Properties
Table 7.1. Connection Properties
| Name | Required | Description | Internal Name |
|---|---|---|---|
| Object Name | yes | objectName | |
| Name Template | yes | nameTemplate | |
| Description Template | yes | descriptionTemplate | |
| Connector Name | yes | The name of the connector | connectorName |
Note
You must use the internal name to reference Configuration Properties in Dynamic Group Definition expressions.
Metrics
none
Configuration Properties
none
Operations
Table 7.2. Operations
| Name | Description |
|---|---|
| Start | Starts the Connector |
| Stop | Stops the Connector |
Package Types
none
Chapter 8. Queue Service
Overview
| Description: | ActiveMQ Queue |
|---|---|
| Singleton: | no |
| Plugin: | ActiveMQ |
Parent Resource Types
Child Resource Types
none
Connection Properties
Table 8.1. Connection Properties
| Name | Required | Description | Internal Name |
|---|---|---|---|
| Object Name | yes | objectName | |
| Name Template | yes | nameTemplate | |
| Description Template | yes | descriptionTemplate | |
| Destination | yes | destination |
Note
You must use the internal name to reference Configuration Properties in Dynamic Group Definition expressions.
Metrics
Table 8.2. Metrics
| Name | Type | Description | Internal Name |
|---|---|---|---|
| Enqueue Count | measurement | Number of messages that have been sent to the destination | EnqueueCount |
| Enqueue Count per Minute | measurement | Number of messages per minute that have been sent to the destination | EnqueueCount |
| Dequeue Count | measurement | Number of messages that have been acknowledged (and removed) from the destination. | DequeueCount |
| Dequeue Count per Minute | measurement | Number of messages per minute that have been acknowledged (and removed) from the destination. | DequeueCount |
| Forward Count | measurement | Number of messages forwarded from the destination to a networked broker. | ForwardCount |
| Forward Count per Minute | measurement | Number of messages forwarded per minute from the destination to a networked broker. | ForwardCount |
| Consumer Count | measurement | Number of consumers subscribed to this destination | ConsumerCount |
| Queue Size | measurement | Number of messages in the destination yet to be consumed. Potentially dispatched but unacknowledged. | QueueSize |
| Memory Percent Usage | measurement | The percentage of the memory limit used | MemoryPercentUsage |
Note
You must use the internal name to reference Traits in Dynamic Group Definition expressions.
Configuration Properties
none
Operations
Table 8.3. Operations
| Name | Description |
|---|---|
| Purge | Removes all of the messages in the queue |
| Remove Message | Remove a message from the destination by JMS message ID. If the message has been dispatched, it cannot be deleted and false is returned. |
| Remove Matching Messages | Removes up to a specified number of messages from the destination based on an SQL-92 selection on the message headers or XPATH on the body. |
| Copy Message To | Copies a message with the given JMS message ID into the specified destination. |
| Copy Matching Messages To | Copies up to a specified number of messages based on an SQL-92 selecton on the message headers or XPATH on the body into the specified destination. |
| Move Message To | Moves a message with the given JMS message ID into the specified destination. |
| Move Matching Messages To | Moves up to a specified number of messages based on an SQL-92 selecton on the message headers or XPATH on the body into the specified destination. |
| Retry Message | Moves a message with the given JMS message back to its original destination |
| Does Cursor Have Space | Message cursor has memory space available |
| Does Cursor Have Messages Buffered | Message cursor has buffered messages to deliver |
| Cursor Size | Number of messages available to be paged in by the cursor. |
| Reset Statistics | Resets statistics |
| Send Text Message | Sends a text message to this destination |
| Browse | Browse messages sent to this destination |
Package Types
none
Chapter 9. Topic Service
Overview
| Description: | ActiveMQ Topic |
|---|---|
| Singleton: | no |
| Plugin: | ActiveMQ |
Parent Resource Types
Child Resource Types
none
Connection Properties
Table 9.1. Connection Properties
| Name | Required | Description | Internal Name |
|---|---|---|---|
| Object Name | yes | objectName | |
| Name Template | yes | nameTemplate | |
| Description Template | yes | descriptionTemplate | |
| Destination | yes | destination |
Note
You must use the internal name to reference Configuration Properties in Dynamic Group Definition expressions.
Metrics
Table 9.2. Metrics
| Name | Type | Description | Internal Name |
|---|---|---|---|
| Enqueue Count | measurement | Number of messages that have been sent to the destination | EnqueueCount |
| Enqueue Count per Minute | measurement | Number of messages per minute that have been sent to the destination | EnqueueCount |
| Dequeue Count | measurement | Number of messages that have been acknowledged (and removed) from the destination. | DequeueCount |
| Dequeue Count per Minute | measurement | Number of messages per minute that have been acknowledged (and removed) from the destination. | DequeueCount |
| Forward Count | measurement | Number of messages forwarded from the destination to a networked broker. | ForwardCount |
| Forward Count per Minute | measurement | Number of messages forwarded per minute from the destination to a networked broker. | ForwardCount |
| Consumer Count | measurement | Number of consumers subscribed to this destination | ConsumerCount |
| Queue Size | measurement | Number of messages in the destination yet to be consumed. Potentially dispatched but unacknowledged. | QueueSize |
| Memory Percent Usage | measurement | The percentage of the memory limit used | MemoryPercentUsage |
Note
You must use the internal name to reference Traits in Dynamic Group Definition expressions.
Configuration Properties
none
Operations
Table 9.3. Operations
| Name | Description |
|---|---|
| Reset Statistics | Resets statistics |
| Send Text Message | Sends a text message to this destination |
| Browse | Browse messages to this destination |
Package Types
none
Legal Notice
Trademark Disclaimer
The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at http://creativecommons.org/licenses/by-sa/3.0/. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, JBoss, MetaMatrix, Fedora, the Infinity Logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Apache, ServiceMix, Camel, CXF, and ActiveMQ are trademarks of Apache Software Foundation. Any other names contained herein may be trademarks of their respective owners.
