semantic-conventions/docs
Liudmila Molkova 0268189395
Make db.operation.name required where it's available, clarify what to do with multiple layers (#2200)
Co-authored-by: Trask Stalnaker <trask.stalnaker@gmail.com>
2025-04-30 17:19:49 +00:00
..
attributes-registry [k8s] Introduce semantic conventions for k8s DaemonSet labels and annotations (#2170) 2025-04-30 16:15:28 +00:00
azure Add warning about body fields being moved to complex attributes in the future (#2029) 2025-03-28 15:33:12 -07:00
browser Add Browser Web Vitals Event (#1940) 2025-04-08 23:03:52 +00:00
cicd Add bare minimum Entity Association capabilities - Apply to System + Process semconv (#2123) 2025-04-28 16:28:37 +00:00
cli Add span rendering template and clean up span briefs and notes (#1505) 2025-04-09 09:32:28 -07:00
cloud-providers Add span rendering template and clean up span briefs and notes (#1505) 2025-04-09 09:32:28 -07:00
cloudevents Update stability levels from experimental -> development (#1889) 2025-02-11 18:06:51 -08:00
code mark code.* attributes as stable (#2102) 2025-04-17 00:31:02 +00:00
database Make db.operation.name required where it's available, clarify what to do with multiple layers (#2200) 2025-04-30 17:19:49 +00:00
dns Add bare minimum Entity Association capabilities - Apply to System + Process semconv (#2123) 2025-04-28 16:28:37 +00:00
dotnet Add bare minimum Entity Association capabilities - Apply to System + Process semconv (#2123) 2025-04-28 16:28:37 +00:00
exceptions [chore] Update spec repo links to v1.44.0 (#2118) 2025-04-15 22:19:29 +00:00
faas Add bare minimum Entity Association capabilities - Apply to System + Process semconv (#2123) 2025-04-28 16:28:37 +00:00
feature-flags [chore] Update spec repo links to v1.44.0 (#2118) 2025-04-15 22:19:29 +00:00
gen-ai Add bare minimum Entity Association capabilities - Apply to System + Process semconv (#2123) 2025-04-28 16:28:37 +00:00
general Provide guidance on modeling lat/lon, x/y, etc (#2145) 2025-04-28 15:20:41 +00:00
graphql Add span rendering template and clean up span briefs and notes (#1505) 2025-04-09 09:32:28 -07:00
hardware Add bare minimum Entity Association capabilities - Apply to System + Process semconv (#2123) 2025-04-28 16:28:37 +00:00
http Move key names from template attribute examples to notes (#2175) 2025-04-29 18:39:20 +00:00
messaging Add bare minimum Entity Association capabilities - Apply to System + Process semconv (#2123) 2025-04-28 16:28:37 +00:00
mobile Rework device events (#1880) 2025-02-18 10:04:31 -08:00
non-normative [chore] Fix stray sentence fragment (#2198) 2025-04-29 19:28:38 +00:00
object-stores Add span rendering template and clean up span briefs and notes (#1505) 2025-04-09 09:32:28 -07:00
otel Add bare minimum Entity Association capabilities - Apply to System + Process semconv (#2123) 2025-04-28 16:28:37 +00:00
resource [k8s] Introduce semantic conventions for k8s DaemonSet labels and annotations (#2170) 2025-04-30 16:15:28 +00:00
rpc Move key names from template attribute examples to notes (#2175) 2025-04-29 18:39:20 +00:00
runtime Add bare minimum Entity Association capabilities - Apply to System + Process semconv (#2123) 2025-04-28 16:28:37 +00:00
system Add bare minimum Entity Association capabilities - Apply to System + Process semconv (#2123) 2025-04-28 16:28:37 +00:00
url Update stability levels from experimental -> development (#1889) 2025-02-11 18:06:51 -08:00
README.md [chore] docs: add Profiles to README (#2011) 2025-03-25 12:34:56 +01: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.