OTEP: Federated SemConv and Schema v2 by lmolkova · Pull Request #4815 · open-telemetry/opentelemetry-specification

lmolkova · 2026-01-02T20:32:05Z

Proposes a new telemetry schema format so OTel Collector, instrumentation libs, and third parties can publish their own conventions with dependencies on OTel semconv.

What's new:

Schema URLs now return a manifest with metadata + link to resolved schema (single file with everything baked in)
Support for arbitrary registries that can depend on OTel conventions
Stable vs dev builds: 1.39.0 (stable only) vs 1.39.0-dev (everything)
New URL pattern: opentelemetry.io/schemas/{component}/{version} for per-repo schemas

Breaking:

Stop publishing schema file format 1.1.0 (the diff format)

jsuereth

Great draft!

Added my initial thoughts. Let me know if you need help writing any section.

linux-foundation-easycla · 2026-04-27T23:48:15Z

The committers listed above are authorized under a signed CLA.

✅ login: lmolkova / name: Liudmila Molkova (0910610, 0e82317, 4631056, 5788fcf, 5d51087, 6684e6d, 8e672e1, 9d41e1c, ab4927b, b7436b2, c054320, c5f205e, d3b972f, da10539, eb43a7c)
✅ login: lmolkova / name: liudmila molkova (01a0019, 03a47bf, 1281ddd, 27d4a1d, 2c6366c, 3181bb0, 6bc7c8e, 8137e9f, 95e4d5a, 9afa9e9, bab8479, c08cca8, d647f8e, f4d5af7)

lmolkova · 2026-04-28T01:54:05Z

will fix easy cla prior to merge (want to preserve commit hashes mentioned in discussions)

carlosalberto · 2026-05-15T18:43:26Z

It has been weeks without further comments or feedback, and we have the four required approvals we need for OTEPs. We can iron out details when incorporating these changes into the Specification. Merging.

atoulme

LGTM - looking forward to adopting in the collector

)

### Metrics - Add in-development `Bind` API to synchronous instruments. ([open-telemetry#5050](open-telemetry#5050)) - Clarify that View-provided metric stream `name` is not subject to instrument name syntax validation. ([open-telemetry#5094](open-telemetry#5094)) ### Common - Define the Core packages term. ([open-telemetry#5046](open-telemetry#5046)) - Rework contributing guide to reflect current process. ([open-telemetry#5072](open-telemetry#5072)) ### Compatibility - Stabilize sections of Prometheus and OpenMetrics Compatibility. - Stabilize translation of labels prefixed with `otel_scope_` to OTLP Instrumentation Scope. ([open-telemetry#5004](open-telemetry#5004)) - Stabilize OpenTelemetry Gauge and Sum to Prometheus transformations. ([open-telemetry#5034](open-telemetry#5034)) - Stabilize OpenTelemetry Instrumentation Scope to Prometheus labels transformation. ([open-telemetry#5052](open-telemetry#5052)) - Stabilize sections of Prometheus Metrics Exporter. - Stabilize temporality. ([open-telemetry#5024](open-telemetry#5024)) - Stabilize version and format. ([open-telemetry#5083](open-telemetry#5083)) - Stabilize port configuration. ([open-telemetry#5026](open-telemetry#5026)) - Stabilize `scope_info_enabled` configuration. ([open-telemetry#5056](open-telemetry#5056)) - Change Prometheus Metric Exporter config property recommended names (`without_scope_info` -> `scope_info_enabled`, `without_target_info` -> `target_info_enabled`, `with_resource_constant_labels` -> `resource_constant_labels`) ([open-telemetry#5071](open-telemetry#5071)) - Clarify that OTel SDKs should not use unofficial Prometheus clients. ([open-telemetry#5082](open-telemetry#5082)) ### OTEPs - Add OTEP for Semantic Convention Schema v2 with support for multiple convention registries and resolved schema format ([open-telemetry#4815](open-telemetry#4815)) --------- Co-authored-by: Armin Ruech <7052238+arminru@users.noreply.github.com>

)

### Metrics - Add in-development `Bind` API to synchronous instruments. ([open-telemetry#5050](open-telemetry#5050)) - Clarify that View-provided metric stream `name` is not subject to instrument name syntax validation. ([open-telemetry#5094](open-telemetry#5094)) ### Common - Define the Core packages term. ([open-telemetry#5046](open-telemetry#5046)) - Rework contributing guide to reflect current process. ([open-telemetry#5072](open-telemetry#5072)) ### Compatibility - Stabilize sections of Prometheus and OpenMetrics Compatibility. - Stabilize translation of labels prefixed with `otel_scope_` to OTLP Instrumentation Scope. ([open-telemetry#5004](open-telemetry#5004)) - Stabilize OpenTelemetry Gauge and Sum to Prometheus transformations. ([open-telemetry#5034](open-telemetry#5034)) - Stabilize OpenTelemetry Instrumentation Scope to Prometheus labels transformation. ([open-telemetry#5052](open-telemetry#5052)) - Stabilize sections of Prometheus Metrics Exporter. - Stabilize temporality. ([open-telemetry#5024](open-telemetry#5024)) - Stabilize version and format. ([open-telemetry#5083](open-telemetry#5083)) - Stabilize port configuration. ([open-telemetry#5026](open-telemetry#5026)) - Stabilize `scope_info_enabled` configuration. ([open-telemetry#5056](open-telemetry#5056)) - Change Prometheus Metric Exporter config property recommended names (`without_scope_info` -> `scope_info_enabled`, `without_target_info` -> `target_info_enabled`, `with_resource_constant_labels` -> `resource_constant_labels`) ([open-telemetry#5071](open-telemetry#5071)) - Clarify that OTel SDKs should not use unofficial Prometheus clients. ([open-telemetry#5082](open-telemetry#5082)) ### OTEPs - Add OTEP for Semantic Convention Schema v2 with support for multiple convention registries and resolved schema format ([open-telemetry#4815](open-telemetry#4815)) --------- Co-authored-by: Armin Ruech <7052238+arminru@users.noreply.github.com>

lmolkova added 2 commits January 2, 2026 12:18

SemConv schema v2: initial draft

01a0019

up

9afa9e9

lmolkova mentioned this pull request Jan 2, 2026

OTEP: Stable by Default #4813

Closed

3 tasks

jsuereth reviewed Jan 3, 2026

View reviewed changes

update based on resolved/forge discussion, remove tar.gz

2c6366c

benkawecki reviewed Jan 5, 2026

View reviewed changes

Comment thread oteps/4815-semantic-conventions-schema-v2.md Outdated

lmolkova changed the title ~~SemConv schema v2: initial draft~~ [WIP] SemConv schema v2 Jan 6, 2026

lmolkova commented Jan 6, 2026

View reviewed changes

Comment thread oteps/4815-semantic-conventions-schema-v2.md Outdated

lmolkova commented Jan 6, 2026

View reviewed changes

Comment thread oteps/4815-semantic-conventions-schema-v2.md Outdated

lmolkova commented Jan 6, 2026

View reviewed changes

Comment thread oteps/4815-semantic-conventions-schema-v2.md

atoulme mentioned this pull request Jan 7, 2026

[Proposal] Adopt weaver for all scraping receivers open-telemetry/opentelemetry-collector-contrib#40724

Open

atoulme reviewed Jan 7, 2026

View reviewed changes

Comment thread oteps/4815-semantic-conventions-schema-v2.md Outdated

lmolkova added 5 commits January 11, 2026 16:18

review

3181bb0

add list versions and latest version as future possibilities

d647f8e

not a goal to decide where individual conventions should live

95e4d5a

multi-registry-start

c5f205e

incorporate Laurent's changes on multi-registry

4631056

lmolkova mentioned this pull request Jan 26, 2026

SemConv guidance: document how to define spans open-telemetry/semantic-conventions#1853

Closed

jsuereth mentioned this pull request Jan 26, 2026

Allow resolving from resolved schema using Manifest file. open-telemetry/weaver#1160

Merged

jsuereth reviewed Jan 27, 2026

View reviewed changes

Comment thread oteps/4815-semantic-conventions-schema-v2.md Outdated

jsuereth reviewed Jan 27, 2026

View reviewed changes

Comment thread oteps/4815-semantic-conventions-schema-v2.md

listing versions, publish diff if necessary, scheme url changes

6bc7c8e

jsuereth reviewed Jan 30, 2026

View reviewed changes

Comment thread oteps/4815-semantic-conventions-schema-v2.md Outdated

lmolkova mentioned this pull request Feb 8, 2026

Semantic Conventions 2026 Roadmap open-telemetry/semantic-conventions#3330

Open

lmolkova added 2 commits February 9, 2026 17:29

add more context about conflict resolution, other minor cleanup

d3b972f

link to transform processor PoC

27d4a1d

lmolkova changed the title ~~[WIP] SemConv schema v2~~ SemConv Schema v2 Feb 10, 2026

lmolkova added 3 commits February 9, 2026 19:44

Merge branch 'main' into semconv-schema-v2

03a47bf

lint

c08cca8

lint

f4d5af7

lmolkova added 6 commits April 27, 2026 16:49

Merge branch 'main' into semconv-schema-v2

5788fcf

address another batch

da10539

move -dev from version suffix to family suffix

b7436b2

move sections around, no change

9d41e1c

fix lint

5d51087

nits

0910610

This was referenced Apr 30, 2026

processor/schema: work needed to promote to alpha stability open-telemetry/opentelemetry-collector-contrib#47428

Closed

processor/schema: add support for Schema v2 resolved registry format open-telemetry/opentelemetry-collector-contrib#48189

Closed

lmolkova added 2 commits May 8, 2026 14:00

Merge branch 'main' into semconv-schema-v2

8137e9f

add prerelease prefix on schema url

1281ddd

lmolkova mentioned this pull request May 9, 2026

Rename resolved_schema_uri to resolved_registry_uri open-telemetry/weaver#1425

Merged

florianl approved these changes May 12, 2026

View reviewed changes

MikeGoldsmith approved these changes May 13, 2026

View reviewed changes

MikeGoldsmith mentioned this pull request May 14, 2026

processor/schema: tracking issue for beta promotion open-telemetry/opentelemetry-collector-contrib#48370

Open

12 tasks

atoulme approved these changes May 15, 2026

View reviewed changes

Merge branch 'main' into semconv-schema-v2

bab8479

lmolkova force-pushed the semconv-schema-v2 branch from 36285a9 to bab8479 Compare May 17, 2026 17:39

lmolkova added this pull request to the merge queue May 17, 2026

Merged via the queue into open-telemetry:main with commit 459daa7 May 17, 2026
8 of 9 checks passed

lmolkova deleted the semconv-schema-v2 branch May 17, 2026 17:42

arminru mentioned this pull request May 18, 2026

Release 1.57.0 #5096

Merged

pellared pushed a commit to pellared/opentelemetry-specification that referenced this pull request May 19, 2026

Fix broken anchor introduced in open-telemetry#4815 (open-telemetry#5105

6837311

)

hilmarf pushed a commit to apeirora/opentelemetry-specification that referenced this pull request Jun 1, 2026

Fix broken anchor introduced in open-telemetry#4815 (open-telemetry#5105

ab704ae

)

trask mentioned this pull request Jun 18, 2026

Establish recommendations for generating GenAI SemConv artifacts per language open-telemetry/semantic-conventions-genai#247

Open

Uh oh!

Conversation

lmolkova commented Jan 2, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

jsuereth left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

linux-foundation-easycla Bot commented Apr 27, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

lmolkova commented Apr 28, 2026

Uh oh!

carlosalberto commented May 15, 2026

Uh oh!

atoulme left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

11 participants

lmolkova commented Jan 2, 2026 •

edited

Loading

linux-foundation-easycla Bot commented Apr 27, 2026 •

edited

Loading