Bridge
The Bridge component establishes a secure connection between cloud-hosted platforms and customer-hosted data sources. To initiate connectivity, deploy the Bridge Client within the customer infrastructure. Whitelist the relevant IP addresses and ports of the target data sources. This configuration allows secure access without requiring changes to firewall rules.
Manage Bridge
Log into the application.
Navigate to Administration > Connectors.
Click Manage Bridge to open the Bridge interface.
The interface lists all configured bridges with key operational and configuration details, including:
Bridge ID: Unique identifier assigned to each bridge instance
Bridge Name: Descriptive name defined during setup
IP Address: Network address of the Bridge Client host
Port: Designated communication port used by the client
Status: Current state of the bridge (Running, Stopped, etc.)
Type: Defines the category of the bridge.
Registration Date: Date when the bridge was registered in the system
Created By: User account that created the bridge instance
Action: Provides control options for each bridge. It includes the following icons:
Restart Bridge: It allows the bridge client to re-establish connectivity without reinstalling.
Update Bridge: Updates the bridge client with the latest available software version.
Delete Bridge: Removes an unused bridge from the application. Available only to OE_ADMIN users for inactive, disconnected, or failed bridges. The system validates that the bridge is not in use before deletion. Active or running bridges cannot be deleted.
Version: Current version of the bridge software
Statistics: Provides a shortcut to view runtime performance, technical metrics, data flow, and server activity
Last Updated On: Timestamp of the most recent configuration or status update
Last Updated By: User who performed the last modification
Action Status: Outcome of the most recent operation.
Bridge Status
The Bridge Status feature provides real-time visibility into the operational health of a bridge. Bridge status is continuously monitored using heartbeat signals and system events, enabling administrators to quickly identify connectivity issues, maintenance activities, and recovery events.
Each bridge displays a Status and a Mode that together indicate the current operational state and how the state was triggered.
Bridge Modes
Bridge modes identify the source of a status change.
Auto (User)
Indicates that the operation was initiated by a user from the OvalEdge application, such as restarting or updating a bridge.
Auto (System)
Indicates that the operation or status transition was triggered automatically by the system, such as heartbeat monitoring or scheduled operations.
Manual
Indicates that the bridge state changed because of an external action outside the OvalEdge application, such as an operating system restart or manual intervention.
Bridge Statuses
The following statuses indicate the current operational state of a bridge.
Running
The bridge is operational and communicating successfully with the application.
Warning
Heartbeat communication is delayed, indicating a potential connectivity issue.
Stopped
The bridge is unavailable because heartbeat communication has stopped.
Restarting
A bridge restart operation is currently in progress. The application restarts the Bridge and waits for a healthy heartbeat.
Updating
A bridge update is in progress and the bridge will restart after the update completes.
Inactive
The bridge has been registered but is not yet validated or has not established communication with the application.
Heartbeat Monitoring
The application checks the health of every Bridge every 1 minute by validating the latest heartbeat received from the Bridge. The application automatically updates the bridge status based on the most recent heartbeat received.
Running
The application receives a heartbeat within the last 5 minutes.
Warning
The application does not receive a heartbeat for 5 to 10 minutes. This status indicates a potential connectivity issue or a temporary interruption.
Stopped
The application does not receive a heartbeat for more than 10 minutes. This status indicates that the Bridge is unavailable.
Recovery
The application changes the Bridge status back to Running after it receives a new heartbeat from a Bridge in the Warning or Stopped state.
The application applies the same heartbeat thresholds after a Bridge restart or update. If the application does not receive a healthy heartbeat within 10 minutes, it marks the operation as failed and changes the Bridge status to Stopped.
The application records every Bridge status change and health event to support operational monitoring and troubleshooting. Alert generation follows configured thresholds to reduce unnecessary notifications during temporary connectivity fluctuations.
Bridge Operations
During bridge maintenance operations, the application automatically updates the bridge status to reflect the current activity.
Restart operations display the Restarting status until the application receives a healthy heartbeat.
Update operations display the Updating status until the update completes successfully and the application receives a healthy heartbeat.
If the application does not receive a healthy heartbeat within 10 minutes after a restart or update operation, it changes the Bridge status to Stopped and records the operation as failed to assist with troubleshooting.
Bridge Failure Handling
The application detects failures that occur during Bridge operations, such as update, deployment, NAR download, and NAR deployment failures. The application updates the Bridge status with the appropriate failure state and displays relevant error information. This enables administrators to quickly identify failed operations, determine the stage at which the failure occurred, and take corrective action.
Steps
Click the Status icon to view the current state of each bridge.
A detailed status pop-up appears after clicking the Status icon. The pop-up includes the following parameters:
Bridge Health: Real-time condition of the bridge (e.g., Running, Stopped, Restarting, Warning)
Details: Contextual information (e.g., “Manually restarted”)
Mode: Configuration mode, either Auto or Manual
Last Health Check Timestamp: Date and time of the most recent health verification
Automated Notification
When the application does not receive a heartbeat for 5 to 10 minutes, it changes the Bridge status to Warning. When the application does not receive a heartbeat for more than 10 minutes, it changes the Bridge status to Stopped and automatically generates a health notification.
During Bridge downtime, the application captures the list of currently running Bridge jobs to help Integration Admins identify workloads that may have been affected. The application sends notifications to the configured recipients or notification channels to help Integration Admins monitor and manage Bridge operations.
Bridge Health Event Notifications
The application monitors Bridge resource utilization and generates health notifications when the defined monitoring conditions are met. The application sends notifications to the configured recipients or notification channels to help Integration Admins monitor Bridge health and respond to operational issues.
The application generates Bridge health event notifications for the following events.
Physical Memory Critical
Generated when the available physical memory falls below the configured threshold.
Non-Heap Memory Alert
Generated when non-heap memory usage exceeds the configured threshold.
Heap Memory Warning
Generated when heap memory usage exceeds the configured warning threshold.
Process CPU Alert
Generated when Bridge CPU utilization exceeds the configured threshold.
Bridge Statistics
Click the Statistics icon to access a detailed Statistics interface: Release Info.
Release Info Tab
The Release Info tab provides build, release, and component version details of the Bridge. The information helps validate the deployed bridge version and assists with auditing and troubleshooting activities.
This tab displays the following details:
Bridge ID: Unique identifier of the bridge instance.
Bridge Branch: Source code branch used for the build.
Commit: Short commit ID associated with the build.
Commit Full: Full commit hash for detailed traceability.
Tag: Release tag mapped to the build.
Release: Name of the release.
Release Number: Numeric identifier of the release.
Release Version: Version number of the bridge release.
Bridge Components: Displays version information for the Bridge components and associated libraries included in the release.
NiFi Version: Version of Apache NiFi used by the bridge.
Java Version: Java version used to run the bridge.
OS Name: Operating system on which the bridge is running.
Build Date: Date and time when the bridge build was created.
Copyright © 2026, OvalEdge LLC, Peachtree Corners GA USA
Last updated
Was this helpful?