Skip to content

Conversation

@lmolkova
Copy link
Member

@lmolkova lmolkova commented Apr 2, 2025

Implements #1708 for GenAI conventions

  • Rename gen_ai.system to gen_ai.provider.name
  • Remove gen_ai prefix from gen_ai.openai.* attributes.
  • Rename az.ai.* system names to azure.ai.*.

Related: #608

@lmolkova lmolkova moved this from Awaiting SIG approval to Draft in Semantic Conventions Triage May 4, 2025
@lmolkova lmolkova force-pushed the gen-ai-align-naming branch 2 times, most recently from 1f761b7 to e365808 Compare May 7, 2025 20:28
@lmolkova lmolkova marked this pull request as ready for review May 7, 2025 20:28
@lmolkova lmolkova requested review from a team as code owners May 7, 2025 20:28
@lmolkova lmolkova moved this from Draft to Awaiting SIG approval in Semantic Conventions Triage May 7, 2025
@github-actions
Copy link

This PR was marked stale due to lack of activity. It will be closed in 7 days.

@github-actions github-actions bot added the Stale label May 24, 2025
@lmolkova lmolkova removed the Stale label May 26, 2025
@lmolkova lmolkova force-pushed the gen-ai-align-naming branch from ecaa58d to 4d99508 Compare May 30, 2025 16:03
@lmolkova lmolkova requested a review from Copilot July 1, 2025 05:45
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

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**.

@lmolkova lmolkova force-pushed the gen-ai-align-naming branch from 034fd5b to 2337a38 Compare July 5, 2025 16:37
@lmolkova lmolkova moved this from Awaiting SIG approval to Ready to be Merged in Semantic Conventions Triage Jul 5, 2025
@lmolkova lmolkova moved this from Ready to be Merged to Needs More Approval in Semantic Conventions Triage Jul 5, 2025
@lmolkova lmolkova moved this from Needs More Approval to Ready to be Merged in Semantic Conventions Triage Jul 8, 2025
@lmolkova lmolkova added this pull request to the merge queue Jul 8, 2025
Merged via the queue into open-telemetry:main with commit 8638e7b Jul 8, 2025
15 checks passed
@lmolkova lmolkova deleted the gen-ai-align-naming branch July 8, 2025 02:13
spurplewang pushed a commit to spurplewang/semantic-conventions that referenced this pull request Jul 10, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

Archived in project

Development

Successfully merging this pull request may close these issues.

6 participants