feat: add node info, sync, reorg and finalization metrics #16
+20
−0
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Contributor
|
Maybe we'd like to know the attestation target too? To see what each validator tries to justify |
kamilsa
reviewed
Dec 24, 2025
|
|
||
| | Name | Type | Usage | Sample collection event | Labels | Lantern | Qlean | Ream | Zeam | | ||
| |--------|-------|-------|-------------------------|--------|----------|----------|----------|----------| | ||
| | `lean_node_sync_status` | Gauge | Current sync status (always 1) | On sync status change | status=not_started,syncing,synced,stalled | □ | □ | □ | □ | |
There was a problem hiding this comment.
Not clear what is the difference between synced, syncing, and stalled.
E.g. if we are on the top of the chain are we synced or syncing (waiting for a new block).
Also how do we define stalled?
If by sync we mean initial sync after the node is started, then it all makes more sense, but we need to write somewhere that this is initial sync
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
This PR adds new metrics to improve observability of node lifecycle, sync status, reorg and finalization events.
New Metrics
Node Info Metrics
lean_node_info(gauge) - node metadata including name and versionlean_node_start_time_seconds(Gauge) - node start timestampSync Status Metrics
lean_node_sync_status(gauge) - synchronization statusFork Choice Metrics
lean_fork_choice_reorgs_total(counter) - total number of fork choice reorgslean_fork_choice_reorg_depth(histogram) distribution of reorg depthsFinalization Metrics
lean_finalizations_total(counter) - total finalization attempts by result