Skip to content

Deprecate OpenTracing compatibility requirements#4938

Merged
carlosalberto merged 7 commits intoopen-telemetry:mainfrom
adp2201:codex/deprecate-opentracing-spec-4849
Mar 19, 2026
Merged

Deprecate OpenTracing compatibility requirements#4938
carlosalberto merged 7 commits intoopen-telemetry:mainfrom
adp2201:codex/deprecate-opentracing-spec-4849

Conversation

@adp2201
Copy link
Copy Markdown
Contributor

@adp2201 adp2201 commented Mar 11, 2026

Summary

Deprecate OpenTracing compatibility requirements in the specification as Stage 1 of issue #4849.

This PR changes the OpenTracing compatibility spec document status to deprecated,
adds a deprecation note, and updates wording to make it explicit that new
OpenTracing compatibility implementations are no longer required by this
specification.

What changed

  • specification/compatibility/opentracing.md
    • Status changed from Stable to Deprecated
    • Added top-level deprecation note:
      • OpenTracing compatibility requirements are deprecated
      • existing shims MAY continue for backwards compatibility
      • new compatibility implementations are not required
      • removal criteria/timeline deferred to a separate discussion
    • Updated one normative paragraph to historical framing, aligned with deprecation
    • Added explicit sentence that this section remains for migration/backwards compatibility guidance
  • CHANGELOG.md
    • Added Unreleased/Compatibility entry for deprecating OpenTracing compatibility requirements

Context and precedent

Scope

This PR is intentionally narrow (Stage 1 only): deprecate requirements in spec text.

Non-goals

  • No immediate removal of OpenTracing compatibility content
  • No language-specific implementation mandates
  • No removal timeline policy in this PR (to be handled in follow-up discussion)

Validation

Local checks run:

  • make markdownlint ✅
  • make markdown-toc && git diff --exit-code ':*.md' ✅
  • make cspell ✅

Not run locally due environment limitation:

  • make markdown-link-check (requires Docker daemon)

Notes for reviewers

This is documentation/spec wording only and does not introduce API/SDK interfaces.

@adp2201 adp2201 requested review from a team as code owners March 11, 2026 22:18
@linux-foundation-easycla
Copy link
Copy Markdown

linux-foundation-easycla Bot commented Mar 11, 2026 •
edited
Loading

CLA Signed

The committers listed above are authorized under a signed CLA.

  • ✅ login: carlosalberto / name: Carlos Alberto Cortez (d2da5eb)

@adp2201 adp2201 force-pushed the codex/deprecate-opentracing-spec-4849 branch from 11f2a62 to 4326cf4 Compare March 11, 2026 22:25
@adp2201 adp2201 mentioned this pull request Mar 11, 2026
Merged
@adp2201
Copy link
Copy Markdown
Contributor Author

adp2201 commented Mar 11, 2026

Comms follow-up opened in parallel as a draft blog PR: open-telemetry/opentelemetry.io#9386 (tracking issue: open-telemetry/opentelemetry.io#9385). I will keep it aligned with any wording updates requested here.

carlosalberto
carlosalberto reviewed Mar 12, 2026
View reviewed changes
Comment thread specification/compatibility/opentracing.md Outdated
@adp2201 adp2201 mentioned this pull request Mar 13, 2026
Closed
Kielek
Kielek approved these changes Mar 17, 2026
View reviewed changes
Copy link
Copy Markdown
Member

@Kielek Kielek left a comment

Choose a reason for hiding this comment

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

Thanks!

@Kielek Kielek mentioned this pull request Mar 18, 2026
Merged
3 tasks
@adp2201
Copy link
Copy Markdown
Contributor Author

adp2201 commented Mar 18, 2026

PR is up to date with main and approvals are in. Could a spec maintainer please merge when convenient? @jsuereth @carlosalberto

@carlosalberto carlosalberto enabled auto-merge March 19, 2026 17:13
@carlosalberto carlosalberto added this pull request to the merge queue Mar 19, 2026
Merged via the queue into open-telemetry:main with commit f8a779a Mar 19, 2026
8 checks passed
@adp2201
Copy link
Copy Markdown
Contributor Author

adp2201 commented Mar 19, 2026

Thank you @carlosalberto

@adp2201 adp2201 mentioned this pull request Mar 19, 2026
Open
@carlosalberto carlosalberto mentioned this pull request Apr 15, 2026
Merged
@lmolkova lmolkova mentioned this pull request Apr 17, 2026
Closed
pull Bot pushed a commit to MC-MAGA/opentelemetry-specification that referenced this pull request Apr 20, 2026
@carlosalberto @jack-berg
Release 1.56 (open-telemetry#5029)
50149c2 
### Context

- Align environment variable context propagation name restrictions with
POSIX.1-2024
  and define normalization behavior.

([open-telemetry#4944](open-telemetry#4944))
- Decouple the responsibilities of the environment variable propagation
carrier.

([open-telemetry#4961](open-telemetry#4961))
- Remove misleading implementation approach the environment variable
propagation.

([open-telemetry#5003](open-telemetry#5003))
- Change Environment Variables as Context Propagation Carriers document
status to Beta.

([open-telemetry#5020](open-telemetry#5020))

### Traces

- Stabilize Tracer `enabled` operation

([open-telemetry#4941](open-telemetry#4941))
- Stabilize `AlwaysRecord` sampler.

([open-telemetry#4934](open-telemetry#4934))

### Metrics

- Add development `maxExportBatchSize` parameter to Periodic exporting
MetricReader.

([open-telemetry#4895](open-telemetry#4895))

### Logs

- Add event to span event bridge.

([open-telemetry#5006](open-telemetry#5006))

### Resource

- Clarify that a Resource describes the observed entity, not the
component
  that technically emits telemetry.

([open-telemetry#4905](open-telemetry#4905))

### Compatibility

- Deprecate OpenTracing compatibility requirements in the specification.

([open-telemetry#4938](open-telemetry#4938))
- Stabilize sections of Prometheus and OpenMetrics Compatibility.
- Stabilize Prometheus Classic Histogram to OTLP Explicit Histogram
transformation.

([open-telemetry#4874](open-telemetry#4874))
  - Stabilize Prometheus Timestamp and Start timestamp transformation.

([open-telemetry#4953](open-telemetry#4953))
- Clarify Prometheus Native Histogram to OTLP Exponential Histogram
conversion,
add conversion rules for Native Histograms with Custom Buckets (NHCB) to
OTLP
    Histogram.

([open-telemetry#4898](open-telemetry#4898))
  - Stabilize Prometheus Dropped Types transformation.

([open-telemetry#4952](open-telemetry#4952))
- Stabilize OpenTelemetry Attributes to Prometheus labels
transformation.

([open-telemetry#4963](open-telemetry#4963))
- Stabilize Prometheus Exemplar to OpenTelemetry Exemplar
transformation.

([open-telemetry#4962](open-telemetry#4962))
  - Stabilize Prometheus Metadata transformation.

([open-telemetry#4954](open-telemetry#4954))
- Stabilize OpenTelemetry Metric Metadata to Prometheus metric metadata.

([open-telemetry#4966](open-telemetry#4966))
- Stabilize OpenTelemetry Exemplar to Prometheus Exemplar
transformation.

([open-telemetry#4964](open-telemetry#4964))
- Stabilize sections of Prometheus Metrics Exporter.
  - Stabilize host configuration.

([open-telemetry#5025](open-telemetry#5025))

### SDK Configuration

- Declarative configuration: add in-development guidance for exposing
the
  effective `Resource` returned by `Create`.

([open-telemetry#4949](open-telemetry#4949))
- Require spec changes to consider declarative config schema

([open-telemetry#4916](open-telemetry#4916))
- Add strict YAML parsing guidance to configuration supplementary
guidelines.

([open-telemetry#4878](open-telemetry#4878))

### OTEPs

- Process Context: Sharing Resource Attributes with External Readers.

([open-telemetry#4719](open-telemetry#4719))
- Support multiple Resources within an SDK.

([open-telemetry#4665](open-telemetry#4665))

---------

Co-authored-by: Jack Berg <34418638+jack-berg@users.noreply.github.com>
hilmarf pushed a commit to apeirora/opentelemetry-specification that referenced this pull request Apr 22, 2026
@carlosalberto @jack-berg @hilmarf
Release 1.56 (open-telemetry#5029)
68fba8a 
### Context

- Align environment variable context propagation name restrictions with
POSIX.1-2024
  and define normalization behavior.

([open-telemetry#4944](open-telemetry#4944))
- Decouple the responsibilities of the environment variable propagation
carrier.

([open-telemetry#4961](open-telemetry#4961))
- Remove misleading implementation approach the environment variable
propagation.

([open-telemetry#5003](open-telemetry#5003))
- Change Environment Variables as Context Propagation Carriers document
status to Beta.

([open-telemetry#5020](open-telemetry#5020))

### Traces

- Stabilize Tracer `enabled` operation

([open-telemetry#4941](open-telemetry#4941))
- Stabilize `AlwaysRecord` sampler.

([open-telemetry#4934](open-telemetry#4934))

### Metrics

- Add development `maxExportBatchSize` parameter to Periodic exporting
MetricReader.

([open-telemetry#4895](open-telemetry#4895))

### Logs

- Add event to span event bridge.

([open-telemetry#5006](open-telemetry#5006))

### Resource

- Clarify that a Resource describes the observed entity, not the
component
  that technically emits telemetry.

([open-telemetry#4905](open-telemetry#4905))

### Compatibility

- Deprecate OpenTracing compatibility requirements in the specification.

([open-telemetry#4938](open-telemetry#4938))
- Stabilize sections of Prometheus and OpenMetrics Compatibility.
- Stabilize Prometheus Classic Histogram to OTLP Explicit Histogram
transformation.

([open-telemetry#4874](open-telemetry#4874))
  - Stabilize Prometheus Timestamp and Start timestamp transformation.

([open-telemetry#4953](open-telemetry#4953))
- Clarify Prometheus Native Histogram to OTLP Exponential Histogram
conversion,
add conversion rules for Native Histograms with Custom Buckets (NHCB) to
OTLP
    Histogram.

([open-telemetry#4898](open-telemetry#4898))
  - Stabilize Prometheus Dropped Types transformation.

([open-telemetry#4952](open-telemetry#4952))
- Stabilize OpenTelemetry Attributes to Prometheus labels
transformation.

([open-telemetry#4963](open-telemetry#4963))
- Stabilize Prometheus Exemplar to OpenTelemetry Exemplar
transformation.

([open-telemetry#4962](open-telemetry#4962))
  - Stabilize Prometheus Metadata transformation.

([open-telemetry#4954](open-telemetry#4954))
- Stabilize OpenTelemetry Metric Metadata to Prometheus metric metadata.

([open-telemetry#4966](open-telemetry#4966))
- Stabilize OpenTelemetry Exemplar to Prometheus Exemplar
transformation.

([open-telemetry#4964](open-telemetry#4964))
- Stabilize sections of Prometheus Metrics Exporter.
  - Stabilize host configuration.

([open-telemetry#5025](open-telemetry#5025))

### SDK Configuration

- Declarative configuration: add in-development guidance for exposing
the
  effective `Resource` returned by `Create`.

([open-telemetry#4949](open-telemetry#4949))
- Require spec changes to consider declarative config schema

([open-telemetry#4916](open-telemetry#4916))
- Add strict YAML parsing guidance to configuration supplementary
guidelines.

([open-telemetry#4878](open-telemetry#4878))

### OTEPs

- Process Context: Sharing Resource Attributes with External Readers.

([open-telemetry#4719](open-telemetry#4719))
- Support multiple Resources within an SDK.

([open-telemetry#4665](open-telemetry#4665))

---------

Co-authored-by: Jack Berg <34418638+jack-berg@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@carlosalberto carlosalberto carlosalberto left review comments

@jmacd jmacd jmacd approved these changes

@cijothomas cijothomas cijothomas approved these changes

@reyang reyang reyang approved these changes

+1 more reviewer

@Kielek Kielek Kielek approved these changes

Reviewers whose approvals may not affect merge requirements

Assignees

@carlosalberto carlosalberto

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

6 participants

@adp2201 @carlosalberto @jmacd @cijothomas @Kielek @reyang