From 975513a48c4613d6b0642385d49660c58783c99a Mon Sep 17 00:00:00 2001 From: Krishna Chaitanya KC Date: Fri, 12 Jun 2026 12:05:44 -0700 Subject: [PATCH 1/2] Blog post for OpenCensus compatibility deprecation --- .../deprecating-opencensus-compatibility.md | 84 +++++++++++++++++++ 1 file changed, 84 insertions(+) create mode 100644 content/en/blog/2026/deprecating-opencensus-compatibility.md diff --git a/content/en/blog/2026/deprecating-opencensus-compatibility.md b/content/en/blog/2026/deprecating-opencensus-compatibility.md new file mode 100644 index 000000000000..b1f3b1ac14b7 --- /dev/null +++ b/content/en/blog/2026/deprecating-opencensus-compatibility.md @@ -0,0 +1,84 @@ +--- +title: Deprecating OpenCensus compatibility requirements +linkTitle: Deprecating OpenCensus compatibility +date: 2026-06-23 +author: + '[Krishna Chaitanya Kalluri](https://github.com/Krishnachaitanyakc) (Meta)' +issue: https://github.com/open-telemetry/opentelemetry-specification/pull/5138 +sig: Specification +cSpell:ignore: Chaitanya Kalluri Krishna +--- + +On June 12, 2026, the OpenTelemetry Specification project merged +[PR #5138](https://github.com/open-telemetry/opentelemetry-specification/pull/5138), +deprecating OpenCensus compatibility requirements in the specification. + +This change updates the specification to match where the ecosystem already is: +[OpenCensus has been archived since July 31, 2023](/blog/2023/sunsetting-opencensus/), +and the OpenTelemetry shims for OpenCensus have provided a stable migration +bridge for more than three years. + +This is a deprecation of specification requirements, not an immediate removal of +compatibility material and not a requirement to remove existing shim artifacts +right away. + +## What is changing? + +- OpenCensus compatibility requirements in the specification are deprecated. +- Implementing new OpenCensus compatibility is no longer required for new SDKs + or implementations. +- Existing OpenCensus shims MAY continue to be supported for backwards + compatibility during the deprecation period. +- New work should target native OpenTelemetry APIs, SDKs, and OTLP-based + workflows instead of introducing new OpenCensus dependencies. + +## Why now? + +OpenCensus was archived in July 2023, and ecosystem adoption has converged +around native OpenTelemetry APIs and OTLP-based workflows. The project also has +precedent for this staged approach from prior deprecation work, including the +[2023 sunset of OpenCensus repositories](/blog/2023/sunsetting-opencensus/), the +[Zipkin exporter deprecation](/blog/2025/deprecating-zipkin-exporters/) +([spec PR #4715](https://github.com/open-telemetry/opentelemetry-specification/pull/4715)), +and the +[OpenTracing compatibility deprecation](/blog/2026/deprecating-opentracing-compatibility/) +([spec PR #4938](https://github.com/open-telemetry/opentelemetry-specification/pull/4938)). + +## Timeline and policy + +- **Specification deprecation**: effective as of **June 2026**. +- **Earliest specification removal**: **no earlier than June 2027**, as stated + in the merged spec text. +- **Shim support**: existing OpenCensus shims will continue to receive + maintenance for at least one year, following + [OpenTelemetry's SDK stability guarantees](/docs/specs/otel/versioning-and-stability/#sdk-support). + +## What should users do? + +If you still depend on an OpenCensus shim, now is the right time to plan +migration to native OpenTelemetry APIs and SDKs. + +Start by reviewing: + +- [How to migrate to OpenTelemetry](/blog/2023/sunsetting-opencensus/#how-to-migrate-to-opentelemetry) + from the 2023 sunset announcement. +- The + [OpenCensus Compatibility specification — Migration path](/docs/specs/otel/compatibility/opencensus/#migration-path). +- The language-specific shims: + [Go](https://github.com/open-telemetry/opentelemetry-go/tree/928d4f3726bf08e5be046752ebae169ad9f9376a/bridge/opencensus), + [Java](https://github.com/open-telemetry/opentelemetry-java/tree/a5cd87f127cd8d4e5845bc1e29360f815a6f01c8/opencensus-shim), + [JavaScript](https://github.com/open-telemetry/opentelemetry-js/tree/13a035bc695996cf4aec885fef7b9866f48bc555/experimental/packages/shim-opencensus), + and + [Python](https://github.com/open-telemetry/opentelemetry-python/tree/51c1d1888c4045b8296e088fa307738685321bf3/shim/opentelemetry-opencensus-shim). + +## Closing + +Deprecation here does not mean removing OpenCensus compatibility material +immediately. It is about codifying that new SDKs and instrumentations should +target native OpenTelemetry APIs and OTLP, and aligning the specification with +where the ecosystem already is. + +Please share feedback or migration blockers on +[spec PR #5138](https://github.com/open-telemetry/opentelemetry-specification/pull/5138) +or the +[originating issue #5109](https://github.com/open-telemetry/opentelemetry-specification/issues/5109). From d59da6fd305e7d3fccbc4dfd1028d15c60b058aa Mon Sep 17 00:00:00 2001 From: otelbot <197425009+otelbot@users.noreply.github.com> Date: Fri, 19 Jun 2026 13:09:16 +0000 Subject: [PATCH 2/2] Results from /fix directive --- static/refcache.json | 28 ++++++++++++++++++++++++++++ 1 file changed, 28 insertions(+) diff --git a/static/refcache.json b/static/refcache.json index cdc9c84ad3fa..b320e0a38151 100644 --- a/static/refcache.json +++ b/static/refcache.json @@ -3723,6 +3723,10 @@ "StatusCode": 206, "LastSeen": "2026-06-12T11:04:56.303474251Z" }, + "https://github.com/Krishnachaitanyakc": { + "StatusCode": 206, + "LastSeen": "2026-06-19T13:05:08.182993115Z" + }, "https://github.com/LZiHaN": { "StatusCode": 206, "LastSeen": "2026-06-13T10:31:33.790141969Z" @@ -10979,6 +10983,10 @@ "StatusCode": 206, "LastSeen": "2026-06-15T11:39:27.078243663Z" }, + "https://github.com/open-telemetry/opentelemetry-go/tree/928d4f3726bf08e5be046752ebae169ad9f9376a/bridge/opencensus": { + "StatusCode": 206, + "LastSeen": "2026-06-19T13:05:18.643742738Z" + }, "https://github.com/open-telemetry/opentelemetry-go/tree/main/exporters/otlp": { "StatusCode": 206, "LastSeen": "2026-06-11T14:51:12.081217107Z" @@ -11831,6 +11839,10 @@ "StatusCode": 206, "LastSeen": "2026-06-16T11:23:29.439372943Z" }, + "https://github.com/open-telemetry/opentelemetry-java/tree/a5cd87f127cd8d4e5845bc1e29360f815a6f01c8/opencensus-shim": { + "StatusCode": 206, + "LastSeen": "2026-06-19T13:05:23.491446874Z" + }, "https://github.com/open-telemetry/opentelemetry-java/tree/main/api/incubator": { "StatusCode": 206, "LastSeen": "2026-06-13T10:26:12.547822485Z" @@ -12227,6 +12239,10 @@ "StatusCode": 206, "LastSeen": "2026-06-14T10:43:26.619525789Z" }, + "https://github.com/open-telemetry/opentelemetry-js/tree/13a035bc695996cf4aec885fef7b9866f48bc555/experimental/packages/shim-opencensus": { + "StatusCode": 206, + "LastSeen": "2026-06-19T13:05:27.459688716Z" + }, "https://github.com/open-telemetry/opentelemetry-js/tree/4636de6a16d338a418ee901ee6b685b887585c4f/doc/upgrade-to-2.x.md?from_branch=main": { "StatusCode": 206, "LastSeen": "2026-06-11T11:15:23.615545052Z" @@ -13055,6 +13071,10 @@ "StatusCode": 206, "LastSeen": "2026-06-16T11:22:23.614387244Z" }, + "https://github.com/open-telemetry/opentelemetry-python/tree/51c1d1888c4045b8296e088fa307738685321bf3/shim/opentelemetry-opencensus-shim": { + "StatusCode": 206, + "LastSeen": "2026-06-19T13:05:32.35863456Z" + }, "https://github.com/open-telemetry/opentelemetry-python/tree/main/docs/examples/auto-instrumentation": { "StatusCode": 206, "LastSeen": "2026-06-12T10:57:05.867328995Z" @@ -13579,6 +13599,10 @@ "StatusCode": 206, "LastSeen": "2026-06-12T10:56:57.110183472Z" }, + "https://github.com/open-telemetry/opentelemetry-specification/issues/5109": { + "StatusCode": 206, + "LastSeen": "2026-06-19T13:05:39.346353272Z" + }, "https://github.com/open-telemetry/opentelemetry-specification/issues/617": { "StatusCode": 206, "LastSeen": "2026-06-13T10:25:09.036109281Z" @@ -13619,6 +13643,10 @@ "StatusCode": 206, "LastSeen": "2026-06-13T10:25:07.326355042Z" }, + "https://github.com/open-telemetry/opentelemetry-specification/pull/5138": { + "StatusCode": 206, + "LastSeen": "2026-06-19T13:05:14.735403969Z" + }, "https://github.com/open-telemetry/opentelemetry-specification/tree/main/oteps/#readme": { "StatusCode": 206, "LastSeen": "2026-06-15T11:38:05.704853817Z"