Skip to content

Update vertexai instrumentation to be in-line with the latest semantic conventions #3709

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 8 commits into
base: main
Choose a base branch
from

Conversation

DylanRussell
Copy link

@DylanRussell DylanRussell commented Aug 21, 2025

Description

Start making changes to implement the big semantic convention changes made in open-telemetry/semantic-conventions#2179.

Now only a single event (gen_ai.client.inference.operation.details) is used to capture Chat History. These changes will be opt-in, users will need to set the environment variable OTEL_SEMCONV_STABILITY_OPT_IN to gen_ai_latest_experimental to see them.

Type of change

Please delete options that are not relevant.

  • [x ] New feature (non-breaking change which adds functionality)

How Has This Been Tested?

Unit tests

Does This PR Require a Core Repo Change?

No.. We should wait for a sem conv release (and core repo to pick that up) before releasing this change, but I don't this PR needs to wait for those.

Checklist:

See contributing.md for styleguide, changelog guidelines, and more.

  • [ x] Followed the style guidelines of this project
  • [ x] Changelogs have been updated
  • [ x] Unit tests have been added
  • [ x] Documentation has been updated

@DylanRussell DylanRussell requested a review from a team as a code owner August 21, 2025 19:37
@DylanRussell DylanRussell changed the title Update vertexai instrumentation to be in-line with the semantic convention changes in https://github.com/open-telemetry/semantic-conventions/pull/2179 Update vertexai instrumentation to be in-line with the semantic convention changes Aug 21, 2025
@DylanRussell DylanRussell changed the title Update vertexai instrumentation to be in-line with the semantic convention changes Update vertexai instrumentation to be in-line with the latest semantic conventions Aug 21, 2025
@DylanRussell
Copy link
Author

I'm confused by the OTEL_SEMCONV_STABILITY_OPT_IN env var. I think the idea is to avoid breaking people, and make the breaking changes made by open-telemetry/semantic-conventions#2179 opt-in.

Maybe the value of that envvar should just be a version number, and every new version which has breaking changes we put them behind a gate with that version number ? If a user sets the env var to v3, they get all breaking changes from v1/v2/v3, there will be no way to pick and choose which breaking changes they get.. But making all the permutations of breaking changes opt-in is kind of a pain.. I suppose the flag is repeated so we could let users specify multiple versions in it, to get just the breaking changes they want..

Users will be opted-in to the non-breaking semantic convention changes by default, I think that is fine..

I don't like that new users have to know to set this env var and don't get all the newest stuff by default..

Would be interested in others thoughts on this..

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.

6 participants