Traces und Spans

Dieses Dokument bietet eine Einführung in Traces und Spans. Ein trace stellt einen einzelnen End-to-End-Vorgang dar. Traces bestehen aus Spans, die Datensätze für eine einzelne Funktion oder einen einzelnen Vorgang sind.

Trace-Datenmodell

Ein Trace hat folgende Eigenschaften:

  • Trace-ID: Die eindeutige Kennung des End-to-End-Vorgangs. Die Trace-ID muss als Kontext im Rahmen des End-to-End-Vorgangs weitergegeben werden.

  • Eine Sammlung von Spans, die denselben Wert für die Trace-ID haben.

    Cloud Trace verwendet die Trace-ID, um zu ermitteln, welche Spans in seinem Repository mit demselben Trace verknüpft sind.

Span-Datenmodell

Ein Bereich entspricht einem Vorgang, der über einen begrenzten Zeitraum ungleich null ausgeführt wurde. Im Folgenden sind einige wichtige Attribute aufgeführt, die von jedem Span gespeichert werden:

  • Trace-ID: Die Kennung des End-to-End-Vorgangs, in dem dieser bestimmte Gesamtvorgang stattgefunden hat.
  • Span-ID: Die eindeutige Kennung für den Span. Wenn bei der Ausführung eines einzelnen Gesamtvorgangs mehrmals derselbe Vorgang aufgerufen wird, kann ein Trace mehrere Spans mit demselben Namen enthalten. Jeder Span hat jedoch eine eigene Span-ID.
  • ID des übergeordneten Spans: Gibt den Vorgang an, der diesen Span aufgerufen hat. Für den Haupt-Span ist die ID des übergeordneten Spans auf null festgelegt.
  • Name: Der Name des ausgeführten Vorgangs.
  • Startzeit: Die Startzeit des Vorgangs.
  • Ende: Das Ende des Vorgangs.

Spans können auch Attribute enthalten, die mithilfe von Schlüssel/Wert-Paaren zusätzliche Informationen zu einem Vorgang speichern. Cloud Trace empfiehlt, nach Möglichkeit die OpenTelemetry Semantic Conventions zu verwenden.

Ressourcen

OpenTelemetry-Ressourcen:

Nächste Schritte