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, also Einträgen für eine einzelne Funktion oder einen einzelnen Vorgang.

Trace-Datenmodell

Ein Trace hat die folgenden Eigenschaften:

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

  • Eine Sammlung von Spans mit demselben Wert für die Trace-ID.

    In Cloud Trace wird anhand der Trace-ID ermittelt, welche Spans im Repository demselben Trace zugeordnet sind.

Span-Datenmodell

Ein Zeitraum entspricht einem Vorgang, der über einen bestimmten, aber nicht nullwertigen Zeitraum stattgefunden hat. Im Folgenden sind einige wichtige Eigenschaften aufgeführt, die in jeder 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 derselbe Vorgang bei der Ausführung eines einzelnen Gesamtvorgangs mehrmals aufgerufen wird, kann ein Trace mehrere Spans mit demselben Namen enthalten. Jede Span hat jedoch eine eindeutige Span-ID.
  • Übergeordnete Span-ID: Identifiziert den Vorgang, durch den diese Span aufgerufen wurde. Für die Span „root“ ist die übergeordnete Span-ID auf null festgelegt.
  • Name: Der Name des ausgeführten Vorgangs.
  • Startzeit: Die Startzeit des Vorgangs.
  • Endzeit: Die Endzeit des Vorgangs.

Spans können auch Attribute enthalten, in denen zusätzliche Informationen zu einem Vorgang mithilfe von Schlüssel/Wert-Paaren gespeichert werden. Cloud Trace empfiehlt, nach Möglichkeit die OpenTelemetry-semantischen Konventionen zu verwenden.

Ressourcen

OpenTelemetry-Ressourcen:

Nächste Schritte