- 5 minutes to read

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
graph TD subgraph "Mulesoft AnypointMQ" roS(fal:fa-list Queue) roBO(fal:fa-trash-can Dead letter queue) end subgraph "Nodinite instance" roPS(fal:fa-truck-pickup Pickup Service) roPS -.->|Bad/invalid messages| roBO roS --> roPS roPS --> |Long term storage|roDB(fal:fa-database Log Database) end

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.

  1. Enable the configuration by checking the Enabled box.
  2. Provide a clear Display Name and Description to identify the purpose.
  3. Enter your Username and Password or enable Use Connected App for OAuth-based access.
    • If using OAuth, fill in Client ID and Client Secret.
  4. Specify the Queue name you want to consume messages from.
  5. (Optional) Set a Dead Letter Queue to capture failed messages.
  6. Adjust the Active Consumers value to control the number of concurrent consumers.
  7. (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.


Next Step

Configure