このドキュメントでは、トレースとスパンの概要を説明します。トレースは、単一のエンドツーエンドのオペレーションを表します。トレースはスパンで構成されています。これは、単一の関数またはオペレーションの記録です。
トレース データモデル
トレースには次のプロパティがあります。
トレース ID: エンドツーエンドのオペレーションの固有識別子。トレース ID は、エンドツーエンドのオペレーションの一部としてコンテキストとして伝播する必要があります。
トレース ID に同じ値を共有するスパンのコレクション。
Cloud Trace は、トレース ID を使用して、リポジトリ内のどのスパンが同じトレースに関連付けられているかを特定します。
スパン データモデル
スパンは、有限のゼロ以外の期間にわたって行われたオペレーションに対応します。次のリストは、各スパンで保存される重要なプロパティの一部です。
- Trace ID: この特定のオペレーション全体が行われたエンドツーエンドのオペレーションの識別子。
- スパン ID: スパンの固有識別子。単一のオペレーション全体のフルフィルメントで同じオペレーションが複数回呼び出されると、トレースに同じ名前のスパンが複数含まれている場合があります。ただし、各スパンには異なるスパン ID があります。
- 親スパン ID: このスパンを呼び出したオペレーションを特定します。「ルート」スパンには
null
に設定されている親スパン ID があります。 - 名前: 実行されたオペレーションの名前。
- 開始時間: オペレーションの開始時間。
- 終了時間: オペレーションの終了時間。
スパンには、Key-Value ペアを使用してオペレーションに関する追加情報を格納する属性を含めることもできます。Cloud Trace では、可能であれば OpenTelemetry Semantic Conventions を使用することをおすすめします。
リソース
OpenTelemetry リソース:
次のステップ
- コンテキストとコンテキストの伝播について学習する。
- サンプリングについて学習する。