# <img src="https://opentelemetry.io/img/logos/opentelemetry-logo-nav.png" alt="OpenTelemetry Icon" width="45" height=""> OpenTelemetry Semantic Conventions

[![Checks](https://github.com/open-telemetry/semantic-conventions/workflows/Checks/badge.svg)](https://github.com/open-telemetry/semantic-conventions/actions?query=workflow%3A%22Checks%22+branch%3Amain)
[![GitHub tag (latest SemVer)](https://img.shields.io/github/tag/open-telemetry/semantic-conventions.svg?logo=opentelemetry&&color=f5a800&label=Latest%20release)](https://github.com/open-telemetry/semantic-conventions/releases/latest)
[![Specification Version](https://img.shields.io/badge/OTel_specification_version-v1.49.0-blue?logo=opentelemetry&color=f5a800)](https://github.com/open-telemetry/opentelemetry-specification/releases/tag/v1.49.0)

Semantic Conventions define a common set of (semantic) attributes which
provide meaning to data when collecting, producing and consuming it.

## Read the docs

The human-readable version of the semantic conventions resides in the [docs](docs/README.md) folder.
Major parts of these Markdown documents are generated from the YAML definitions located in the [model](model/README.md) folder.

## Roadmap

For an overview of the current focus areas and active initiatives
the Semantic Conventions project is committed to, check out the
[OpenTelemetry Roadmap](https://github.com/orgs/open-telemetry/projects/158/views/1?filterQuery=sig%3A%22Semantic+Conventions%3A+*%22).

> [!IMPORTANT]
> Due to limited maintainer and reviewer bandwidth, priority is given to initiatives
> listed in the roadmap. Contributions outside these areas may be delayed or
> not accepted unless they are formally added to the roadmap through the
> established project proposal process.

## Areas and Special Interest Groups

See: [Areas](AREAS.md)

## Contributing

See [CONTRIBUTING.md](CONTRIBUTING.md)

### Maintainers

- [Alexander Wert](https://github.com/AlexanderWert), Elastic
- [Armin Ruech](https://github.com/arminru), Dynatrace
- [Joao Grassi](https://github.com/joaopgrassi), Dynatrace
- [Josh Suereth](https://github.com/jsuereth), Google
- [Liudmila Molkova](https://github.com/lmolkova), Grafana Labs
- [Trask Stalnaker](https://github.com/trask), Microsoft

For more information about the maintainer role, see the [community repository](https://github.com/open-telemetry/community/blob/main/guides/contributor/membership.md#maintainer).

### Approvers

- [Alexandra Konrad](https://github.com/trisch-me), Elastic
- [Daniel Dyla](https://github.com/dyladan), Dynatrace
- [Ted Young](https://github.com/tedsuo), Lightstep

For more information about the approver role, see the [community repository](https://github.com/open-telemetry/community/blob/main/guides/contributor/membership.md#approver).

### Emeritus Maintainers

- [Johannes Tax](https://github.com/pyohannes)
- [Reiley Yang](https://github.com/reyang)

For more information about the emeritus role, see the [community repository](https://github.com/open-telemetry/community/blob/main/guides/contributor/membership.md#emeritus-maintainerapprovertriager).

### Emeritus Approvers

- [Christian Neumüller](https://github.com/Oberon00)
- [James Moessis](https://github.com/jamesmoessis)
- [Sean Marciniak](https://github.com/MovieStoreGuy)

For more information about the emeritus role, see the [community repository](https://github.com/open-telemetry/community/blob/main/guides/contributor/membership.md#emeritus-maintainerapprovertriager).