OpenTelemetry Semantic Conventions (definition/2)

IDE language support for OpenTelemetry Weaver semantic-convention YAML files that declare file_format: definition/2 (schema).

Navigate and validate a semantic-convention registry the same way you would a codebase — jump to where an attribute is defined, find everywhere it's used, and catch broken references as you type.

Unofficial. This is an unofficial project and is not endorsed by the OpenTelemetry project.

Built for registries authored with Weaver, such as semantic-conventions-genai.

Features

• Go to Definition — jump from a ref to the entity that defines that id.
• Find All References — from any id to every place it is referenced.
• Hover — an entity's details, or a schema field/enum value's description and allowed values, straight from the official schema.
• Diagnostics — unresolved references and duplicate definitions flagged inline.
• Outline & symbol search — per-file outline plus "Go to Symbol in Workspace" across the whole registry.

What links to what

Files are recognized by content, not by file name: definition files declare file_format: definition/2, and a registry manifest is identified by its schema_url (with no file_format). The extension indexes every definition file in your workspace folder, so navigation works across the whole registry; manifest files get field hover and dependency diagnostics.

Requirements

• VS Code 1.96 or newer.
• A workspace folder containing definition/2 semantic-convention YAML files.

Installation

• Marketplace: search for OTel SemConv in the Extensions view and install.
• From a .vsix: download the package, then run Extensions: Install from VSIX… from the Command Palette.

No configuration is required — open a folder with semantic-convention files and the features above work automatically on YAML files.

Settings

Limitations

Not yet supported: completion in ref:, rename, document symbols, cross-registry resolution, and the legacy definition/1 (groups:) format.

Contributing

Bug reports and contributions are welcome — see CONTRIBUTING.md for the development setup, architecture, and tests.