MSMQ Configuration Example
Effortlessly integrate your enterprise systems by configuring the Nodinite Pickup Logging Service to fetch JSON Log Events directly from your MSMQ queues. This guide walks you through secure, scalable, and reliable log event collection using Microsoft Message Queuing.
✅ Seamless integration with MSMQ for real-time log event collection
✅ Secure and compliant long-term storage of log data
✅ Scalable configuration for enterprise environments
✅ Automated handling of invalid messages with backout queue support
The diagram above illustrates how the Pickup Service interacts with MSMQ queues, processes messages, and stores them in the Nodinite Log Database. Invalid messages are routed to the Backout queue for further review.
MSMQs
The MSMQs section lets you manage all MSMQ queue 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
{
...
"MSMQs": [
{
"Enabled": true,
"LogApi": "https://localhost/Nodinite/Dev/LogAPI/",
"UseConfigurationDatabase": false,
"ConfigurationDatabaseConnectionString": null,
"ActiveConsumers": 4,
"Server": "localhost",
"Queue": "Nodinite.LogAgent.PickupService.Test",
"DeadLetterQueue": "Nodinite.LogAgent.PickupService.Test.DLQ",
"ReplaceRules": [
{
"Name": "Fix Endpoint real customer id to {customerId}",
"ReplaceName": false,
"ReplaceUri": true,
"Pattern": "/([0-9]{4,})$",
"Group1Value": "{customerId}"
}
]
}
]
...
}
MSMQs is an array of MSMQ queue configurations. Each entry defines how the Log Agent connects to and processes messages from a specific MSMQ queue. This setup ensures your Nodinite JSON Log Events are reliably collected and managed.
Property | Description | Value Example | Comment |
---|---|---|---|
ActiveConsumers | Number of consumers the agent uses to collect messages | 1-n | A positive integer between 1 and 4 is recommended |
Server | Name of the Windows server with MSMQ | ||
Queue | Name of the MSMQ Queue to pick up JSON Log Event from | NOTE: Only the queue name | |
DeadLetterQueue | Name of the Dead Letter Queue for invalid or failed events | ||
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.