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 to your IBM MQ Queue Managers without having any of those persons have 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
- Perform Edit thresholds operation on queues
- Perform Purge operation on the selected queue
- Perform List Messages to view content currently on selected queue
Categories
The various monitoring capabilities for the IBM MQ Monitoring Agent are expressed as Resources and are grouped by Categories. The list of Categories is provided Monitoring Agent. The following named Categories are provided by the IBM MQ Monitoring Agent.
- Monitoring queues - Make sure your queues does not fill up and get alerts before aging messages becomes a business problem
- Monitoring channels
- Monitoring client connections
- Monitoring listeners
- Monitoring queue managers
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:
List of available Remote Actions.
List Messages
You can list all messages on IBM MQ Queues (valid for all types of queues).
Click the List Messages menu item to open a modal with a paged list of messages on the selected queue
Example of List Messages Modal:
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
Note
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 the current configuration for the selected queue.
Download message
You can Download messages individually by clicking on the Download menu item on a row.
Option to download message
Save all as .zip
You can Download all messages messages clicking on the Save all as .Zip button.
Option to download message
Info
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 not visible.
Remove
You can Remove messages individually by clicking on the Remove menu item on a row.
Option to remove message.
After you click you must either confirm or abort the remove operation.
The User needs to either confirm or abort the 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.
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 the 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 |
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.
Info
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