semantic-conventions/docs
Liudmila Molkova ee299e5c42
Add prototyping requirement for significant changes (#2502)
Co-authored-by: Armin Ruech <7052238+arminru@users.noreply.github.com>
2025-07-14 15:13:25 +00:00
..
app Move Attributes Registry to Registry / Attributes (#2251) 2025-05-15 01:58:45 +00:00
azure Change `azure_` and `az.` to `azure.` across all conventions (#1698) 2025-06-24 15:44:05 +00:00
browser Add Browser Web Vitals Event (#1940) 2025-04-08 23:03:52 +00:00
cicd Create Entities Registry (#2278) 2025-06-30 20:20:24 +00:00
cli Move Attributes Registry to Registry / Attributes (#2251) 2025-05-15 01:58:45 +00:00
cloud-providers Move Attributes Registry to Registry / Attributes (#2251) 2025-05-15 01:58:45 +00:00
cloudevents Move Attributes Registry to Registry / Attributes (#2251) 2025-05-15 01:58:45 +00:00
code Move Attributes Registry to Registry / Attributes (#2251) 2025-05-15 01:58:45 +00:00
database Add database context propagation via `SET CONTEXT_INFO` for SQL Server (#2363) 2025-07-01 05:15:50 +00:00
dns [chore] Update spec repo links to v1.46.0 (#2359) 2025-06-12 20:08:50 +00:00
dotnet Add .NET network + HTTP connection spans (#1192) 2025-06-19 23:52:00 +00:00
exceptions [chore] Update spec repo links to v1.46.0 (#2359) 2025-06-12 20:08:50 +00:00
faas [chore] Update link title #2410 (#2411) 2025-06-26 16:35:48 +00:00
feature-flags [chore] Update spec repo links to v1.46.0 (#2359) 2025-06-12 20:08:50 +00:00
gen-ai Update GenAI conventions based on system-specific naming guidance (#2046) 2025-07-08 02:12:02 +00:00
general Add prototyping requirement for significant changes (#2502) 2025-07-14 15:13:25 +00:00
graphql Move Attributes Registry to Registry / Attributes (#2251) 2025-05-15 01:58:45 +00:00
hardware [chore] Update link title #2410 (#2411) 2025-06-26 16:35:48 +00:00
http Replace confusing URI origin with more specific guidance (#2463) 2025-07-08 18:27:08 +00:00
messaging [chore] Explicitly set the SQS link title #2351 (#2369) 2025-06-16 16:35:41 +00:00
mobile Move Attributes Registry to Registry / Attributes (#2251) 2025-05-15 01:58:45 +00:00
non-normative Add {k8s.node, k8s.pod, container}.filesystem. metrics (#2392) 2025-07-14 12:04:05 +00:00
object-stores Move Attributes Registry to Registry / Attributes (#2251) 2025-05-15 01:58:45 +00:00
otel Replace otel.sdk.span.ended metric with improved span.started metric (#2431) 2025-07-02 15:49:39 +00:00
registry [chore] Remove quotes from values (#2500) 2025-07-09 18:28:12 +00:00
resource Add the 'deprecated:' attribute to the recently deprecated 'z_os' enum value (#2479) 2025-07-04 22:30:31 +00:00
rpc [chore] Update spec repo links to v1.46.0 (#2359) 2025-06-12 20:08:50 +00:00
runtime [chore] Update spec repo links to v1.46.0 (#2359) 2025-06-12 20:08:50 +00:00
system Add {k8s.node, k8s.pod, container}.filesystem. metrics (#2392) 2025-07-14 12:04:05 +00:00
url Move Attributes Registry to Registry / Attributes (#2251) 2025-05-15 01:58:45 +00:00
README.md Move Attributes Registry to Registry / Attributes (#2251) 2025-05-15 01:58:45 +00:00

README.md

OpenTelemetry semantic conventions

The Semantic Conventions define a common set of (semantic) attributes which provide meaning to data when collecting, producing and consuming it. The Semantic Conventions specify among other things span names and kind, metric instruments and units as well as attribute names, types, meaning and valid values. For a detailed definition of the Semantic Conventions' scope see Semantic Conventions Stability. The benefit to using Semantic Conventions is in following a common naming scheme that can be standardized across a codebase, libraries, and platforms. This allows easier correlation and consumption of data.

Semantic Conventions are defined for the following areas:

  • General: General Semantic Conventions.
  • CICD: Semantic Conventions for CICD systems.
  • Code: Semantic Conventions for code.
  • Cloud Providers: Semantic Conventions for cloud providers libraries.
  • CloudEvents: Semantic Conventions for the CloudEvents specification.
  • Database: Semantic Conventions for database operations.
  • Exceptions: Semantic Conventions for exceptions.
  • FaaS: Semantic Conventions for Function as a Service (FaaS) operations.
  • Feature Flags: Semantic Conventions for feature flag evaluations.
  • Generative AI: Semantic Conventions for generative AI (LLM, etc.) operations.
  • GraphQL: Semantic Conventions for GraphQL implementations.
  • HTTP: Semantic Conventions for HTTP client and server operations.
  • Messaging: Semantic Conventions for messaging operations and systems.
  • Object Stores: Semantic Conventions for object stores operations.
  • RPC: Semantic Conventions for RPC client and server operations.
  • System: System Semantic Conventions.

Semantic Conventions by signals:

  • Events: Semantic Conventions for event data.
  • Logs: Semantic Conventions for logs data.
  • Metrics: Semantic Conventions for metrics.
  • Profiles: Semantic Conventions for profiles.
  • Resource: Semantic Conventions for resources.
  • Trace: Semantic Conventions for traces and spans.

Also see, Non-normative supplementary information.