Skip to content

op-node: add follow source reorg observability - #22106

Open
jelias2 wants to merge 1 commit into
developfrom
jelias2/light-node-reorg-observability
Open

op-node: add follow source reorg observability#22106
jelias2 wants to merge 1 commit into
developfrom
jelias2/light-node-reorg-observability

Conversation

@jelias2

@jelias2 jelias2 commented Jul 29, 2026

Copy link
Copy Markdown
Contributor

Description

This pull request adds new metrics and logging to improve observability around reorg events in the op-node component. It introduces Prometheus counters to track "follow source" and "super authority" reorg events, and integrates these metrics into key reorg-handling code paths. Additional logging is also added to provide more context during reorgs.

Metrics instrumentation and logging improvements:

  • Added two new Prometheus counters in metrics.go: FollowSourceReorgs (tracks follow source reorg decisions by action) and SuperAuthorityReorgSignals (tracks super authority reorg signals by reason). Corresponding methods were added to the Metricer interface and implemented in both the real and noop metricers. (op-node/metrics/metrics.go
  • In engine_controller.go, integrated RecordSuperAuthorityReorgSignal calls at points where the super authority safe head is unknown or non-canonical, to record the reason for these reorg signals. (op-node/rollup/engine/engine_controller.go)
  • In the FollowSource method, added detailed warning and info logs to capture the state of local and external heads during reorgs, and instrumented the code to record follow source reorg actions (force_reset for sequencer resets and soft_update for verifier updates) using the new metric.
    These changes make it easier to monitor and diagnose reorg-related events in the system by providing structured metrics and richer logs.

Tests

Additional context

Metadata

@jelias2
jelias2 requested a review from a team as a code owner July 29, 2026 16:20
@jelias2
jelias2 force-pushed the jelias2/light-node-reorg-observability branch from 668baf3 to ab5643d Compare July 29, 2026 21:55
@jelias2 jelias2 changed the title feat: enhanced lightnode reorg observability op-node: add follow source reorg observability Jul 30, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant