- 5 minutes to read

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.
Empty configuration

click the Add button to add an entry.

Configuring the connection

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.
Empty AnypointMQ configuration

  • Click the Accordion to expand the connection configuration

Basic Tab

  • 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.
Remove AnypointMQ configuration Button
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
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.
Enable AnypointMQ Monitoring
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 Broker
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
  • Queue exclusions filter

Queue Monitoring thresholds

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 '_'

^[_].*

Filter Example 1
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.
Filter icon
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.
Empty Specific Accordion

Next, expand the accordion.

Expanded Empty Specific Queue 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.

Basic Authentication

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.

Connected Apps Authentication


Next Step

Add or manage a Monitoring Agent Configuration
Install Message Queueing Monitoring Agent