- 5 minutes to read

Managing IBM MQ Monitoring Agent

Manage monitoring thresholds and perform administrative remote actions on IBM MQ brokers, channels, listeners and queues.

Delegate control and let all those involved in the support and maintenance team have the power to manage problems related with your IBM MQ Queue Managers without having any of those persons having individual access to the Servers and tools like MQExplorer. Limiting the number of attack vectors and having fewer people with high access rights minimizes the risk of disruption of mission-critical services.

Application Management Team IT Operations Business
Let your AM team know deal with the problem if messages are stockpiling Stay in complete control with access to everything Give your business a heads up on failed and/or missing business transactions

Monitoring Features

You can manage:

  • Monitoring
  • Remote Configuration

See Monitoring IBM MQ user guide for additional details about IBM MQ Monitoring


Categories

The various monitoring capabilities for the IBM MQ Monitoring Agent are expressed as Resources and are grouped by Categories. The list of Categories are provided Monitoring Agent. The following named Categories are provided by the IBM MQ Monitoring Agent.

categories

The IBM MQ Monitoring Agent supports the execution of remote actions on resources using the Nodinite Web Client tool or by programmatically calling the Web API. To execute remote actions some Prerequisites must be satisfied.

The user must be logged on to Nodinite using a Windows Credential. The user must also be assigned a Monitor View with Resources from this agent where Remote Actions are allowed. See Add or manage Monitor View for more details.


Remote Configuration

The IBM MQ Monitoring Agent is configured using Remote Configuration further detailed in the Configuration user guide.

Remote Actions for Queues

The following remote Actions are available to users from Monitor Views with filtered IBM MQ Resources where remote actions are allowed:
RemoteActions
*List of available actions for

List Messages

You can list all messages on IBM MQ Queues (valid for all type of queues).
ListMessages
Click the List Messages menu item to open a modal with a paged list of messages on selected queue

Example of List Messages Modal:
ListMessagesModal
Paged List of messages example

Within this modal you can view many common properties for each message and you can also further perform the following Actions:

  • Reload - Updates the list of messages
  • Download - Download individual message
  • Remove Removes the selected message
  • Save all as .zip - Download all messages as .zip file

Use this operation with caution and only when there is a limited amount of large messages on the queue

Within the modal you can also expand the Evaluation thresholds accordion to view current configuration for the selected queue
EvaluationThresholds

Download message

You can Download messages individually by clicking on the Download menu item on a row.
Download Individual Message
Option to download message

Save all as .zip

You can Download all messages messages by clicking on the Save all as .Zip button.
SaveAllAsZipButton
Option to download message

If the queue has get inhibited then this button is not visible at all since messages cannot be downloaded anyway. Also, if the queue is empty then this button is also not visible

Remove

You can Remove messages individually by clicking on the Remove menu item on a row.
ActionRemoveMessage
Option to remove message

After you click you must either confirm or abort the remove operation.
RemoveMessageModal
User needs to either confirm or abort pending remove operation

The MessageId is presented as a base 64 encoded string

Purge Queue

You can remove all messages on a queue by clicking on the Purge menu item.
ActionPurgeQueue
Option to remove all messages on selected queue

Edit thresholds

You can override global thresholds by setting specific settings for each queue. Select the Edit thresholds.

You can manage thresholds for the maximum number of allowed messages and/or maximum allowed age for first message on the queue.

Timespan evaluation
Uses the age of the first message on the queue for evaluation.

State Name Data Type Description
Warning TimeSpan Timespan 00:05:00 (5 minutes) The age of first message on the queue to trigger Warning alert
Error TimeSpan Timespan 01:10:00 (1 hour 10 minutes) The age of first message on the queue to trigger Error alert

Fixed Number evaluation

State Name Data Type Description
Warning Count integer The number of messages to go above on the queue to trigger Warning alert
Error Count integer The number of messages to go above on the queue to trigger Error alert

Quota evaluation

State Name Data Type Description
Warning Count integer The number of messages to go above on the queue to trigger Warning alert
Error Count integer The number of messages to go above on the queue to trigger Error alert

Edit
Individual settings for the selected queue

Log Audits

All operations you and other Users perform are logged to the Nodinite Audit Log, ensuring you stay compliant with policies and applicable regulations.


Frequently asked questions

Additional solutions to common problems and the FAQ for the Nodinite IBM MQ Monitoring agent exist in the Troubleshooting user guide.

To manage your IBM MQ Queue managers using Nodinite you must enable Monitoring of one or more IBM MQ Queue Managers which is further described in the configuration page

Next Step

Remote Configuration of the agent

Prerequisites
Categories
Remote Actions
Monitoring Agents
Monitoring Agents