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.
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 producer count
Total number of producers that have posted messages to the ActiveMQ instance is shown by
- 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
- 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-develyum install python-pip (or)easy_install pip
- For Debian, Ubuntu:
apt-get -y install python-pip
- 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.
- The default python path given in the plugin script is #!/usr/bin/python. If you wish to provide an alternate python path, replace the existing one preceded by the shebang character "#!".
- 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'
View Data in the Site24x7 Web Client
- Log in to Site24x7 and go to Server > Plugins > Name of Plugin Monitor.
- 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.
Feel free to contribute to our existing plugin and come up with suggestions or feedback on our Community.
Other Plugin Integrations
- Redis plugin - Monitor performance metrics of your Redis databases
- MongoDB plugin - Monitor performance metrics of your MongoDB databases
- Memcached plugin - Analyze performance of your Memcached server
- Nagios plugin - Execute thousands of Nagios plugins in Site24x7 without the need of running a Nagios server
- Out-of-the-box plugins - Monitor your entire app stack with our extensive list of integrations
- Create custom plugins - Create custom Linux and Windows plugins and monitor custom attributes