You can perform various additional actions from the Bridge page to manage, monitor, and troubleshoot your Bridge setup.

To access the Bridge page:

1. In Qntrl, click the settings gear icon in the left pane bottom.

2. Navigate to Advanced >> Bridge and click Bridge.

3. In the bridge list page, click the name of the bridge you want to view.

The selected bridge details will be displayed, with three main sections:

• Properties

• Metrics

• Messages 

Properties      

On this page, you can view and make changes to the listed properties of the bridge.

To view or modify a bridge’s properties:

1. Click the Properties tab.

2. Make the required changes to the listed properties.

3. Click Save to apply the updates.

Bridge Properties Include:  

Modules   

To associate modules:

1. Select Modules and then click Associate Modules on the right.

2. From the displayed list of services, select a service to view its modules.

3. Select the modules you wish to associate with the bridge.

4. Click Save.

Update History  

View and manage bridge version updates.

• Click Update History.

• If a new version is available, the Update button becomes active.

• Clicking Update opens a pop-up with instructions.

• For older Bridge versions (before v2.18), you must manually execute a .sh update file as per the instructions in the pop-up.

• For newer versions, the process can be completed directly from the UI.

Logs   

You can retrieve and download log files directly from the Bridge interface for quick diagnostics.

To retrieve logs:

1. Click Get Recent Logs.

2. In the Log Preference window, select the type of logs to retrieve:

• Bridge Logs – Retrieves only Bridge-related logs.

• Service Logs – Retrieves logs specific to individual services. A dropdown appears to select the required service. Retrieves logs specific to individual services. Click the dropdown and select the required service.

• Unified Logs – Retrieves both Bridge and the selected Service logs together. Click the dropdown and select the required service.

3. Click Execute to retrieve the selected logs.

The retrieved logs appear in a list, where you can hover over any file name and click the Download icon to save it locally.

• A maximum of 10 log files are maintained at a time. When new files are fetched, the oldest ones are automatically deleted.
  

• You can now retrieve service-specific logs for focused troubleshooting.

Performance Settings

Define processing limits for Bridge Agent request and response threads.Users can set the count and maximum count of threads that can be executed by bridge in parallel, along with the queue size for various types of threads like Request, Response, Synchronous Request, Asynchronous Request, and SFTP Request. These settings help balance performance and resource utilization.

Metrics 

The Metrics section provides real-time and historical performance insights for the Bridge.

Bridge Health Metrics   

The performance of the bridge and any tasks that rely on it is largely influenced by the performance of the machine hosting the bridge. It’s crucial to regularly monitor the system's performance and take proactive steps if any issues arise. The following charts help with monitoring live system performance for the machine hosting the Bridge Agent.
Available metrics include:

CPU Usage Live Stats     

The live CPU usage report is displayed in two formats:

1. Bar Chart - Displays CPU usage percentage over time.

2. Pie Chart - Shows the distribution of RAM, disk, swap memory, and JVM usage.

Bridge Availability - Percentage

This report provides details on the active status of the bridge over a selected period. It includes filter options to customize the report by:  

1. Time range (from 24 hours to 1 year)

2. Percentage-based analysis

Metrics auto-refresh every 30 seconds. You can manually refresh the page for the latest graphs.

Performance Metrics (Early Access)   

Messages   

Click the Messages tab, to view the messages processed in the Bridge. This helps track data exchange between Qntrl and the connected services.

Manage Bridge Actions   

You can perform quick actions such as opening, restarting, or deleting a bridge directly from the Bridge list page.

1. Navigate to (settings) >> Advanced >> Bridge and select Bridge.

2. Hover over the name of the bridge you want to manage.

3. Click the More Actions (⋮) menu to view the available options:

• Open Agent: Launch the Bridge Agent login page directly from Qntrl. The Bridge Agent login page will open in your default browser.

• Restart: Restart the bridge agent with a single click — helpful for troubleshooting or applying configuration updates.

• Delete: Remove a bridge from the Bridge list when it’s no longer required.  

      

Before deleting: 

1. Active bridges cannot be deleted. Ensure the bridge is stopped.

2. Uninstall the Bridge agent and

3. Manually delete the Bridge installation folder from your on-premise machine after removal.

1. Stop Active Bridge (Prerequisite)      

For Windows:

You can stop the service using any of the following commands.

• sc stop qntrl_bridge

• net stop qntrl_bridge

• <bridge_home>/bin/bridge.bat stop

Alternatively, you can stop the service via the Windows Service Manager.

For Linux:  

To stop the Bridge on Linux, use any of the following commands:

• sudo service qntrl_bridge stop

• sudo systemctl stop qntrl_bridge

• sudo sh <bridge_home>/bin/bridge.sh stop

2. Deregister the Bridge Agent      

Once the Bridge is stopped, you need to deregister the Bridge agent. Execute the following command in the terminal to deregister the bridge agent.

To deregister the Bridge agent, execute either of the following commands in the terminal:

• sc delete qntrl_bridge

• <bridge_home>/bin/bridge.bat uninstall 

Alternatively, you can manually remove the service from the Windows Service Manager.

For Linux:  

To deregister the agent on Linux, use the following command:

• <bridge_home>/bin/bridge.sh uninstall

Using systemctl or service commands will remove the service, but residual system files will remain.

 3. Manually Delete the Installation Folder      

After stopping and deregistering the Bridge agent, manually delete the Bridge installation folder from the location where it was installed. This ensures no residual files remain.

Default Installation Locations:  

For Windows: C:\Program Files\Bridge

For Linux: /Bridge

Navigate to the respective directory on your system and delete the folder manually to complete the removal process.