Skip to content

Add per-beacon-node response attribution to the REST multi-handler - #17323

Open
syjn99 wants to merge 1 commit into
developfrom
feat/bn-resp-attribution-metrics
Open

Add per-beacon-node response attribution to the REST multi-handler#17323
syjn99 wants to merge 1 commit into
developfrom
feat/bn-resp-attribution-metrics

Conversation

@syjn99

@syjn99 syjn99 commented Aug 7, 2026

Copy link
Copy Markdown
Member

What type of PR is this?

Feature

What does this PR do? Why is it needed?

Add validator_beacon_node_response_total{host,outcome} metrics (outcome = matched|fallback|error) that surfaces which BN that VC relies most. With #17075, REST VC is now able to subscribe N BNs, performing duties based on the best result on hand. This PR provides a chance for node operators to actually investigate under the hood. It's possible that one BN always wins in raceRound, while other always loses so contributes nothing on VC.

No endpoint label for this metric: endpoints embed the slot, so the cardinality would be unbounded.

Which issue(s) does this PR fix?

N/A

Other notes for review

Might be great if we add a sample Grafana dashboard in the documentation that @nalepae already wrote:

Acknowledgements

  • I have read CONTRIBUTING.md.
  • I have included a uniquely named changelog fragment file.
  • I have added a description with sufficient context for reviewers to understand this PR.
  • I have tested that my changes work as expected and I added a testing plan to the PR description (if applicable).

With multiple beacon nodes configured, nothing told the operator which
node was actually serving the useful responses:
validator_http_action_count has no host label, and the multi-handler
discarded which handler won a read.

Add validator_beacon_node_response_total{host,outcome} at the two choke
points that already pick a winner, raceRound and inOrderRound, recording
whether a node's response was matched, used as a best-effort fallback,
or errored within a read round. Host labels go through
api.RedactEndpoint: endpoints can carry basic-auth credentials, which
must not reach /metrics.

No endpoint label: endpoints embed the slot, so the cardinality would be
unbounded.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@syjn99 syjn99 added the tools Metrics, prysm.sh and all the other tooling label Aug 7, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

tools Metrics, prysm.sh and all the other tooling

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant