Message Queue Service¶
Jitterbit Harmony Message Queue is a cloud-based, multi-tenant messaging queue service, where you can create and manage queues and messages through the Management Console Message Queues page and the Jitterbit MQ (Beta) connector.
A message is any data that is transferred between two systems or applications. When a message (sent through the Jitterbit MQ (Beta) connector) is received by an application (the Message Queue Service), the application can place it in a queue, which contains messages arranged in the order in which they need to be acted upon or processed.
The Message Queue service supports asynchronous processing, enabling you to manage your system workloads and resources with these components:
Message Queues management page
Use the Management Console Message Queues page to perform these actions:
Create, manage, and monitor message queues in the Message Queues tab.
Enable or disable messaging for Harmony environments and set the message queue automatic refresh interval in the Settings tab.
Jitterbit MQ (Beta) connector
Use the Jitterbit MQ (Beta) connector to perform these actions:
This diagram displays how a Jitterbit Message Queue message moves through the system architecture:
Data retrieved from a message can then be used as input to be consumed by a target endpoint, such as by using a Cloud Studio connector.
Once the data is consumed, the message can be either acknowledged (using the Acknowledge activity) or negatively acknowledged (using the NACK activity). If the message is not acknowledged or negatively acknowledged before the timeout of 30 minutes, the message will be available to be retrieved from the queue again by either a Get or Get Bulk activity.
If using a Private Agent that is behind a firewall within your network, you must allowlist the Message Queue Service.
The Message Queue service has usage limits to ensure optimal performance and fair usage. These are the usage limits depending on the purchased tier, either Basic or Premium:
|Number of environments enabled for the Message Queue service||2 environments||No limit|
|Number of queues per environment||2 queues per environment||50 queues per environment|
|Number of messages per queue||25 messages||10,000 messages|
|Message length||100 MB||500 MB|
|Messages per month (across all queue types)||50,000 messages||Limited by number of message packs purchased|
These usage limits are contractual. It is encouraged that you monitor your message usage and consider upgrades or additional pack purchases to align with usage patterns.
For information on tier pricing, contact your Customer Success Manager (CSM).
If the number of messages exceeds the user-defined message limit for an individual message queue, this runtime error will be returned:
"statuscode":500,"Error":"Error sending message."
To resolve, you may need to acknowledge messages in the queue, or you can adjust the message limit. The user-defined message limit is set on the Management Console Message Queues page in the Message Queues tab. Adjust the value in the Message Limit field, available under a queue's Advanced Options.