Mulesoft AnypointMQ Configuration
Effortlessly integrate your enterprise systems by configuring the Nodinite Pickup Logging Service to fetch JSON Log Events directly from your Mulesoft AnypointMQ queues. This guide walks you through secure, scalable, and reliable log event collection, ensuring your business-critical data is always available for analysis and compliance.
- ✅ Seamless integration with Mulesoft AnypointMQ
- ✅ Secure and reliable Log Event collection
- ✅ Scalable setup for enterprise environments
- ✅ Long-term storage and compliance-ready
The diagram above illustrates how the Pickup Service interacts with AnypointMQ queues, processes messages, and stores them in the Nodinite Log Database. Invalid messages are routed to the Dead Letter Queue for further review.
Configuring Access to an Anypoint MQ Queue
To configure this card to fetch messages from an Anypoint MQ queue, click the AnypointMQ tab in the Remote Configuration.
- Enable the configuration by checking the Enabled box.
- Provide a clear Display Name and Description to identify the purpose.
- Enter your Username and Password or enable Use Connected App for OAuth-based access.
- If using OAuth, fill in Client ID and Client Secret.
- Specify the Queue name you want to consume messages from.
- (Optional) Set a Dead Letter Queue to capture failed messages.
- Adjust the Active Consumers value to control the number of concurrent consumers.
- (Optional) Enable Protected, Is EU Panel, or Use Configuration DB based on your security and data location needs.
Once configured, the system will start polling the queue and logging events according to your settings.
Anypoint MQ Source Configuration Fields
Field Name | Example Value | Description |
---|---|---|
Enabled | ✅ (checked) | Activates or deactivates this MQ source configuration. |
Display Name | Order Queue Source |
Friendly name displayed for this configuration. |
Description | Handles incoming orders |
Describes the purpose of the MQ configuration. |
Protected | ✅ (checked) | If enabled, credential fields for OpenID (OAuth) are shown in the Log API for secure access. |
OAuth Client ID | The public identifier for your application, issued by the identity provider (IDP). | |
OAuth Client Secret | The confidential key used to authenticate your application with the IDP. | |
Requested Scopes | A space-separated list defining the level of access the client is requesting. | |
OAuth Token Endpoint URL | The URL where the client sends authentication requests to obtain an access token. | |
Use Configuration DB | ❌ (unchecked) | If enabled, writes logs directly to the database, skipping the Log API. |
Active Consumers | 3 |
Specifies how many consumers process messages in parallel from the AnypointMQ queue. Adjust this value to balance throughput and resource usage (1-10), default is 3. . Low value (e.g., 1-2): Use for low message volumes or when you want to minimize resource usage and avoid overwhelming downstream systems. High value (e.g., 5-10): Use for high message volumes or when you need faster processing and your infrastructure can handle parallel consumption. |
Username | mq_user |
Specifies the username used to authenticate with AnypointMQ. |
Password | •••••••• |
Provides the password for the specified AnypointMQ user account. |
Queue | order-processing-q |
Name of the primary queue to consume messages from. |
Dead Letter Queue | order-dlq |
Specifies the dead letter queue (DLQ) where the Pickup Service automatically moves failed or invalid messages for further review and troubleshooting |
Use Connected App | ✅ (checked) | Enables OAuth 2.0 client credentials for authentication. |
Use EU Panel | ✅ (checked) | Enables the EU control plane for AnypointMQ, ensuring that all data and operations comply with EU data residency requirements and are processed exclusively within EU-based infrastructure. |
Client ID | abc123-client-id |
Specifies the OAuth client ID for authenticating with AnypointMQ when the "Use Connected App" option is enabled. |
Client Secret | •••••••• |
Provides the confidential OAuth client secret required for secure authentication together with the client ID |
AnypointMQs (versions <7.1.x)
Note
This section applies to versions <7.1.x. Later versions include a Remote Configuration feature that allows configuration via the Nodinite web interface (Web Client).
The AnypointMQs section lets you manage all Mulesoft AnypointMQ sources for your log events.
You configure these sources in the Settings.json
file, which uses JSON format. The default path is:
C:\Program Files\Nodinite\Logging Agent - Pickup Service\Settings.json
{
...
"AnypointMQs": [
{
"Enabled": true,
"LogAPI": "http://localhost/Nodinite/Dev/LogAPI/",
"UseConfigurationDatabase": false,
"ConfigurationDatabaseConnectionString": null,
"ActiveConsumers": 1,
"Username": "nodinite-reader",
"Password":"1337",
"Environment": "prod",
"EnvironmentId" : "f7a16b7b-1337-4cb5-93ba-1e5289f707ec",
"OrganizationId": "75ec82b6-f930-4ea2-1337-7c56ee24c9d3",
"UseConnectedApp": true,
"IsEuPanel": false,
"ClientId": "9186414a9dc4dfc94c4ccf670d25e4e",
"ClientSecret": "replaceme",
"RegionId": "eu-west-1",
"Queue": "LogEvents",
"DeadLetterQueue": "LogEvents.dlq",
"ReplaceRules": [
{
"Name": "Fix Endpoint real customer id to {customerId}",
"ReplaceName": false,
"ReplaceUri": true,
"Pattern": "/([0-9]{4,})$",
"Group1Value": "{customerId}"
}]
}]
...
}
AnypointMQs is an array of AnypointMQ queue configurations. Each entry defines how the Log Agent connects to and processes messages from a specific AnypointMQ queue. This setup ensures your Nodinite JSON Log Events are reliably collected and managed.
Property | Description | Value Example | Comment |
---|---|---|---|
ActiveConsumers | Number of threads to run | 1 | Currently limited to 1 thread |
Username | The name of the user to log on with | nodinite-reader | |
Password | Password for user | 1337 | |
Environment | The name of the environment | Test | |
EnvironmentId | Identifier for environment | f7a16b7b-1337-4cb5-93ba-1e5289f707ec | Guid |
OrganizationId | Identifier for organization | 65ec82b6-f930-4ea2-1337-7c56ee24c9d3 | Guid |
RegionId | Name of region | eu-west-1 | According to your run-time |
UseConnectedApp | Flag to use Connected App | true or false |
True when ClientId and ClientSecret is set |
IsEuPanel | True when using EU control plane | true or false |
|
ClientId | ClientId when using Connected App option | 9186414a9dc4dfc94c4ccf670d25e4e | |
ClientSecret | ClientSecret when using Connected App option | replaceme | |
Queue | Name of the queue with JSON Log Events | Nodinite-LogEvents | |
DeadLetterQueue | Name of queue for invalid Log Events | Nodinite-LogEvents.DLQ | |
Enabled | See the Shared Configuration section for more info | ||
LogAPI | See the Shared Configuration section for more info | ||
UseConfigurationDatabase | See the Shared Configuration section for more info | ||
ConfigurationDatabaseConnectionString | See the Shared Configuration section for more info | ||
ReplaceRules | See the shared Replace Rules section for more info |
Important
You must restart the Nodinite Pickup Logging Service for configuration changes to take effect.