Skip to content

Deprecate the exporters and related artifacts#441

Draft
psx95 wants to merge 3 commits intoGoogleCloudPlatform:mainfrom
psx95:release-minor-version
Draft

Deprecate the exporters and related artifacts#441
psx95 wants to merge 3 commits intoGoogleCloudPlatform: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

## Migrate from OpenTelemetry Google Cloud Trace Exporter to OTLP exporter

Follow the [Migrate from the Trace exporter to the OTLP endpoint](https://docs.cloud.google.com/trace/docs/migrate-to-otlp-endpoints) guide for migration instructions.
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 think you can use https://docs.cloud.google.com/trace/docs/migrate-to-otlp-endpoints#java_3 to make sure it shows the java samples?

Comment thread MIGRATION.md
## Overview
Google Cloud now supports native OTLP (OpenTelemetry Protocol) ingestion for Cloud Trace and Cloud Monitoring via the [Telemetry API](https://docs.cloud.google.com/stackdriver/docs/reference/telemetry/overview). This allows you to use the standard OpenTelemetry OTLP exporters for sending telemetry data to Google Cloud.

## Migrate from OpenTelemetry Google Cloud Trace Exporter to OTLP exporter
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 was imagining this would be fairly detailed, but I guess it doesn't have to be if it is covered in the GCP docs. We should make sure we tell users of each of the configuration options how they can obtain the same behavior with the OTLP exporter:

  • setFixedAttributes
  • setAttributeMapping

Comment thread MIGRATION.md

> [!NOTE] The Google Cloud OTLP metrics endpoint is currently in preview and the migration guides are being developed.

TODO: Add migration guide for metrics exporter
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.

Things to cover for metrics other than just the default "make it work":

  • How to set a prefix with the OTLP exporter (Currently using setPrefix, or if they want the previous default workload.googleapis.com)
  • setResourceAttributesFilter
  • setInstrumentationLibraryLabelsEnabled

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.

2 participants