Update GenAI conventions based on system-specific naming guidance#2046
Merged
lmolkova merged 23 commits intoopen-telemetry:mainfrom Jul 8, 2025
Merged
Update GenAI conventions based on system-specific naming guidance#2046lmolkova merged 23 commits intoopen-telemetry:mainfrom
lmolkova merged 23 commits intoopen-telemetry:mainfrom
Conversation
aabmass
reviewed
May 1, 2025
1f761b7 to
e365808
Compare
|
This PR was marked stale due to lack of activity. It will be closed in 7 days. |
ghost
reviewed
May 27, 2025
ecaa58d to
4d99508
Compare
gyliu513
approved these changes
May 30, 2025
trask
reviewed
Jun 23, 2025
trask
reviewed
Jun 23, 2025
added 2 commits
June 23, 2025 18:06
aabmass
approved these changes
Jun 26, 2025
Contributor
There was a problem hiding this comment.
Pull Request Overview
This pull request implements system‐specific naming guidance for GenAI semantic conventions. It renames the attribute "gen_ai.system" to "gen_ai.provider.name", removes the "gen_ai" prefix from all "gen_ai.openai." attributes, and updates system names for Azure AI from "az.ai." to "azure.ai.*".
Reviewed Changes
Copilot reviewed 23 out of 23 changed files in this pull request and generated no comments.
Show a summary per file
| File | Description |
|---|---|
| templates/registry/markdown/weaver.yaml | Added "OpenAI" to the acronyms list. |
| schema-next.yaml | Updated YAML schema with the new attribute mappings. |
| model/openai/registry.yaml | Introduced OpenAI attribute changes. |
| model/gen-ai/spans.yaml | Updated span definitions to use "gen_ai.provider.name" (with one instance using "gen_ai.provide.name"). |
| model/gen-ai/registry.yaml | Changed attribute IDs and documentation to reflect the new names. |
| model/gen-ai/metrics.yaml | Adjusted attribute references for openai metrics. |
| model/gen-ai/events.yaml | Updated event attribute references. |
| model/gen-ai/deprecated/registry-deprecated.yaml | Updated deprecated attributes. |
| docs/registry/attributes/*.md | Updated documentation references across several attribute pages. |
| docs/gen-ai/*.md | Updated spans, metrics, and events documentation to replace any "gen_ai.system" mentions with "gen_ai.provider.name" and "az.ai" with "azure.ai". |
| .github/ISSUE_TEMPLATE/*.yaml | Added the "openai" area to issue templates. |
| .chloggen/gen-ai-system-naming.yaml | Documented the breaking change in system naming. |
Comments suppressed due to low confidence (2)
model/gen-ai/spans.yaml:171
- It appears there is a typographical error in the attribute name 'gen_ai.provide.name'. To be consistent with the naming convention, it should be 'gen_ai.provider.name'.
`gen_ai.provide.name` MUST be set to `"azure.ai.inference"` and SHOULD be provided **at span creation time**.
docs/gen-ai/azure-ai-inference.md:58
- The attribute 'gen_ai.provide.name' contains a typo; it should be corrected to 'gen_ai.provider.name' for consistency with the overall change in naming conventions.
`gen_ai.provide.name` MUST be set to `"azure.ai.inference"` and SHOULD be provided **at span creation time**.
034fd5b to
2337a38
Compare
trask
approved these changes
Jul 7, 2025
spurplewang
pushed a commit
to spurplewang/semantic-conventions
that referenced
this pull request
Jul 10, 2025
3 tasks
4 tasks
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Implements #1708 for GenAI conventions
gen_ai.systemtogen_ai.provider.namegen_aiprefix fromgen_ai.openai.*attributes.az.ai.*system names toazure.ai.*.Related: #608