Skip to content

Deprecate the exporters and related artifacts#441

Draft
psx95 wants to merge 10 commits into
GoogleCloudPlatform:mainfrom
psx95:release-minor-version
Draft

Deprecate the exporters and related artifacts#441
psx95 wants to merge 10 commits into
GoogleCloudPlatform:mainfrom
psx95:release-minor-version

Conversation

@psx95
Copy link
Copy Markdown
Contributor

@psx95 psx95 commented May 7, 2026

This PR marks the public APIs of the artifacts released from this repository as deprecated and also emits deprecation warnings during runtime in form of logs in case any of these artifacts are used in an application.

The PR also adds a migration guide, which will hold instructions for users to follow while moving from the OpenTelemetry Google Cloud Monitoring and Trace exporters to OpenTelemetry OTLP exporters.

@psx95 psx95 force-pushed the release-minor-version branch from 6d7912b to 6507068 Compare May 7, 2026 21:35
@psx95 psx95 changed the title Release minor version Deprecate the exporters and related artifacts May 7, 2026
@psx95 psx95 requested review from aabmass and dashpole May 7, 2026 21:38
Comment thread MIGRATION.md Outdated
Comment thread MIGRATION.md
Comment thread MIGRATION.md Outdated
@psx95 psx95 force-pushed the release-minor-version branch from 50e8f0d to ab54b0d Compare May 11, 2026 20:50
@psx95 psx95 marked this pull request as ready for review May 14, 2026 17:08
@psx95 psx95 requested a review from a team as a code owner May 14, 2026 17:08
@psx95 psx95 marked this pull request as draft May 14, 2026 17:13
Comment thread MIGRATION.md Outdated
Comment thread MIGRATION.md Outdated
Comment thread MIGRATION.md
| `setCredentials(Credentials)` | Pass the bearer token as Authorization Header in the exporter | Handled automatically by `opentelemetry-gcp-auth-extension`. |
| `setMetricServiceEndpoint(String)` | `otel.exporter.otlp.endpoint` / `OTEL_EXPORTER_OTLP_ENDPOINT` | Set it to `https://telemetry.googleapis.com` to send metrics to Google Cloud. |
| `setDeadline(Duration)` | `otel.exporter.otlp.timeout` / `OTEL_EXPORTER_OTLP_TIMEOUT` | Default is 10 seconds. |
| `setPrefix(String)` | N/A | The Telemetry API automatically prefixes metrics with `prometheus.googleapis.com/` by default and will be stored in Google Managed Prometheus with `prometheus_target` as the Monitored Resource. Custom prefixes are not directly supported via OTLP exporter configuration.<br>If you want your metric to keep appearing under your previous prefix (e.g., `workload.googleapis.com`), you must include the full prefix in the metric name you define in your OpenTelemetry instrumentation. |
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

I don't think this is going to be acceptable. We need to find a way for users to migrate to the OTLP exporter without breaking dashboards. There must be some way to do that, right? Is it possible with a view in java? Or do we need to show users how to "wrap" their OTLP exporter to update metric names during the migration?

Comment thread MIGRATION.md
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

This seems duplicative of https://docs.cloud.google.com/trace/docs/migrate-to-otlp-endpoints

do we need both ?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

The trace one is, but this document has a little more information. Eventually we plan to update https://docs.cloud.google.com/trace/docs/migrate-to-otlp-endpoints and have that as single source of truth.

Comment thread README.md Outdated
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants