open-telemetry/sem-conv

Semantic conventions for OpenTelemetry PHP.

1.36.0 2025-08-04 03:22 UTC

Requires

• php: ^8.0

Apache-2.0

• opentelemetry-php contributors

• logging
• Metrics
• apm
• tracing
• opentelemetry
• otel
• semconv
• semantic conventions

README

OpenTelemetry Semantic Conventions

Common semantic conventions used by OpenTelemetry implementations across all languages.

Please note that Semantic Conventions are tagged with the version of the Semantic Conventions that they were generated from.

See https://opentelemetry.io/docs/concepts/semantic-conventions/.

Stability

Semantic conventions are separated into stable and incubating. Both are generated from the Semantic Conventions release with the same version as this package.

Instrumentation authors should use stable conventions where possible, but may use incubating conventions.

Deprecated conventions will be removed immediately from the next release after their deprecation, and there is no backwards compatibility guarantee for deprecated conventions.

Stable

Stable semantic conventions (OpenTelemetry\SemConv\Attributes\* and OpenTelemetry\SemConv\Metrics\*) are based on all elements marked as stable and are considered safe for use in production.

Incubating

Incubating semantic conventions (OpenTelemetry\SemConv\Incubating\*) contain both stable and experimental (in-development) elements. Experimental elements should be used with caution.

Installation

composer require open-telemetry/sem-conv

Contributing

This repository is a read-only git subtree split. To contribute, please see the main OpenTelemetry PHP monorepo.