ActiveMQ Monitoring

Monitor the performance metrics of your Apache ActiveMQ instances to keep your diverse systems connected and communicating.

Apache ActiveMQ enables easy processing of messages from various applications and communicates them across your infrastructure. Install the ActiveMQ plugin to get a detailed view of how your systems and services are performing - all in a single, intuitive dashboard.

This document details how to configure the ActiveMQ plugin and the monitoring metrics for providing in-depth visibility into the performance, availability, and usage stats of Apache ActiveMQ instances.

Performance Metrics

Total message count

total_message_count gives the total number of messages in the queue, including the number of enqueued and dequeued messages. The enqueue and the dequeue rate should match if the producer and active consumers are in sync.

Total connections count

Both the producer and consumer have to connect to the ActiveMQ instance for posting and consuming messages respectively. total_connections_count gives the total number of connections. The performance of the ActiveMQ instance will be affected if the number of connections go beyond the server capacity.

Total consumer count

Total number of consumers that have consumed the messages posted by the producers is shown by total_consumer_count.

Total producer count

Total number of producers that have posted messages to the ActiveMQ instance is shown by total_producer_count.

Prerequisites

  • Ensure the 'Python Requests' module is installed to fetch the performance metrics of ActiveMQ instances.
  • Our Linux server monitoring agent should be installed in the network or on the specific host where the ActiveMQ instance is running.
  • While adding a plugin, the plugin name and its folder name should be identical.
  • Execute the following command in your server to install the python requests module sudo pip install requests
Installing pip:
  • Use "pip" to install requests module

    (Note: pip is a package management system that is used to install and manage software packages written in Python.)

  • For CentOS, Fedora, RHEL:
    yum install python-devel
    yum install python-pip (or)
    easy_install pip
  • For Debian, Ubuntu:
    apt-get -y install python-pip

Plugin Installation

  • Download and install the latest version of the Site24x7 Linux agent in the server where you plan to run the plugin. If it is installed successfully, you will see a Linux server monitor in the Site24x7 Control Panel. This confirms that the agent is able to communicate with our data center.
  • Download the file activemq.py from our GitHub repository.
  • Change the values of ACTIVEMQ_HOST, ACTIVEMQ_PORT, ACTIVEMQ_USERNAME and ACTIVEMQ_PASSWORD to match your configuration
  • Create a directory with the name 'activemq', under Site24x7 Linux agent plugin directory '/opt/site24x7/monagent/plugins/' and place the 'activemq.py' file under '/opt/site24x7/monagent/plugins/activemq'
The agent will automatically execute the plugin within five minutes and send performance data to the Site24x7 data center.
Tip

Manually execute the plugin script using the following command and verify its output:

python activemq.py

View Data in the Site24x7 Web Client

  1. Log in to Site24x7 and go to Server > Plugins > Name of Plugin Monitor.
  2. You will be able to view the performance charts on the various metrics for your ActiveMQ server.

Customize your Plugin

To add/delete an attribute, or change its unit, edit the activemq.py file, make the desired changes, and increment the plugin version. From the next consecutive data collection, the changes would be reflected.

Plugin Contribution

Feel free to contribute to our existing plugin and come up with suggestions or feedback on our Community.

Other Plugin Integrations

Troubleshooting Tips