Skip to content

LibraryData and agents2019Design paperCorpus record

Common Prometheus Metrics Names for Clients

EIP 2159. Adrian Sutton.

EIP 2159, Common Prometheus Metrics Names for Clients. Standardized names of common metrics for Ethereum clients to use with Prometheus, a widely used monitoring and alerting solution.

Status in the source: Final. A reading of the public specification, not a copy of it and not a certification.

Common Prometheus Metrics Names for Clients is worth reading for the rule it actually adds: Standardized names of common metrics for Ethereum clients to use with Prometheus, a widely used monitoring and alerting solution.

The five-minute read

The rule

Standardized names of common metrics for Ethereum clients to use with Prometheus, a widely used monitoring and alerting solution.

What was already failing

An interface that is only a name in a repository will be re-implemented differently by every team, which is how shared contracts break.

What the number does not mean

The source marks this final. That is a statement about the text, not a promise that every wallet or node has shipped it.

What a builder should be able to point at

An implementation either constrains JSON, RPC, ethereum_blockchain_height or it is a different design.

One action, walked through

  1. Open EIP 2159 and read the status line before the examples.
  2. Write down the rule in one sentence. A fair version of that sentence is: Standardized names of common metrics for Ethereum clients to use with Prometheus, a widely used monitoring and alerting solution.
  3. Name the object that changes: JSON, RPC, ethereum_blockchain_height.
  4. Ask what an old client, an old contract, or an offline counterparty does. If the document is silent, the silence is part of the design.

The argument, unpacked

What the text is allowed to settle

Ethereum Improvement Proposal 2159 can settle the shape of Common Prometheus Metrics Names for Clients. It cannot settle whether a later client, a later fork, or a later wallet still does this.

What this page will not pretend

There is no benchmark, no adoption number, and no claim that the mechanism is safe outside the assumptions written in the source.

What has to be true

  • You are implementing EIP 2159 at the status the text itself states: Final.
  • The object that has to change is JSON, RPC, ethereum_blockchain_height. A neighbouring document with a similar name is not this one.
  • Status in the header is not adoption.

What happened after the paper

The source marks this final. That is a statement about the text, not a promise that every wallet or node has shipped it. Later documents can narrow, replace, or ignore this one. Cite the number you mean.

What to check before you use the idea

  • What must an implementation of Common Prometheus Metrics Names for Clients accept, and what may it ignore?
  • Is this consensus, peer policy, or an application interface?
  • Which names does the text pin down: JSON, RPC, ethereum_blockchain_height?

Terms

EIP 2159
The public text titled Common Prometheus Metrics Names for Clients.
Final
The document's own label for how finished the text is. It is not a market fact.

The problem the paper names

An interface that is only a name in a repository will be re-implemented differently by every team, which is how shared contracts break.

What the design proposes

  • Standardized names of common metrics for Ethereum clients to use with Prometheus, a widely used monitoring and alerting solution.
  • Many Ethereum clients expose a range of metrics in a format compatible with Prometheus to allow operators to monitor the client's behaviour and performance and raise alerts if the chain isn't progressing or there are other indications of errors.
  • While the majority of these metrics are highly client-specific, reporting on internal implementation details of the client, some are applicable to all clients.

How the mechanism is specified

  • Taken from the specification, the next constraint is: Many Ethereum clients expose a range of metrics in a format compatible with Prometheus to allow operators to monitor the client's behaviour and performance and raise alerts if the chain isn't progressing or there are other indications of errors.
  • Locate JSON, RPC, ethereum_blockchain_height in EIP 2159 and apply it to one transaction or call.
  • Then check the failure the class of rule always has: a node that did not upgrade, a reverted call, a replayed signature, or a peer that does not speak the message.

What this page does not treat as proven

  • This document does not set a fee, a valuation, or a security proof.
  • Status in the header is not adoption.
  • The source marks this final. That is a statement about the text, not a promise that every wallet or node has shipped it.

Why a venture studio still reads it

Use EIP 2159 when a pitch says 'Common Prometheus Metrics Names for Clients' without saying whether the rule is consensus, policy, or an interface. The number is the citation. The pitch is not.

This is Blockchain Lab's reading of a public design paper. It is not the paper, not a copy of it, and not an offer of tokens, equity, custody or a partnership. Later network behaviour can diverge from the text. Nothing here is investment, legal or technical advice.

Research status: Design paper. Last reviewed: 1 October 2026. This is a reading of a public paper, not investment, legal or security advice.