Skip to content

[internal/core] migrate semconv from v1.12.0#46533

Merged
ChrsMark merged 23 commits intoopen-telemetry:mainfrom
paulojmdias:feat/45076
Mar 5, 2026
Merged

[internal/core] migrate semconv from v1.12.0#46533
ChrsMark merged 23 commits intoopen-telemetry:mainfrom
paulojmdias:feat/45076

Conversation

@paulojmdias
Copy link
Copy Markdown
Member

@paulojmdias paulojmdias commented Mar 1, 2026

Description

Add feature gates to migrate deprecated semconv v1.12.0 attributes to their v1.38.0 equivalents in pkg/translator/zipkin and internal/coreinternal/goldendataset, following the semconv feature gates RFC.

Both gates default to disabled, preserving the existing behavior. Users can opt in to the migration at their own pace.

Zipkin translator (pkg.translator.zipkin.*):

  • net.host.ip -> network.local.address
  • net.peer.ip -> network.peer.address

goldendataset (internal.coreinternal.goldendataset.*):

  • net.host.ip -> network.local.address
  • net.peer.ip -> network.peer.address
  • http.host -> server.address
  • http.server_name -> server.address

Migration path:

Enable <component>.EmitV1NetworkConventions to start emitting both old and new keys (dual-emit transition)
Once user pipelines and backends are updated, also enable <component>.DontEmitV0NetworkConventions to stop emitting the deprecated v1.12.0 keys.

Initially, this was split into 2 PRs, but the #46534 is also a dependency for this one, so I checked out the code for this PR and closed that one.

Link to tracking issue

Fixes #45076 #45041

Testing

Tested locally without any error.

Signed-off-by: Paulo Dias <paulodias.gm@gmail.com>
Signed-off-by: Paulo Dias <paulodias.gm@gmail.com>
Signed-off-by: Paulo Dias <paulodias.gm@gmail.com>
Signed-off-by: Paulo Dias <paulodias.gm@gmail.com>
@paulojmdias paulojmdias added the ready to merge Code review completed; ready to merge by maintainers label Mar 2, 2026
Copy link
Copy Markdown
Member

@ChrsMark ChrsMark left a comment

Choose a reason for hiding this comment

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

Given that it's a breaking change on the schema, did we considered doing it following the https://github.com/open-telemetry/opentelemetry-collector/blob/main/docs/rfcs/semconv-feature-gates.md?

@paulojmdias paulojmdias removed the ready to merge Code review completed; ready to merge by maintainers label Mar 2, 2026
@paulojmdias
Copy link
Copy Markdown
Member Author

Given that it's a breaking change on the schema, did we considered doing it following the https://github.com/open-telemetry/opentelemetry-collector/blob/main/docs/rfcs/semconv-feature-gates.md?

Not really, I was not aware of this RFC at all. I'll look into it.

Signed-off-by: Paulo Dias <paulodias.gm@gmail.com>
@paulojmdias
Copy link
Copy Markdown
Member Author

@ChrsMark Thank you, I added the changes behind feature gates in the following commit, PTAL.

@MovieStoreGuy @frzifus PTAL again, as I changed the behaviour to be behind a feature gate as the RFC asks to avoid being a breaking change.

If everything is ok, I'll create issues to move this feature gates to Alpha and Stable some versions later.

paulojmdias and others added 5 commits March 2, 2026 11:00
Signed-off-by: Paulo Dias <paulodias.gm@gmail.com>
Signed-off-by: Paulo Dias <paulodias.gm@gmail.com>
Signed-off-by: Paulo Dias <paulodias.gm@gmail.com>
…-contrib into feat/45076

Signed-off-by: Paulo Dias <paulodias.gm@gmail.com>
…lector-contrib into feat/45076

Signed-off-by: Paulo Dias <paulodias.gm@gmail.com>
Signed-off-by: Paulo Dias <paulodias.gm@gmail.com>
paulojmdias and others added 2 commits March 2, 2026 17:10
…-contrib into feat/45076

Signed-off-by: Paulo Dias <paulodias.gm@gmail.com>
@paulojmdias paulojmdias marked this pull request as draft March 2, 2026 21:46
paulojmdias and others added 5 commits March 2, 2026 22:09
Signed-off-by: Paulo Dias <paulodias.gm@gmail.com>
…lector-contrib into feat/45076

Signed-off-by: Paulo Dias <paulodias.gm@gmail.com>
Signed-off-by: Paulo Dias <paulodias.gm@gmail.com>
Signed-off-by: Paulo Dias <paulodias.gm@gmail.com>
@paulojmdias paulojmdias marked this pull request as ready for review March 2, 2026 23:03
@atoulme
Copy link
Copy Markdown
Contributor

atoulme commented Mar 5, 2026

@ChrsMark please take another look

@paulojmdias paulojmdias added the ready to merge Code review completed; ready to merge by maintainers label Mar 5, 2026
@ChrsMark ChrsMark merged commit 67adac4 into open-telemetry:main Mar 5, 2026
208 checks passed
@paulojmdias paulojmdias deleted the feat/45076 branch March 5, 2026 16:30
antonio-mazzini pushed a commit to antonio-mazzini/opentelemetry-collector-contrib that referenced this pull request Mar 5, 2026
<!--Ex. Fixing a bug - Describe the bug and how this fixes the issue.
Ex. Adding a feature - Explain what this achieves.-->
#### Description

Add feature gates to migrate deprecated semconv v1.12.0 attributes to
their v1.38.0 equivalents in pkg/translator/zipkin and
internal/coreinternal/goldendataset, following the [semconv feature
gates
RFC](https://github.com/open-telemetry/opentelemetry-collector/blob/main/docs/rfcs/semconv-feature-gates.md).

Both gates default to disabled, preserving the existing behavior. Users
can opt in to the migration at their own pace.

Zipkin translator (`pkg.translator.zipkin.*`):

  - `net.host.ip` -> `network.local.address`
  - `net.peer.ip` -> `network.peer.address`
 
goldendataset (`internal.coreinternal.goldendataset.*`):

  - `net.host.ip` -> `network.local.address`
  - `net.peer.ip` -> `network.peer.address`
  - `http.host` -> `server.address`
  - `http.server_name` -> `server.address`
  
Migration path:

Enable `<component>.EmitV1NetworkConventions` to start emitting both old
and new keys (dual-emit transition)
Once user pipelines and backends are updated, also enable
`<component>.DontEmitV0NetworkConventions` to stop emitting the
deprecated v1.12.0 keys.
  
Initially, this was split into 2 PRs, but the
open-telemetry#46534
is also a dependency for this one, so I checked out the code for this PR
and closed that one.

<!-- Issue number (e.g. open-telemetry#1234) or full URL to issue, if applicable. -->
#### Link to tracking issue
Fixes open-telemetry#45076 open-telemetry#45041

<!--Describe what testing was performed and which tests were added.-->
#### Testing

Tested locally without any error.

---------

Signed-off-by: Paulo Dias <paulodias.gm@gmail.com>
avleentwilio pushed a commit to avleentwilio/opentelemetry-collector-contrib that referenced this pull request Apr 1, 2026
<!--Ex. Fixing a bug - Describe the bug and how this fixes the issue.
Ex. Adding a feature - Explain what this achieves.-->
#### Description

Add feature gates to migrate deprecated semconv v1.12.0 attributes to
their v1.38.0 equivalents in pkg/translator/zipkin and
internal/coreinternal/goldendataset, following the [semconv feature
gates
RFC](https://github.com/open-telemetry/opentelemetry-collector/blob/main/docs/rfcs/semconv-feature-gates.md).

Both gates default to disabled, preserving the existing behavior. Users
can opt in to the migration at their own pace.

Zipkin translator (`pkg.translator.zipkin.*`):

  - `net.host.ip` -> `network.local.address`
  - `net.peer.ip` -> `network.peer.address`
 
goldendataset (`internal.coreinternal.goldendataset.*`):

  - `net.host.ip` -> `network.local.address`
  - `net.peer.ip` -> `network.peer.address`
  - `http.host` -> `server.address`
  - `http.server_name` -> `server.address`
  
Migration path:

Enable `<component>.EmitV1NetworkConventions` to start emitting both old
and new keys (dual-emit transition)
Once user pipelines and backends are updated, also enable
`<component>.DontEmitV0NetworkConventions` to stop emitting the
deprecated v1.12.0 keys.
  
Initially, this was split into 2 PRs, but the
open-telemetry#46534
is also a dependency for this one, so I checked out the code for this PR
and closed that one.

<!-- Issue number (e.g. open-telemetry#1234) or full URL to issue, if applicable. -->
#### Link to tracking issue
Fixes open-telemetry#45076 open-telemetry#45041

<!--Describe what testing was performed and which tests were added.-->
#### Testing

Tested locally without any error.

---------

Signed-off-by: Paulo Dias <paulodias.gm@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[internal/core] migrate semconv from v1.12.0

8 participants