Skip to content

OM2: Discontinue OM Proto; specify PrometheusProto#2836

Open
bwplotka wants to merge 2 commits intomainfrom
bwplotka/om-proto
Open

OM2: Discontinue OM Proto; specify PrometheusProto#2836
bwplotka wants to merge 2 commits intomainfrom
bwplotka/om-proto

Conversation

@bwplotka
Copy link
Member

@bwplotka bwplotka commented Feb 10, 2026

Fixes prometheus/OpenMetrics#296

This proposes:

  • Discontinuation of OpenMetrics proto in OM2
  • Official maintenance (as it's true now) of previously deprecated Prometheus Proto

Proposed this to be a discussion on DevSummit https://docs.google.com/document/d/1uurQCi5iVufhYHGlBZ8mJMK_freDFKPG0iYBQqJ9fvA/edit?tab=t.0#bookmark=id.8x3p3zrx8mfu

@bwplotka bwplotka force-pushed the bwplotka/om-proto branch 3 times, most recently from 63d83ad to 94f1cc9 Compare February 10, 2026 10:35
@jan--f jan--f added the kind/enhancement Improvements to existing documentation label Feb 10, 2026
Copy link
Member

@krajorama krajorama left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM, let's see dev summit response

Co-authored-by: George Krajcsovits <krajorama@users.noreply.github.com>
Signed-off-by: Bartlomiej Plotka <bwplotka@gmail.com>
Comment on lines +404 to +406
> IMPORTANT: Previous versions of [OpenMetrics](https://prometheus.io/docs/specs/om/open_metrics_spec/#protobuf-format) used
> to specify a separate, similar, [protobuf format](https://github.com/prometheus/OpenMetrics/blob/3bb328ab04d26b25ac548d851619f90d15090e5d/proto/openmetrics_data_model.proto). Given similarities and wide adoption of [`PrometheusProto`](https://prometheus.io/docs/instrumenting/exposition_formats/#protobuf-format), OpenMetrics Proto is now deprecated and OpenMetrics spec is focusing
> on the human-readable text representation.
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
> IMPORTANT: Previous versions of [OpenMetrics](https://prometheus.io/docs/specs/om/open_metrics_spec/#protobuf-format) used
> to specify a separate, similar, [protobuf format](https://github.com/prometheus/OpenMetrics/blob/3bb328ab04d26b25ac548d851619f90d15090e5d/proto/openmetrics_data_model.proto). Given similarities and wide adoption of [`PrometheusProto`](https://prometheus.io/docs/instrumenting/exposition_formats/#protobuf-format), OpenMetrics Proto is now deprecated and OpenMetrics spec is focusing
> on the human-readable text representation.
> IMPORTANT: Previous versions of [OpenMetrics](https://prometheus.io/docs/specs/om/open_metrics_spec/#protobuf-format) used
> to specify a separate, similar, [protobuf format](https://github.com/prometheus/OpenMetrics/blob/3bb328ab04d26b25ac548d851619f90d15090e5d/proto/openmetrics_data_model.proto). OpenMetrics 2.0 does not include the protobuf representation. For available formats see [this](https://prometheus.io/docs/instrumenting/exposition_formats).


### Protobuf Representation

The [Prometheus protobuf wire format](https://prometheus.io/docs/instrumenting/exposition_formats/#protobuf-format) MAY be supported
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

WG discussion:

  • Mention only that it does not include OM proto anymore.
  • Deprecation might mean we should update 1.0. We just don't continue OM proto in 1.0. Actually deprecation should be in 1.0 (outside of the scope).
  • David: We don't need to say other protocols.
  • Idea: Mention negotiation and alternatives being possible and the intention of exposers to support both OM text and protobuf. Although it does not look this belongs. Maybe without normative language

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Consensus: Just context and link to exposition format, mention the desired (if acceptable) dual expose format imple etc

@bwplotka bwplotka changed the title OM2: Deprecate OM Proto; remove deprecation mention of PrometheusProto OM2: Discontinue OM Proto; specify PrometheusProto Feb 19, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

kind/enhancement Improvements to existing documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

OM 2.0: OM protobuf future

3 participants

Comments