Advance notice of Istio deprecating Opencensus #13715

lei-tang · 2023-08-10T18:01:32Z

Please provide a description for what this PR is for.
Advance notice of Istio deprecating Opencensus.

And to help us figure out who should review this PR, please
put an X in all the areas that this PR affects.

istio-policy-bot · 2023-08-10T18:07:41Z

😊 Welcome! This is either your first contribution to the Istio documentation repo, or
it's been awhile since you've been here. A few things you should know:

You can learn about how we write and maintain documentation, about our style guidelines,
and about all the available web site features by visiting Contributing to the Docs.
In the next few minutes, an automatic preview of your change will be
built as a full copy of the istio.io website. You can find this preview by clicking on
the Details link next to the deploy/netlify entry in the Status section of this
page.
We care about quality, so we've put in place a number of checks to ensure our documentation
is top notch. We do spell checking, we sanitize the markdown, we ensure all hyperlinks point
to valid location, and more. If your PR doesn't pass one of these checks, you'll see a red X in the
status section of the page. Click on the Details link to get a list of the problems with your PR.
Fix those problems and push an update to your PR. This will automatically rerun the tests and
hopefully this time everything will be perfect.
Once your changes are accepted and merged into the repository, they will initially show up
on https://preliminary.istio.io. The changes will be published to https://istio.io
the next time we do a major release (which typically happens every 3 months or so).

Thanks for contributing!

Courtesy of your friendly welcome wagon.

content/en/news/support/advance-notice-opencensus-deprecation/index.md

kyessenov

Thanks for publishing this!

content/en/news/support/advance-notice-opencensus-deprecation/index.md

kyessenov · 2023-08-10T18:44:16Z

content/en/news/support/advance-notice-opencensus-deprecation/index.md

+
+OpenCensus has [sunsetted](https://opentelemetry.io/blog/2023/sunsetting-opencensus) on July 31st, 2023.
+
+The OpenCensus sunsetting will impact Istio's usage of OpenCensus in tracing, logging, and metrics. Istio


Can you expand on where it's used exactly? Is it just Stackdriver and OpenCensus providers? Do we export zipkin with OpenCensus?

Just Stackdriver and OpenCensus providers. We do not export zipkin with OpenCensus.

howardjohn · 2023-08-11T00:10:32Z

content/en/news/support/advance-notice-opencensus-deprecation/index.md

+The OpenCensus sunset will impact Istio's usage of OpenCensus in tracing, logging, and metrics. Istio
+plans to use OpenTelemetry exporters with the OpenTelemetry collector to provide matching telemetry capabilities.


This is extremely confusing to me.... maybe I am missing something

First, 99.99% of Istio users do not use OpenCensus at all. This document needs to be more clear about who is impacted.

AFAIK only users who configure https://istio.io/latest/docs/reference/config/istio.mesh.v1alpha1/#MeshConfig-ExtensionProvider-OpenCensusAgentTracingProvider are impacted. This is also only tracing, not logging/metrics.

its also not clear why otel collector is recommended. That is not our problem - users should use https://istio.io/latest/docs/reference/config/istio.mesh.v1alpha1/#MeshConfig-ExtensionProvider-OpenTelemetryTracingProvider, but whether they point to a collector or other OTLP receiver is their problem

Stackdriver uses OpenCensus too. We should say clearly which API fields are going to be removed and put deprecations there.

This may need to be designed. If an equivalent C++ SDK or an OTLP endpoint is used, the deprecation may be transparent to users.

howardjohn · 2023-08-11T00:10:48Z

content/en/news/support/advance-notice-opencensus-deprecation/index.md

+The OpenCensus sunset will impact Istio's usage of OpenCensus in tracing, logging, and metrics. Istio
+plans to use OpenTelemetry exporters with the OpenTelemetry collector to provide matching telemetry capabilities.
+
+This is an advance notice of Istio deprecating OpenCensus, which is tentatively scheduled to Oct. 10, 2024.


Are we really going to keep it for 1 year? Seems longer than I expected.

The deprecation policy of cloud vendors often mandates at least 12-month advance notice.

Ok but that doesn't really have barring in what Istio does.

content/en/news/support/advance-notice-opencensus-deprecation/index.md

ericvn · 2023-08-11T01:29:12Z

content/en/news/support/advance-notice-opencensus-deprecation/index.md

+At that point, Istio will stop supporting OpenCensus. We encourage you to start planning the transition to
+OpenTelemetry in Istio. If you don't plan this, you may put yourself in the position of having to do a major upgrade in a short timeframe.


As noted, is OpenTelemetry the only option. Then this makes sense. Otherwise, we should be telling them to move from OpenCensus.

Suggested change

At that point, Istio will stop supporting OpenCensus. We encourage you to start planning the transition to

OpenTelemetry in Istio. If you don't plan this, you may put yourself in the position of having to do a major upgrade in a short timeframe.

At that point, Istio will stop supporting OpenCensus. We encourage you to start planning a transition to

OpenTelemetry in Istio. If you don't plan ahead, you may put yourself in the position of having to do a major upgrade in a short timeframe.

Updated the wording to be transition away from opencensus.

craigbox · 2023-11-09T00:48:14Z

content/en/news/support/advance-notice-opencensus-deprecation/index.md

+The sunset of OpenCensus will impact Istio's usage of OpenCensus in tracing, logging, and metrics. Istio
+plans to use OpenTelemetry exporters with the OpenTelemetry collector to provide matching telemetry capabilities.
+
+This is an advance notice of Istio deprecating OpenCensus, tentatively scheduled for Oct. 10, 2024.


This date has sailed past. Is this still relevant, @lei-tang ?

I think it's relevant. @lei-tang did you want to remove opencensus API (not stackdriver) for Istio 1.20?

As Istio 1.20 release candidate is out on 11-2-2023 https://gcsweb.istio.io/gcs/istio-release/releases/1.20.0-rc.0/, I think the work to remove opencensus may take more time to complete (such as Istio 1.21 or 1.22). Do we have any volunteers to work on removing opencensus?

kyessenov · 2023-11-09T00:51:28Z

I think we did a disservice by not publishing this earlier... Istio project cannot maintain OpenCensus upstream dependency so we'll be forced to remove it in a non-graceful way.

howardjohn · 2023-11-10T01:41:06Z

content/en/news/support/advance-notice-opencensus-deprecation/index.md

+plans to use OpenTelemetry exporters with the OpenTelemetry collector to provide matching telemetry capabilities.
+
+This is an advance notice of Istio deprecating OpenCensus, tentatively scheduled for Oct. 10, 2024.
+At that point, Istio will stop supporting OpenCensus. We encourage you to start planning a transition away


Please link to what users should use instead (presumably, an OpenTelemetry doc)

howardjohn · 2023-11-10T01:41:22Z

content/en/news/support/advance-notice-opencensus-deprecation/index.md

+
+OpenCensus was [sunset](https://opentelemetry.io/blog/2023/sunsetting-opencensus) on July 31st, 2023.
+
+The sunset of OpenCensus will impact Istio's usage of OpenCensus in tracing, logging, and metrics. Istio


Please link to the specific API fields in Istio that will stop working.

howardjohn · 2023-11-10T01:42:02Z

content/en/news/support/advance-notice-opencensus-deprecation/index.md

+OpenCensus was [sunset](https://opentelemetry.io/blog/2023/sunsetting-opencensus) on July 31st, 2023.
+
+The sunset of OpenCensus will impact Istio's usage of OpenCensus in tracing, logging, and metrics. Istio
+plans to use OpenTelemetry exporters with the OpenTelemetry collector to provide matching telemetry capabilities.


Please remove this. There is no consensus in Istio that OTEL collectors will be used in Istio.

Advance notice of Istio deprecating Opencensus

be44013

lei-tang requested a review from a team as a code owner August 10, 2023 18:01

lei-tang requested a review from kyessenov August 10, 2023 18:01

istio-testing added the size/S Denotes a PR that changes 10-29 lines, ignoring generated files. label Aug 10, 2023

lei-tang mentioned this pull request Aug 10, 2023

[WIP] deps: Remove opencensus envoyproxy/envoy#28852

Draft

Small edit

568b1e2

istio-policy-bot added area/extensions and telemetry area/user experience kind/docs labels Aug 10, 2023

lei-tang mentioned this pull request Aug 10, 2023

Deprecation announcement: OpenCensus sunset on 7/31 istio/istio#44743

Closed

lint

33289c0

dhawton reviewed Aug 10, 2023

View reviewed changes

content/en/news/support/advance-notice-opencensus-deprecation/index.md Outdated Show resolved Hide resolved

content/en/news/support/advance-notice-opencensus-deprecation/index.md Outdated Show resolved Hide resolved

kyessenov reviewed Aug 10, 2023

View reviewed changes

lei-tang added 2 commits August 10, 2023 11:48

small edits

0819ade

lint

f7cc23e

istio deleted a comment from istio-testing Aug 10, 2023

howardjohn requested changes Aug 11, 2023

View reviewed changes

ericvn reviewed Aug 11, 2023

View reviewed changes

lei-tang added 2 commits August 10, 2023 19:00

edits

0977bba

Edit

982b7cb

craigbox reviewed Nov 9, 2023

View reviewed changes

howardjohn requested changes Nov 10, 2023

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Advance notice of Istio deprecating Opencensus #13715

Advance notice of Istio deprecating Opencensus #13715

lei-tang commented Aug 10, 2023

istio-policy-bot commented Aug 10, 2023

kyessenov left a comment

kyessenov Aug 10, 2023

lei-tang Aug 10, 2023

howardjohn Aug 11, 2023

kyessenov Aug 11, 2023

lei-tang Aug 11, 2023

howardjohn Aug 11, 2023

lei-tang Aug 11, 2023

howardjohn Aug 11, 2023

ericvn Aug 11, 2023

lei-tang Aug 11, 2023 •

edited

craigbox Nov 9, 2023

kyessenov Nov 9, 2023

lei-tang Nov 9, 2023

kyessenov commented Nov 9, 2023

howardjohn Nov 10, 2023

howardjohn Nov 10, 2023

howardjohn Nov 10, 2023


		OpenCensus has [sunsetted](https://opentelemetry.io/blog/2023/sunsetting-opencensus) on July 31st, 2023.

		The OpenCensus sunsetting will impact Istio's usage of OpenCensus in tracing, logging, and metrics. Istio

		The OpenCensus sunset will impact Istio's usage of OpenCensus in tracing, logging, and metrics. Istio
		plans to use OpenTelemetry exporters with the OpenTelemetry collector to provide matching telemetry capabilities.

		At that point, Istio will stop supporting OpenCensus. We encourage you to start planning the transition to
		OpenTelemetry in Istio. If you don't plan this, you may put yourself in the position of having to do a major upgrade in a short timeframe.


		OpenCensus was [sunset](https://opentelemetry.io/blog/2023/sunsetting-opencensus) on July 31st, 2023.

		The sunset of OpenCensus will impact Istio's usage of OpenCensus in tracing, logging, and metrics. Istio

Advance notice of Istio deprecating Opencensus #13715

Are you sure you want to change the base?

Advance notice of Istio deprecating Opencensus #13715

Conversation

lei-tang commented Aug 10, 2023

istio-policy-bot commented Aug 10, 2023

kyessenov left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

lei-tang Aug 11, 2023 • edited

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

kyessenov commented Nov 9, 2023

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

lei-tang Aug 11, 2023 •

edited