Added Bridge Status Reporter Service

[Fletch153]

Bridge Status Reporter Service

Overview

Implements a service that polls External Adapter /status endpoints at configurable intervals and emits structured telemetry events via Beholder. Provides operational visibility into bridge health, configuration, and runtime state.

Implementation

Core Service (core/services/nodestatusreporter/bridgestatus/)

• bridge_status_reporter.go - Service implementation with polling loop, HTTP client, error handling

Protobuf Schema (events/)

Configuration Integration

• core/config/docs/core.toml - Added [BridgeStatusReporter] configuration section
• core/config/toml/types.go - Configuration struct and setters
• core/config/bridge_status_config.go - Configuration interface
• core/services/chainlink/config_bridge_status.go - Service configuration implementation

Features

Service Behavior

• Queries bridge registry on startup and at each polling interval
• Polls bridge URLs with configurable status path (default: /status)
• Continues operation when individual bridges fail
• Configurable filtering of bridges without jobs or with HTTP errors
• Graceful shutdown with context cancellation

Telemetry Data Structure

Emits BridgeStatusEvent containing:

• Bridge metadata: name, adapter name/version, uptime
• Runtime information: Node.js version, platform, architecture, hostname
• Endpoint definitions: names, aliases, supported transports
• Configuration parameters: name/value pairs, types, defaults
• Associated job information: external job IDs and names

Configuration

[BridgeStatusReporter]
Enabled = false                    # Default: false
StatusPath = "/status"            # Default: "/status"
PollingInterval = "5m"            # Default: "5m"
IgnoreInvalidBridges = true       # Default: true
IgnoreJoblessBridges = false      # Default: false

Usage

Node Operators

Configure service via TOML, ensure External Adapters implement status endpoints.

External Adapter Developers

Implement GET /status endpoint returning JSON with required fields, available in adapters using ea-framework-js v2.7.0+

Monitoring Systems

Consume BridgeStatusEvent messages via Beholder telemetry pipeline.

[github-actions]

👋 Fletch153, thanks for creating this pull request!

To help reviewers, please consider creating future PRs as drafts first. This allows you to self-review and make any final changes before notifying the team.

Once you're ready, you can mark it as "Ready for review" to request feedback. Thanks!

[github-actions]

Flakeguard Summary

Ran new or updated tests between develop and 89d3650 (feature/DF-21286/add_additional_telemetry).

View Flaky Detector Details | Compare Changes

Found Flaky Tests ❌

4 Results

Name	Pass Ratio	Panicked?	Timed Out?	Race?	Runs	Successes	Failures	Skips	Package	Package Panicked?	Avg Duration	Code Owners
TestConfig_Marshal/full	0%	false	false	false	3	0	3	0	github.com/smartcontractkit/chainlink/v2/core/services/chainlink	false	16.666666ms	Unknown
TestService_Close_AlreadyClosed	33.3333%	false	false	true	3	1	2	0	github.com/smartcontractkit/chainlink/v2/core/services/nodestatusreporter/bridgestatus	false	0s	Unknown
TestService_Start_AlreadyStarted	0%	false	false	true	3	0	3	0	github.com/smartcontractkit/chainlink/v2/core/services/nodestatusreporter/bridgestatus	false	0s	Unknown
TestService_Start_Enabled	33.3333%	false	false	true	3	1	2	0	github.com/smartcontractkit/chainlink/v2/core/services/nodestatusreporter/bridgestatus	false	0s	Unknown

Artifacts

For detailed logs of the failed tests, please refer to the artifact failed-test-results-with-logs.json.

[github-actions]

Flakeguard Summary

Ran new or updated tests between develop and 73be6f5 (feature/DF-21286/add_additional_telemetry).

View Flaky Detector Details | Compare Changes

Found Flaky Tests ❌

1 Results

Name	Pass Ratio	Panicked?	Timed Out?	Race?	Runs	Successes	Failures	Skips	Package	Package Panicked?	Avg Duration	Code Owners
TestConfig_Marshal/full	0%	false	false	false	3	0	3	0	github.com/smartcontractkit/chainlink/v2/core/services/chainlink	false	10ms	Unknown

Artifacts

For detailed logs of the failed tests, please refer to the artifact failed-test-results-with-logs.json.

[cl-sonarqube-production]

Quality Gate passed

Issues
0 New issues
0 Fixed issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube