Skip to content

[google-genai] Add standard definitions to Google GenAI systems#3517

Closed
Rima-ag wants to merge 9 commits intoopen-telemetry:mainfrom
Rima-ag:init-gcp-genai
Closed

[google-genai] Add standard definitions to Google GenAI systems#3517
Rima-ag wants to merge 9 commits intoopen-telemetry:mainfrom
Rima-ag:init-gcp-genai

Conversation

@Rima-ag
Copy link
Copy Markdown

@Rima-ag Rima-ag commented Mar 8, 2026

open-telemetry/semantic-conventions-genai#27

Changes

Create documentation for the common span definition of Google systems. This will make it easier to review #3486 that is adding Google-specific semconv.

Merge requirement checklist

  • CONTRIBUTING.md guidelines followed.
  • Change log entry added, according to the guidelines in When to add a changelog entry.
    • If your PR does not need a change log, start the PR title with [chore]
  • Links to the prototypes or existing instrumentations (when adding or changing conventions)

@github-actions github-actions Bot added enhancement New feature or request area:gen-ai labels Mar 8, 2026
@Rima-ag Rima-ag marked this pull request as ready for review March 8, 2026 19:59
@Rima-ag Rima-ag requested review from a team as code owners March 8, 2026 19:59
@lmolkova lmolkova moved this from Untriaged to Awaiting codeowners approval in Semantic Conventions Triage Mar 9, 2026
@github-actions
Copy link
Copy Markdown

This PR has been labeled as stale due to lack of activity. It will be automatically closed if there is no further activity over the next 7 days.

@github-actions github-actions Bot added the Stale label Mar 23, 2026
Comment thread docs/gen-ai/gcp.md Outdated
Comment thread docs/gen-ai/google-genai.md
@github-actions
Copy link
Copy Markdown

This PR has been labeled as stale due to lack of activity. It will be automatically closed if there is no further activity over the next 7 days.

@github-actions github-actions Bot added the Stale label Apr 13, 2026
Copy link
Copy Markdown
Member

@MikeGoldsmith MikeGoldsmith left a comment

Choose a reason for hiding this comment

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

Looks pretty good @Rima-ag. Thanks for working on this.


`gen_ai.provider.name` MUST be set to `"gcp.gen_ai"`, `"gcp.vertex_ai"`, or `"gcp.gemini"` and SHOULD be provided **at span creation time**.

**Span name** SHOULD be `{gen_ai.operation.name} {gen_ai.request.model}`.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

These look identical to the base GenAI convention so no need to restate it here unless Google deviates. If the intent is just to inherit the base behavior, I think can be dropped.

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

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

The direction the GenAI semantic documentation is going with is for every provider's doc to be self explanatory, this is why this is restated here

I also think it's easier to not have to compare 2 different pages to understand how spans will be created

Comment thread model/gen-ai/spans.yaml
requirement_level:
conditionally_required: If not default (443).

- id: span.gen_ai.gcp.client
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

This looks the same as the base attributes.gen_ai.inference.client - does it add anything different? If not, we could remove.

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

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

That's mostly true, the only difference is the note about gen_ai.provider.name that is injected in the documentation. Other providers are also documented with this pattern.
In #3486 we'll be adding a Google specific attribute

@Rima-ag
Copy link
Copy Markdown
Author

Rima-ag commented Apr 29, 2026

#3383 already added standard definitions

@github-actions
Copy link
Copy Markdown

github-actions Bot commented May 5, 2026

This PR contains changes to area(s) that do not have an active SIG/project and will be auto-closed:

  • gen-ai

Such changes may be rejected or put on hold until a new SIG/project is established.

Please refer to the Semantic Convention Areas
document to see the current active SIGs and also to learn how to kick start a new one.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Development

Successfully merging this pull request may close these issues.

5 participants