OpenTelemetry GenAI Semantic Conventions

Semantic Conventions for Generative AI (GenAI), including spans, metrics, and events for GenAI clients, MCP (Model Context Protocol), and provider-specific conventions (OpenAI, etc.).

This repository extends the OpenTelemetry Semantic Conventions with GenAI-specific conventions, using Weaver to manage dependencies on the core semantic conventions.

Schema URL

TODO

Read the docs

The human-readable version of the semantic conventions resides in the docs folder. Major parts of these Markdown documents are generated from the YAML definitions located in the model folder.

Reference implementations and their tooling live under reference. For the Python reference compliance matrix and per-signal support reports, see reference/README.md. For contribution guidance specific to that project, see reference/CONTRIBUTING.md.

Contributing

See CONTRIBUTING.md.