トレースとスパン

このドキュメントでは、トレースとスパンの概要を説明します。トレースは、単一のエンドツーエンドのオペレーションを表します。トレースはスパンで構成されています。これは、単一の関数またはオペレーションの記録です。

トレース データモデル

トレースには次のプロパティがあります。

  • トレース ID: エンドツーエンドのオペレーションの固有識別子。トレース ID は、エンドツーエンドのオペレーションの一部としてコンテキストとして伝播する必要があります。

  • トレース ID に同じ値を共有するスパンのコレクション。

    Cloud Trace は、トレース ID を使用して、リポジトリ内のどのスパンが同じトレースに関連付けられているかを特定します。

スパン データモデル

スパンは、有限のゼロ以外の期間にわたって行われたオペレーションに対応します。次のリストは、各スパンで保存される重要なプロパティの一部です。

  • Trace ID: この特定のオペレーション全体が行われたエンドツーエンドのオペレーションの識別子。
  • スパン ID: スパンの固有識別子。単一のオペレーション全体のフルフィルメントで同じオペレーションが複数回呼び出されると、トレースに同じ名前のスパンが複数含まれている場合があります。ただし、各スパンには異なるスパン ID があります。
  • 親スパン ID: このスパンを呼び出したオペレーションを特定します。「ルート」スパンには null に設定されている親スパン ID があります。
  • 名前: 実行されたオペレーションの名前。
  • 開始時間: オペレーションの開始時間。
  • 終了時間: オペレーションの終了時間。

スパンには、Key-Value ペアを使用してオペレーションに関する追加情報を格納する属性を含めることもできます。Cloud Trace では、可能であれば OpenTelemetry Semantic Conventions を使用することをおすすめします。

リソース

OpenTelemetry リソース:

次のステップ