ActiveMQ Status Details Test

ActiveMQ is widely used in various industries and applications, including financial services, healthcare, e-commerce, and more, wherever reliable and scalable messaging is required to connect distributed components or microservices. Given widespread application and at times in mission critical systems, it is important for administrators to monitor the ActiveMQ server for status details.

This test monitors the ActiveMQ server and collects some of the key metrics like total number of connections, current connections, number of warnings etc. The trends of these metrics provide valuable insights to the administrators about the current and potential problems. Using these insights administrators can handle the problem before it causes performance dissipation.

Target of the test : An Active MQ Server

Agent deploying the test : An internal/remote agent.

Outputs of the test : One set of results for the ActiveMQ Server being monitored

Configurable parameters for the test
Parameter	Description
Test period	How often should the test be executed.
Host	The host for which the test is to be configured.
Port	The port at which the specified host listens. Default value is 8161.
Timeout	Specify the duration (in seconds) for which this test should wait for a response from the target ActiveMQ Server. If there is no response from the target beyond the configured duration, the test will timeout. By default, this is set to 240 seconds.
JMX Remote Port	Specify the port at which the JMX listens for requests from remote hosts. Ensure that you specify the same port that you configured in the management.properties file in the <JAVA_HOME>\jre\lib\management folder used by the ActiveMQ Server.
JNDI Name	Specify the lookup name for connecting to the JMX connector of the ActiveMQ Server. By default, this is jmxmi.
JMX User, JMX Password and Confirm Password	These parameters appear only if the Measurement Mode is set to jmx. If JMX requires authentication only (but no security), then ensure that the JMX User and JMX Password parameters are configured with the credentials of a user with read-write access to JMX.
JMX Registry SSL	If you have registered the JMX connector in an SSL-enabled RMI registry , set this flag to Yes. By default, this is set to No.
DD Frequency	Refers to the frequency with which detailed diagnosis measures are to be generated for this test. The default is 1:1. This indicates that, by default, detailed measures will be generated every time this test runs, and also every time the test detects a problem. You can modify this frequency, if you so desire. Also, if you intend to disable the detailed diagnosis capability for this test, you can do so by specifying none against DD frequency.
Detailed Diagnosis	To make diagnosis more efficient and accurate, the eG Enterprise embeds an optional detailed diagnostic capability. With this capability, the eG agents can be configured to run detailed, more elaborate tests as and when specific problems are detected. To enable the detailed diagnosis capability of this test for a particular server, choose the On option. To disable the capability, click on the Off option. The option to selectively enable/disable the detailed diagnosis capability will be available only if the following conditions are fulfilled: The eG manager license should allow the detailed diagnosis capability Both the normal and abnormal frequencies configured for the detailed diagnosis measures should not be 0.

Measurements made by the test
Measurement	Description	Measurement Unit	Interpretation
Number of warnings	Indicates the total number of warning messages on the ActiveMQ Server.	Number	While there maybe small number of warnings during operation, if the number of warnings exceeds threshold, it needs to be investigated. The detailed diagnosis of this measure reveal additional metrics Status and Description.
Total connections	Indicates the total number of connections established to the ActiveMQ server.	Number	Total allowable connections can be increased to an optimal value to improve the performance.
Number of current connections	Indicates the number of connections to ActiveMQ server which are currently active.	Number	If the number of current connections is gradually increasing close to the value of Total connections measure, it indicates that new connections may not to be established to the server.