# OpenTelemetry Semantic-Convention v1.20 → v1.27 Attribut-Migrationstool Schreibt Span-/Log-Attributnamen über OpenTelemetry-Konventionsversionen um: http.method → http.request.method, http.status_code → http.response.status_code, http.url → url.full, db.system → db.system.name, messaging.destination → messaging.destination.name und 25+ weitere — angewendet auf eingefügten JS/TS/Python/Go/Java/.NET-Code, Collector-YAML oder Grafana-Dashboard-JSON, mit Collector-Rename-Map, Entfernungs-/Split-Warnungen, Diff-Statistik pro Attribut und Bericht nicht gemappter Attribute. > Kanonische Seite: https://elysiatools.com/de/tools/otel-semantic-convention-migration-tool - **Kategorie:** Development - **Schlagwörter:** opentelemetry migration, semantic conventions, semconv, otel attribute, http.method umbenennen, http.request.method, db.system.name, messaging.destination.name, span attribute, log attribute, otel collector transform, rename_attribute_actions, grafana dashboard otel, otel sdk upgrade, telemetrie refactoring, instrumentierung update ## Überblick Füge Code (beliebige Sprache), eine OTel-Collector-Konfiguration oder Grafana-Dashboard-JSON ein; wähle Quell- und Zielversion. Die Engine wendet die offiziellen nicht-normativen Migrationstabellen schichtweise an — v1.23.1 stabilisiert HTTP, v1.24 benennt die Datenbank-Attribute um, v1.27 schreibt Messaging um. Token-genaue Suche verhindert Teilimporte. Entfernte Attribute (http.target, net.sock.family, net.sock.peer.name) werden markiert statt umgeschrieben — http.target muss manuell in url.path und url.query aufgespalten werden. Ausgabe: umgeschriebene Quelle mit Diff-Zusammenfassung, Collector-Rename-Map, Dashboard-JSON-Synchronisation und übrig gebliebenen Alt-Attributen zur manuellen Prüfung. ## Eingaben - **Quellcode / Konfiguration / Dashboard-JSON** (textarea): span.setAttribute("http.method", req.method); ... or collector YAML, or Grafana dashboard JSON - **Von Version** (select) - **Nach Version** (select) - **Collector-Rename-Map generieren** (checkbox) - **Umbenennungen in JSON-Werten anwenden (Dashboards)** (checkbox) ## Wann verwenden - Beim Upgrade von OpenTelemetry-SDKs oder Instrumentierungs-Bibliotheken auf Versionen mit stabilisierten Semantic Conventions. - Zur automatischen Migration von Abfragen und Feldnamen in bestehenden Grafana-Dashboards auf neue Attributstandards. - Beim Erstellen von Rename-Maps für den OpenTelemetry Collector Processor zur Überbrückung von Versionsunterschieden in gemischten Umgebungen. ## Funktionsweise - Fügen Sie den Quellcode, die OpenTelemetry-Collector-Konfiguration oder das Grafana-Dashboard-JSON in das Eingabefeld ein. - Wählen Sie die Ausgangsversion (z. B. v1.20.0) und die Zielversion (v1.23.1, v1.24.0 oder v1.27.0) der Konventionen aus. - Aktivieren Sie bei Bedarf Optionen zur Erstellung von Collector-Transform-Maps oder zur Anpassung von JSON-Dashboard-Werten. - Prüfen Sie das Ergebnis mit Diff-Statistik, umgeschriebenem Code, Hinweisen zu entfernten Attributen (wie http.target) und generierten Collector-Regeln. ## Anwendungsfälle - Refactoring von benutzerdefiniertem Tracing-Code in Node.js, Python, Go, Java oder .NET auf moderne Semantic Conventions. - Aktualisierung von OpenTelemetry Collector YAML-Dateien für eine unterbrechungsfreie Telemetrie-Pipeline während SDK-Upgrades. - Massenaktualisierung veralteter Metrik- und Trace-Filter in exportierten Grafana-Dashboards. ## Häufig gestellte Fragen ### Warum werden Attribute wie http.target nicht automatisch umbenannt? Attribute wie http.target wurden entfernt und müssen in url.path sowie url.query aufgeteilt werden; das Tool markiert diese zur manuellen Überprüfung. ### Welche Änderungen werden in v1.23.1, v1.24.0 und v1.27.0 vorgenommen? v1.23.1 stabilisiert HTTP-Attribute (z. B. http.request.method), v1.24.0 überarbeitet Datenbank-Attribute (z. B. db.system.name) und v1.27.0 aktualisiert Messaging-Attribute. ### Verhindert das Tool versehentliche Teilersetzungen im Quellcode? Ja, der Abgleich erfolgt token-genau, sodass Teilbegriffe innerhalb anderer Variablen oder Strings nicht fehlerhaft ersetzt werden. ### Welche Ausgabe liefert die Collector-Rename-Map? Es wird eine YAML-Konfiguration für den OpenTelemetry Collector Transform Processor mit rename_key-Aktionen generiert. ### Können Grafana-Dashboards direkt migriert werden? Ja, bei aktivierter Dashboard-Option werden Attributschlüssel innerhalb von JSON-Strings und Panel-Abfragen auf die Zielversion umgeschrieben. ## Ähnliche Tools - [JSON-Schema-zu-Zod-Konverter](https://elysiatools.com/de/tools/json-schema-to-zod-schema-converter): Konvertiert JSON/YAML-Definitionen von JSON Schema in direkt nutzbaren Zod-Code fuer TypeScript-Projekte, inklusive verschachtelter Objekte, Arrays, Enums und gaengiger Validierungsregeln - [OpenAPI zu Postman Collection](https://elysiatools.com/de/tools/openapi-to-postman-collection): Wandelt eine OpenAPI-3.x- oder Swagger-2.0-Spec (JSON/YAML) in eine importierbare Postman Collection v2.1.0 mit Ordnern, Variablen, Auth und Beispielantworten. - [OpenAPI-zu-TypeScript-Generator](https://elysiatools.com/de/tools/openapi-to-typescript-generator): Konvertiert OpenAPI- oder Swagger-Spezifikationen in JSON/YAML in TypeScript-API-Typen, Anfrageparameter und Antwortmodelle mit konfigurierbarem Ausgabeformat und Namensstil - [Massen-E-Mail-Extraktor](https://elysiatools.com/de/tools/bulk-email-extractor): Extrahieren Sie alle E-Mail-Adressen aus Eingabetext, Artikeln, Web-Quellcode oder gemischtem Inhalt. Unterstützt Deduplizierung und Export nach JSON. - [CSV Transformator](https://elysiatools.com/de/tools/csv-transformer): CSV-Daten mit Spaltenoperationen, Berechnungen und Datentypkonvertierungen transformieren und verarbeiten. Operationsbeispiele: • Spalte umbenennen: \[{"type": "rename", "column": "alter_name", "new_name": "neuer_name"}\] • Berechnete Spalte hinzufügen: \[{"type": "add_column", "new_column": "gesamt", "formula": "preis * menge"}\] • Spalte entfernen: \[{"type": "remove_column", "remove_column": "zu_entfernende_spalte"}\] • Datentyp konvertieren: \[{"type": "convert_type", "convert_column": "alter", "target_type": "number"}\] • Werte berechnen: \[{"type": "calculate", "target_column": "gesamt", "expression": "preis * steuer + versand"}\] • Zeilen filtern: \[{"type": "filter_values", "filter_column": "status", "operator": "equals", "value": "aktiv"}\] - [JSON-Diff-Visualisierung](https://elysiatools.com/de/tools/json-diff-visualizer): Vergleicht zwei JSON-Dokumente und erzeugt einen visuellen Bericht mit Pfaden und Statistik - [JSONata-Abfrage- und Transformationsstudio](https://elysiatools.com/de/tools/jsonata-query-transform-studio): Vorschau fuer JSONata-aehnliche Abfragen und Transformationen, Vergleich mehrerer Payloads und Export als JSON, CSV, YAML oder Markdown. - [Konfigurationsformat-Bridge: TOML / INI / HCL / .env / Nix / dotenv / Kubernetes ConfigMap / Secret](https://elysiatools.com/de/tools/toml-ini-hcl-envfile-nix-dotenv-kubernetes-configmap-secret-config-format-bridge): Konvertiert Konfigurationen zwischen dotenv .env, TOML, INI, Java .properties, YAML, JSON, HCL (native Terraform/Vagrant-Syntax) und Nix-Attributmengen und erzeugt Kubernetes-ConfigMap-/Secret-Manifeste; erhält ${VAR}-/{{var}}-Platzhalter und envsubst-Interpolation, verfolgt die Herkunft der Typinferenz (string/int/float/bool/list), faltet HCL-Blocklabels zu verschachtelten Schlüsseln, und ein Round-Trip-Diff hebt nicht-äquivalente Einstellungen hervor (verlorene Schlüssel, Typänderungen, umgeschriebene Werte) — mit Kustomize-Patch-freundlichem YAML. ## Beispiele - [Distributed Tracing Beispiele](https://elysiatools.com/de/samples/distributed-tracing-samples): Umfassende Beispiele für verteiltes Tracing mit Jaeger, OpenTelemetry und modernen Observability Tools - [Parcel Bundling-Tool](https://elysiatools.com/de/samples/parcel): Parcel Null-Konfigurations-Bundler-Beispiele einschließlich Projekt-Setup, Plugins und erweiterter Konfiguration - [OpenAPI/Swagger Beispiele](https://elysiatools.com/de/samples/openapi-swagger): Umfassende API-Dokumentationsbeispiele mit OpenAPI 3.0 und Swagger-Spezifikationen für RESTful-Services - [pnpm Package Manager Beispiele](https://elysiatools.com/de/samples/pnpm): Schneller, platzsparender Paketmanager Beispiele inklusive Monorepo-Management, Workspace-Konfiguration, und fortgeschrittene Workflows ## Verwandte Inhalte - [Ein OpenTelemetry-Instrumentierungsupgrade verifizieren](https://elysiatools.com/de/hubs/opentelemetry-instrumentation-upgrade-verification): Alte Attribute erfassen, semantische Konventionen migrieren, Kontextweitergabe prüfen und einen echten Trace vor dem Release untersuchen.