Skip to content
Vol. I · No. 251
Mon · 8 Jun
A Daily Lexicon of Trustworthy Data
No. 251
251·03 · Metric TheaterNo. 251 · 8 Jun 2026 · 2 min

OpenTelemetry standardized the labels. The business meaning still lives outside the trace.

Common names are valuable. They are not the same as common accountability.

FiledThe EditorInstrumentation Is Not Governance

OpenTelemetry's semantic conventions do something practical and underrated: they give telemetry data a common naming scheme. That makes the trace readable. It does not make the business event agreed.

OpenTelemetry defines semantic conventions as common names and attributes for operations and data. The project describes them as span names, metric instruments and units, attribute names, types, meanings, and valid values used across traces, metrics, logs, profiles, and resources. This is controlled vocabulary work in production clothing.

The payoff is real. Shared names make telemetry easier to correlate across codebases, libraries, platforms, and teams. A database span, HTTP request, feature flag evaluation, or generative-AI call can carry standard attributes instead of each team inventing its own private dialect. That is how observability stops being a pile of local folklore.

The limit is just as real. Semantic conventions can say how to name an event. They cannot decide whether the event represents an order, a booking, a quote, a renewal, a fraud case, or a customer interaction the business has never reconciled. A trace can show the path of the undefined thing perfectly. It cannot make the thing defined.

Watch the handoff between engineering semantics and business semantics. If the instrumented event is tied to a controlled business term, the trace becomes evidence. If it is tied only to a local code name, the trace becomes beautifully organized ambiguity.

The takeaway

Telemetry conventions make systems speak consistently. Business definitions make the emitted facts worth trusting.

The claim, mapped
  1. OpenTelemetry semantic conventions define common names and attributes for operations and data so telemetry can use a shared naming scheme.

    supports0102
  2. The semantic conventions cover multiple telemetry signals, including traces, metrics, logs, profiles, and resources.

    supports0102
  3. Technical naming conventions improve correlation and consumption of telemetry, but they do not settle the business definition represented by an emitted event.

    context0102
Sources
01
OpenTelemetry — Semantic Conventions2025-09-28 · Tier 1 · primaryOpenTelemetry says semantic conventions specify common names for operations and data so naming can be standardized across codebases, libraries, and platforms.
02
OpenTelemetry — OpenTelemetry semantic conventions 1.41.12026-06-08 · Tier 1 · primaryThe specification describes semantic conventions for traces, metrics, logs, profiles, resources, and areas including databases, HTTP, feature flags, and generative AI.
Mark this entry
Marginalia · 0 notes

No notes yet. The margin is open.

Sign in to add a note. The margin is moderated — we keep it useful, not cruel.

Related entries
Definition Drift
It Took 31 Vendors To Agree On What Revenue Means

An industry consortium standardized the file format for metric definitions. The meeting where Finance and Sales disagree is still on your calendar.

Owner Missing
Moving Revenue Into A YAML File Does Not Give It An Owner

dbt open-sourced MetricFlow so agents query one definition. Whichever definition wins by default is now the one the robots inherit.

Dashboard Theater
The semantic layer is back to settle what a metric means. The metric is surprised anyone asked.

A define-once layer is an admission that the term was never defined.