Install and configure the Mule monitoring extension to monitor the light weight, Java based integration platform. Take informed troubleshooting decisions by keeping track of critical metrics including execution and fatal errors, synchronus, asynchronus, processed events and lot more.
This document details how to configure the Mule ESB plugin and the monitoring metrics for providing in-depth visibility into the performance, availability, and usage stats of Mule ESB instances.
Mule performance monitoring metrics:
Use our wide array of metrics and get notified of hazardous errors that require your attention. Keep track of unexpected trends through our metric graphs and troubleshoot as quickly as possible. Various out-of-the-box metrics we support are:
Memory usage
The metric memory_usage shows the amount of memory being used by the JVM where a particular instance of Mule ESB is running.
Average processing time
avg_processing_time is the time taken to process any event in your mule application.
Processed events
Mule collects events information for the flows and message processors to handle the business transactions. processed_events helps to analyze the incoming traffic to your application.
Synchronous and asynchronous events
Mule implements message processing for a given flow, either on the same thread (synchronously) or on a different thread (asynchronously). The number of messages processed synchronous and asynchronous are given by sync_events_received and async_events_received respectively.
Execution errors
When a message being processed through a Mule flow throws an exception, normal flow execution stops. Such errors (execution_errors) may cause failure of user requests.
Fatal errors
The metric fatal_errors is critical, which gives the number of erroneous/failed requests over a period of time. This helps the user to know whether their application is running smoothly.
Minimum and maximum processing time
Metrics min_processing_time and max_processing_time is the minimum and maximum time taken by the Mule server to process a Mule event in your application.
How it works?
- Log-in to your Site24x7 account. Sign up here if you don't have one.
- Download and install the latest version of Site24x7 Linux agent
- Install the Mule plugin
- The agent will execute the Mule plugin extension and push the data to the Site24x7 server
Prerequisites:
- Configure JMX in Mule ESB instance
Mule plugin installation:
- Create a directory with the name "mule", under Site24x7 Linux agent plugin directory - /opt/site24x7/monagent/plugins/
sudo mkdir mule
- Download the "mule.sh" and "MulePlugin.java" from our GitHub repository and place it under the "mule" directory
sudo wget https://raw.githubusercontent.com/site24x7/plugins/master/mule/mule.shsudo wget https://raw.githubusercontent.com/site24x7/plugins/master/mule/MulePlugin.java
- Provide JMX host, port credentials and application name in MulePlugin.java file
- The server agent will report stats on the performance of Mule server under the Plugins tab in the Site24x7 web client. In case the plugin is not listed in the Site24x7 web client, restart the agent.
sudo /etc/init.d/site24x7monagent restart
Monitoring additional metrics:
- To monitor additional metrics, edit the "mule.sh" file and add the new metrics that need monitoring
- Increment the plugin version value in the file "mule.sh" to view the newly added metrics (For e.g., change the default plugin version from PLUGIN_VERSION = "1" to "PLUGIN_VERSION = "2")
Related plugins:
- ActiveMQ plugin - Monitor performance metrics of your Apache ActiveMQ instances
- 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