Qntrl Bridge Messages Module | Bridge Online Help | Qntrl Online Help

Messages

The Messages module in Bridge allows you to test or execute a specific task directly through the Bridge connection. 

Create and execute a Message

To execute a message in Bridge:
  1. In Qntrl, navigate to(Settings) >> Advanced >> Bridge, and click Messages.
  2. Click New Message.
  3. In the New Message window, enter the following details.
    • Name: Enter a unique name for the message, so that it can be reused by different bridges when required.
    • Bridge ID/Cluster ID: The dropdown lists all available bridges and load balancing clusters.
      • Bridge: Executes the message on a specific bridge.
      • Cluster: System automatically chooses an active bridge within the cluster. Learn more about Clusters.
    • Module: Select a module from the dropdown. Modules are listed service-wise, and the related tasks appear automatically. When a new bridge is created, the Core service and modules under it are associated by default.
      • Task Engine –  Executes API tasks in third-party or internal applications.
      • DB Engine – Performs SQL queries in databases within a private network.
      • SSH Engine – Executes commands on remote Linux/Unix systems.
      • PowerShell Engine– Executes commands on remote Windows systems.
      • AD Engine– Performs secure operations in Active Directory.
    • Type: Defines how the task runs:
      • Synchronous - Executes immediately and displays the response in real.
      • Asynchronous - Executes in the background without waiting for the response.
    • Task: If the selected module includes subtasks, choose the relevant task.
    • Request Data: Enter task instructions in JSON format.
      • Click Sample JSON at the bottom of the editor to load a predefined structure (meta data) for the selected module and task.
      • If needed, modify the resource_name and other key parameters manually.
                  Refer to the Bridge Modules section or details on supported parameters.
    • Response: Displays the output for Synchronous messages once execution completes.
  1. Once all the details are filled, click Execute to run the message. 

      


After execution, the response will be available in the Response tab.

 

View, Modify or Run Message properties        

After execution, all messages are listed under the Messages page for review and tracking.
You can view, modify, and execute the Messages sent to the bridge.
  1. Navigate to(Settings) >> Advanced >> Bridge, and click Messages.
  2. The message list appears with a message count next to the title, so you can see the total number of messages at a glance. Each row shows the message ID, Name, Service, Module, Status, Type, Created Time, Executed Time, Time Taken, and Error Message.
  3. Check the Status column to see the result of each run. A failed message shows Error, and the Error Message column shows the reason, so you can spot and diagnose failures without opening each one.
  4. To narrow the list, click the Filter button at the top left. You can filter on any column, including Status and Error Message.
      

  1. Click the message ID to open its properties.

  2. View or edit the fields, such as Bridge, Type, and Request Data.

  3. To run the message again, click Execute. The response from the most recent run appears in the Response Data tab.

Notes A message shows a value in the Error Message column only when its last run failed. A successful message leaves this column empty.

To view the full response (for synchronous message types) or verify the server call from your Bridge Agent:

  1. Navigate to (Settings) >> Advanced >> Bridge and select Bridge.
  2. Hover over the bridge name, click the action menu, and select Open Agent.
  3. This will direct you to the Bridge Agent login page. Log in with your Username and Password. Learn more about Bridge Agent.
  4. Navigate to the Messages section in the Header bar.
  5. Use the dropdown menu to view message logs and responses.

      


Message Retention Policy

Qntrl automatically manages message storage both in the cloud and on the Bridge Agent for debugging and auditing purposes.

Cloud Retention

  1. Up to 500,000 messages or 6 months of data (whichever comes first) are stored.
  2. Older messages beyond this limit are permanently deleted from Qntrl’s cloud database.

Bridge Agent Retention

In the Agent UI:
  1. Default visibility: 30 days or 50,000 messages
  2. Maximum visibility: 100,000 messages
In the Agent backend database:
  1. Default retention: 90 days or 250,000 messages
  2. Maximum retention: 500,000 messages
When limits exceed the threshold, older messages are permanently deleted from the Bridge database.

Modifying Bridge Agent Retention Limits

You can customize message retention limits on the Bridge Agent:
  1. Open the configuration file: conf/config.xml
  2. Update the message retention settings as required.
  3. Restart the Bridge Agent for the changes to take effect.
Notes
Restarting the Bridge Agent is mandatory after modifying retention settings.


Delete a Message        

  1. Navigate to(Settings) >> Advanced >> Bridge >> select Messages.

  2. Hover next to the ID of the message you want to delete, click the mouse over action menu, and select Delete.

  3. The configured bridge message will be deleted.