Mule Cloud Application Queues Test

A queue is a temporary storage area for a message. You can create queues, FIFO queues, and dead-letter queues in Anypoint Platform. You can also send and receive messages from a queue in Anypoint Studio. Closely monitoring these queues are very crucial to understand whether messages are traveling through the queues as expected. If the application is stuck processing a message then you can identify it by tracking the queue status and number of queued messages. To resolve the issue you may want to flush the messages from only that queue. Hence it is very important to keep an eye on the queues in the applications.

This test discovers all the queues in each application deployed on the target environment on Cloudhub and reports the status of the queue. This way, administrators are forewarned if the status of the queue is not normal. In addition, this test also notifies administrators on the number of queued and in-flight messages. This helps them to identify any message processing delays and clear the queue as and when necessary before the application performance is affected.

Target of the test : A Mule ESB Cloud

Agent deploying the test : A remote agent

Outputs of the test : One set of results for each environment:application:queue in the target Mule ESB Cloud being monitored.

First-Level Descriptor: Environment

Second-Level Descriptor: Application

Third-Level Descriptor: Queue

Configurable parameters for the test

Parameter	Description
Test period	How often should the test be executed
Host	The IP address of the host for which this test is to be configured.
Port	The port number at which the specified host listens.
Username and Password	By default, the eG agent uses the Cloudhub API version 2 (v2) to collect the metrics from the target Mule ESB Cloud or Cloudhub. To be able to connect to the Cloudhub API v2, the eG agent should be configured with the username and password of a user who is vested with the read only rights. Specify the user and password in the Username and password text boxes.
Confirm Password	Confirm the password by retyping it here.
Organization Name	To enable the eG agent to monitor a particular organization on Anypoint platform account, specify the name of that organization against this parameter. For instance, org. Doing so will enable the eG agent to monitor each of the components within the specified organization.
Exclude Environments	Here, you can provide a comma-separated list of environments that you do not want to monitor. For instance,Sandbox,Design,Production,.... By default this is set as none, indicating that this test will report metrics for all the environments on the target Anypoint platform.
Exclude Applications	Here, you can provide a comma-separated list of applications that you do not want to monitor. For instance,Helloworld,AppName,.... By default this is set as none, indicating that this test will report metrics for all the applications on the target Anypoint platform.
Session Timeout	Indicate the duration (in minutes) for which this test should wait for a response from the Anypoint Platform. By default, this is set to 60 minutes. This means that any user session that has remained inactive for more than 60 minutes will be automatically logged out from Anypoint platform. You can provide a duration between 15 minutes and 180 minutes in this text box.

Measurements made by the test

Measurement	Description	Measurement Unit	Interpretation
Is normal?	Indicates whether/not the status of this queue is normal.		The values reported by this measure and their numeric equivalents are available in the table below: Measure Value Numeric Value Yes 0 No 1 Note: This measure reports the Measure Values listed in the table above to indicate whether/not the queue status is normal. However, in the graph, this measure is indicated using the Numeric Values listed in the table above.
Queued messages	Indicates the number of messages currently waiting on this queues in this application.	Number	Queues must not become full. If they do, applications can no longer put messages on the queue that they specify. This can lead to severe processing delays.
InFlight messages	Indicates the number of messages being processed in the flow after this queue on this application.	Number	The in-flight messages are still on the queue until processing is complete, then they are deleted from the queue.