Verteiltes Tracing in Umrissen: Spans, Eltern-Kennungen und W3C Trace Context

Worum es geht

Ein Trace zeichnet eine Anfrage auf, während sie mehrere Dienste durchläuft. Er ist ein Baum aus Spans. Die OpenTelemetry-Dokumentation zählt auf, was ein Span enthält: einen Namen, eine Eltern-Span-Kennung (leer beim Wurzel-Span), Start- und Endzeitstempel, einen Span-Kontext (Trace-Kennung und Span-Kennung), Attribute, Ereignisse, Links und einen Status. Jeder Span hat zudem eine Art (Client, Server, Internal, Producer oder Consumer), die dem Backend sagt, wie der Baum zusammenzusetzen ist: Der Elternteil eines Server-Spans ist oft ein entfernter Client-Span.

Der Baum entsteht nur, wenn die Kennungen Prozessgrenzen überschreiten. Die W3C-Empfehlung Trace Context definiert dafür den HTTP-Header traceparent: version-trace-id-parent-id-trace-flags, wobei die Trace-Kennung 32 hexadezimale Kleinbuchstaben umfasst (16 Byte), die Eltern-Kennung 16 Hexzeichen (die Span-Kennung des Aufrufers) und das Flag-Byte derzeit ein Bit trägt, sampled. Ein zweiter Header, tracestate, nimmt herstellerspezifische Daten auf. Die Empfehlung nennt zwei Stufen: Ein Werkzeug muss mindestens beide Header weiterreichen, damit Traces nicht abreissen, oder es kann teilnehmen, indem es einen eigenen Span erzeugt und die Eltern-Kennung neu schreibt. Die OpenTelemetry-Seite zur Context Propagation beschreibt denselben Mechanismus: Der Aufrufer übergibt Trace- und Span-Kennung, der Aufgerufene erzeugt einen Kind-Span mit dem Span des Aufrufers als Elternteil.

Warum es wichtig ist

Logs aus zehn Diensten beschreiben zehn getrennte Ereignisse; ein Trace zeigt, welche zu einer Anfrage gehören, in welcher Reihenfolge, und wo die Zeit blieb. Ohne Weitergabe beginnt jeder Dienst einen eigenen Wurzel-Span, und das Backend zeigt Bruchstücke, die sich nicht verbinden lassen.

So wird es angewendet

• Für jede eingehende Anfrage einen Server-Span, für jeden ausgehenden Aufruf, jede veröffentlichte Nachricht und jede Datenbankabfrage einen Client-Span erzeugen; Instrumentierungsbibliotheken der Frameworks tun das automatisch.
• Durch alles hindurch weitergeben, nicht nur über HTTP: traceparent in die Kopfzeilen von Nachrichten für Warteschlangen und in die Nutzlast von Hintergrundjobs legen und im Konsumenten wiederherstellen.
• Die Trace-Kennung in jede Logzeile der Anfrage schreiben, damit Logs und Traces sich verbinden lassen.
• Span-Namen mit wenigen Ausprägungen wählen (GET /users/{id}, nicht die konkrete Adresse); variable Teile in Attribute legen.
• Dienste ohne Tracing-SDK reichen traceparent und tracestate unverändert weiter.

Stolpersteine

An asynchronen Grenzen (Thread-Pools, Timer, gebündelte Schreiber) geht der Kontext verloren, wenn Bibliothek oder Code ihn nicht ausdrücklich mittragen. Das Flag sampled ist ein Hinweis des Aufrufers; eine Sampling-Entscheidung je Dienst erzeugt Traces mit fehlenden Spans. Uhrenabweichung zwischen Hosts kann einen Kind-Span vor seinem Elternteil beginnen lassen. Ein öffentlicher Rand sollte bewusst entscheiden, ob er einen von beliebigen Clients gelieferten Trace fortsetzt.