Logs & Observability
Fügen Sie einen traceparent-Header ein, um Version, Trace-ID, Parent-ID und Flags Feld für Feld zu sehen — oder wechseln Sie in den Batch- oder Generator-Modus.
Parsen und Generieren laufen vollständig im Browser. Nichts wird hochgeladen oder an ein Tracing-Backend gesendet.
Ein traceparent-Header sieht simpel aus – vier durch Bindestriche getrennte Felder – bis ein Microservice eine Trace-ID aus lauter Nullen loggt oder ein Proxy still und leise ein vom Standard verbotenes Versionsbyte einträgt. Dieser traceparent Parser prüft den Header gegen die tatsächliche W3C-Trace-Context-Grammatik, statt nur auf die Bindestriche zu schauen, damit Sie einen echten Fehler von einem bloß ungewohnten Header unterscheiden können.
Nutzen Sie ihn, wenn ein Trace zwischen zwei Diensten verschwindet und Sie wissen müssen, ob der Header selbst je gültig war, wenn Sie manuelle Header-Propagierung testen und dafür einen Beispiel-Header brauchen, oder wenn Sie beim Durchsehen von Logs gleich mehrere traceparent-Werte auf einmal statt einzeln prüfen wollen.
Gebaut, um echte Header-Fehler aufzuspüren — nicht nur, um einen ohnehin gültigen Header hübsch anzuzeigen.
Dieser traceparent Parser zerlegt einen Header in Version, Trace-ID, Parent-ID und trace-flags, jeweils in einer eigenen Farbe, plus eine verständliche Erklärung des Flags-Bytes (gesampelt oder nicht, und ob ein reserviertes Bit unerwartet gesetzt ist).
Version ff, eine Trace-ID aus lauter Nullen und eine Parent-ID aus lauter Nullen sehen alle wie gültiges Hex aus, sind laut W3C Trace Context aber ausdrücklich ungültig — dieser traceparent Parser benennt sie konkret, statt nur Länge und Zeichensatz zu prüfen.
Drei Dinge, die es sich zu wissen lohnt, bevor Sie einen Header aus den Produktions-Logs einfügen.
Das Parsen läuft automatisch 300ms nach dem letzten Tastendruck — kein Button nötig, außer die automatische Prüfung ist ausgeschaltet. Die drei Beispiel-Chips sind nicht zufällig gewählt: Sie laden einen gültigen Header, einen mit Version ff und einen mit einer Trace-ID aus lauter Nullen — genau die drei Grenzfälle, die der Standard namentlich nennt.
Das tracestate-Feld ist standardmäßig eingeklappt, da nicht jeder Header einen mitführt — aktivieren Sie es, um vendor=value-Paare gegen die Grenzwerte des Standards (32 Einträge, 256 Zeichen) zu prüfen. Prüfen Sie einen ganzen Log-Export statt eines einzelnen Headers, wechseln Sie in den Stapelmodus und fügen Sie einen traceparent pro Zeile ein.
Ein Header mit Version 00 wird vollständig geprüft; alles darüber wird decodiert, aber die überschüssigen Felder werden nur angezeigt, nie interpretiert. Kopieren und Herunterladen werden deaktiviert, sobald Sie die Eingabe ändern, damit nie versehentlich ein veraltetes Ergebnis exportiert wird.
Echte W3C-Trace-Context-Validierung, kein Regex, der nur die Position der Bindestriche prüft.
Version, Trace-ID, Parent-ID und trace-flags werden jeweils einzeln geparst und beschriftet, inklusive einer verständlichen Erklärung des Sampled-Bits.
So lässt sich eine einzelne Trace-ID validieren, ohne einen ganzen Tracing-Client einzubinden: Version ff, eine Trace-ID aus lauter Nullen, eine Parent-ID aus lauter Nullen, falsche Feldlängen und Großbuchstaben-Hex werden abgelehnt — genau die Fälle, die ein lockerer Regex meist durchwinkt.
Fügen Sie einen ganzen Log-Auszug mit traceparent-Werten ein und erhalten Sie eine Zählung gültig/ungültig/leer plus das genaue fehlerhafte Feld für jede fehlerhafte Zeile.
Prüft key=value-Einträge gegen den Zeichensatz des Standards, das tenant@vendor-Format, das 256-Zeichen-Limit pro Wert, die Obergrenze von 32 Einträgen und die Regel gegen doppelte Keys.
Erzeugt einen traceparent mit Version 00 sowie kryptografisch zufälligen, garantiert nicht-null Trace- und Parent-IDs, damit nie versehentlich mit einem ungültigen Platzhalter getestet wird.
Lesen Sie das, bevor Sie ein grünes Ergebnis mit einer gesunden Tracing-Pipeline gleichsetzen.
Echte Fragen, die beim Debuggen von W3C-Trace-Context-Headern auftauchen.
trace-flags ist ein einzelnes Byte, geschrieben als zwei Hex-Zeichen; Bit 0 ist das Sampled-Flag. 01 bedeutet, dass der Aufrufer empfiehlt, diese Trace vom Tracing-Backend aufzuzeichnen, 00 bedeutet das Gegenteil — es ist eine entlang der Aufrufkette weitergegebene Empfehlung, keine Garantie, dass irgendein System die Trace tatsächlich erfasst hat.
Die Trace-ID identifiziert die gesamte verteilte Trace eindeutig und wird von allen beteiligten Diensten geteilt. Die Span-ID (im W3C-Standard Parent-ID genannt) identifiziert einen einzelnen Abschnitt innerhalb dieser Kette und ändert sich meist bei jedem Dienst, während die Trace-ID gleich bleibt.
traceparent transportiert die vier Pflichtfelder — Version, Trace-ID, Parent-ID und trace-flags —, die jedes W3C-konforme System verstehen muss. tracestate ist optional und enthält herstellerspezifische key=value-Daten, die einzelne Tracing-Systeme anhängen können, ohne dass andere Systeme sie verstehen müssen.
Der W3C-Trace-Context-Standard reserviert ff, damit es niemals mit einer künftigen Versionsnummer verwechselt werden kann — sie ist ausdrücklich verboten, egal wie korrekt der restliche Header formatiert ist. Dieser Parser lehnt sie namentlich ab, statt sie wie eine beliebige zweistellige Hex-Version zu behandeln.
Eine Trace-ID aus lauter Nullen kann nichts identifizieren, deshalb verbietet der Standard sie ausdrücklich, obwohl „32 Nullen“ eine naive Hex-Formatprüfung besteht. Dieselbe Regel gilt für eine Parent-ID (Span-ID) aus lauter Nullen.
Parsen Sie ihn zuerst hier, um genau zu sehen, welches Feld fehlschlägt und warum. Die meisten realen Fehler entstehen, weil ein Proxy oder eine Logging-Pipeline den Header abschneidet, Großbuchstaben-Hex einmischt oder versehentlich einen Platzhalterwert wie lauter Nullen statt einer echt generierten ID weiterleitet.
Einen Header gefunden, den dieser Parser falsch bewertet?
Einen traceparent-Header parsen, mehrere davon prüfen oder einen frischen Test-Header generieren — alles im Browser, ohne Upload.
Als Lesezeichen speichern für das nächste Mal, wenn ein Trace zwischen zwei Diensten verschwindet.
Teil der Kategorie Developer Tools & DevOps auf HeyUtils.