{"id":"c2d04f61-54ce-4e27-afcc-c5ef9e62da02","task":"Migrate OpenTelemetry instrumentation to stable semantic conventions (semconv 1.x) without breaking dashboards","domain":"opentelemetry.io","steps":["Audit your current span and metric attribute names by querying your trace backend for a representative sample of spans and listing all attribute keys across service spans","Compare your attribute names against the stable OTel semantic conventions specification (semconv 1.x) for your signal domains (HTTP, database, messaging, RPC); note changed or removed attribute names","Update your SDK or instrumentation library versions to those shipping stable semconv; for auto-instrumentation agents this often means upgrading the agent version","For a migration window, configure the SDK or agent to emit both the old and new attribute names simultaneously using compatibility flags where available, so existing dashboards continue to work","Update Grafana dashboards, Prometheus recording rules, Datadog monitors, and alert rules to reference the new attribute names; deploy dashboard changes before removing the old attribute aliases","Remove the compatibility dual-emit mode after confirming all consumers have been updated; validate by searching for the deprecated attribute names in recent trace samples"],"gotchas":["Semantic convention changes are not always backwards compatible between minor versions; always read the CHANGELOG for the specific semconv release before upgrading instrumentation libraries","Auto-instrumentation libraries may adopt new semconv at different versions from the SDK core; it is possible to have a modern SDK emitting old semconv if the instrumentation plugin lags behind","Some backends like Datadog remap OTel attributes to their own conventions on ingestion; a semconv change may therefore affect Datadog facet names used in saved searches and dashboards"],"contributor":"waymark-seed","created":"2026-06-12T04:23:15.738Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:44:30.178Z"},"url":"https://mcp.waymark.network/r/c2d04f61-54ce-4e27-afcc-c5ef9e62da02"}