Configuring AnypointMQ
Note
Before any monitoring and remote configuration can be performed, you must first install the Message Queueing Monitoring Agent and create a Monitoring Agent Configuration. First-time users start here.
From the AnypointMQ tab, you can manage any number of AnypointMQ brokers.; Each with its own set of properties.
To monitor and control one or more AnypointMQ brokers you must provide some basic connection details.
click the Add button to add an entry.
Configuring the connection
- Add AnypointMQ broker
- Remove AnypointMQ broker
- Enable AnypointMQ broker
- Disable AnypointMQ broker
- Manage Queue thresholds
- Global - Use if not overridden by a specific setting
- Specific - Overrides global configuration on named queue
- Apply exclusion filters
- Authentication
Remember to click on the Save button to persist changes. It may take some time (depending on the user-defined synchronization interval) for Nodinite to reflect on changes.
Add AnypointMQ broker
Click the Add button to add a new AnypointMQ broker to monitor, repeat as needed.
- Click the Accordion to expand the connection configuration
- Enable AnypointMQ monitoring - When checked, the AnypointMQ broker will be monitored
- Use EU Anypoint Platform panel - When checked, monitoring EU Anypoint Platform is Enabled New 6.0.3.0
- Configuration name - user-friendly name for this AnypointMQ connection. Also becomes the default Application name for all monitored Resources.
- Description - (optional) User friendly name for this AnypointMQ connection.
- OrganizationId - The Guid for the Organization
- Environment - The name of the Environment (i.e. Prod, Test, QA, ...)
- EnvironmentId - The Guid for the Environment
- RegionId - The name for the Region
Remove AnypointMQ broker
Click the Remove button to remove the configuration for monitoring the AnypointMQ broker with queue Resources to Monitor.
Here's an example of the 'Remove' button to remove AnypointMQ broker configuration from monitoring.
Instead of removing an AnypointMQ broker you can simply disable monitoring. This will keep your configuration.
Enable AnypointMQ broker
A disabled Monitoring Configuration is clearly marked with a ban sign. Only disabled brokers can be Enabled.
Disabled AnypointMQ broker has a ban sign to mark the actual broker being disabled.
Click the checkbox to re-enable monitoring of AnypointMQ broker related Resources.
AnypointMQ broker Monitoring is enabled when the checkbox is checked.
Disable AnypointMQ broker
You can stop monitoring the AnypointMQ broker without removing the configuration by disabling the selected configuration.
An enabled Monitoring Configuration does not have the ban sign. Only enabled AnypointMQ brokers can be Disabled.
Enabled AnypointMQ brokers does not have a ban sign.
Un-check the checkbox to disable monitoring of AnypointMQ broker related Resources.
Manage Queue thresholds
Queue settings are either global or overridden with specific settings.
Global Settings
Global settings are used for evaluations of the queues if not specific settings have been set.
- Queue thresholds:
- Number-based evaluation
- Warning Count
- Error Count
- Time-based evaluation
- Warning Time Span
- Error Time Span
- Number-based evaluation
- Queue exclusions filter
Number-based evaluation
If you select the Fixed option for Count Evaluation Type then monitoring is based on the number of messages in the queue.
| 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 |
Time-based evaluation
Time-based evaluation is always evaluated. If you do not want to perform evaluation based on time then simply provide long enough thresholds.
| 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 |
Queue exclusions filter
Resources can be excluded using a RegEx based filter. You can Add and Remove as many RegEx expressions as you like.
Example #1: Remove all queues that starts with the letter '_'
^[_].*
Example 1: Remove all queues starting with the letter '_'
You can also use the filter to remove everything that do not match your provided RegEx expression, like
^((?!ONLYLIKEMYNAME).)*$
Whenever you apply one or more filters the configuration accordion will reflect this by displaying a filter icon to help you know there is an exclusion filter being used.
Here's an example of filter icon whenever exclusions are configured.
Important
We have had many support incidents with reports of missing queues due to this functionality. If you miss out a queue in your Monitor Views then first make sure your filters are not the ones responsible for this. Remember; With great power comes great responsibility
Specific queue settings
You can provide specific thresholds for named queues.
Important
If the actual queue is removed or changes it name, you must reconfigure the specific configuration within Nodinite
From within the Specific queue settings section you can click the Add button to add a specific configuration.
Next, expand the accordion.
- Queue name - (mandatory) The exact name of the queue to configure
- Description - (optional) user-friendly short description for this configuration.
All other thresholds settings are already documented in the global section.
Specific configurations using Remote Actions are further detailed on the Managing AnypointMQ user guide.
Configure Authentication
There are two authentication options:
Basic Authentication
Use this option to pass user name and password.
- User name - The name of the 'User' account with proper access rights.
- Password - The password for the user.
Connected Apps
New 6.0.2.0 Use this option to pass client id and client secret.
- Use Connected Apps- When checked; Client credentials is used for Authentication and Authorization.
- Client Id - The client id of Anypoint Platform.
- Client Secret - The client secret of Anypoint Platform.
Next Step
Related
Add or manage a Monitoring Agent Configuration
Install Message Queueing Monitoring Agent