Skip to content

[google-genai/spans] Define gcp.gen_ai.operation.config. attribute#3486

Open
Rima-ag wants to merge 39 commits intoopen-telemetry:mainfrom
Rima-ag:gcp_genai_request_star_attributes
Open

[google-genai/spans] Define gcp.gen_ai.operation.config. attribute#3486
Rima-ag wants to merge 39 commits intoopen-telemetry:mainfrom
Rima-ag:gcp_genai_request_star_attributes

Conversation

@Rima-ag
Copy link
Copy Markdown

@Rima-ag Rima-ag commented Feb 28, 2026

Addresses comments on #2125

Copied Description from original PR

Fixes #2053

Changes

Defines a gcp.gen_ai.operation.config. dynamic attribute in support of Google Gen AI SDK instrumentation (see: open-telemetry/opentelemetry-python-contrib#3374). In support of this change, this also adds a Google-specific variant of the Gen AI docs. We anticipate that this will serve to enable additional documentation and Semantic Conventions for Google-specific elements beyond the dynamic request attributes being documented here.

Merge requirement checklist

*[N/A] schema-next.yaml updated with changes to existing conventions.

@github-actions
Copy link
Copy Markdown

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

  • gcp

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.

@github-actions github-actions bot closed this Feb 28, 2026
@Rima-ag Rima-ag changed the title Gcp genai request star attributes Define dynamic request attributes for Google GenAI LLM inference spans Feb 28, 2026
@github-actions
Copy link
Copy Markdown

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

  • gcp

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.

1 similar comment
@github-actions
Copy link
Copy Markdown

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

  • gcp

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.


**Status:** ![Development](https://img.shields.io/badge/-development-blue)

Semantic Conventions for model inference spans when calling Google systems.
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Wouldn't it make more sense to just list the non-standard sem-convs used by Gemini in this doc ?

Why list out all the existing sem convs ??

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

I'm having trouble figuring out what new Gemini specific attribute is being added because the diff on this PR is so big

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.

Note we have deliberately moved away from pages which only lists extensions to pages which document the entire definition to provider the reader with a single location to look.

There is 2 options:

  • model/gen-ai/spans.yaml shows what extensions & modifications are being done to the definitions
  • we split this PR in 2. First uses the standard definitions aka no model changes & the second tailors it to gcp.

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.

I'm splitting this PR in 2 to make it easier to review

Copy link
Copy Markdown
Author

@Rima-ag Rima-ag Mar 17, 2026

Choose a reason for hiding this comment

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

I opened #3517 to add the standard definitions for google genai spans, could you please have a look? Once it is merged, it will be easier to review this PR that adds a new span attribute

@Rima-ag Rima-ag marked this pull request as draft March 6, 2026 07:30
@Rima-ag Rima-ag changed the title Define dynamic request attributes for Google GenAI LLM inference spans [google-genai/spans] Define gcp.gen_ai.operation.config. attribute Mar 16, 2026
@Rima-ag Rima-ag marked this pull request as ready for review March 18, 2026 21:27
@Rima-ag Rima-ag force-pushed the gcp_genai_request_star_attributes branch from 563cfb0 to 21521af Compare March 29, 2026 13:23
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

Status: Awaiting codeowners approval

Development

Successfully merging this pull request may close these issues.

Dynamic "gcp.gen_ai.request.*" attributes in support of Gen AI SDK instrumentation

5 participants