Managed Service for OpenTelemetry:Terms

スパン間の関係

OpenTracing は、スパン間の 2 種類のリファレンスを定義しています。

• ChildOf: 親子関係。たとえば、スパン C はスパン A の子ノードです。

• FollowsFrom: シーケンシャルな関係。たとえば、スパン G はスパン F の後に呼び出されます。

次の図は、単一のトレース内の 8 つのスパンとその関係を示しています。

Causal relationships among spans in a single trace


        [Span A]  <-- root span
            |
     +------+------+
     |             |
 [Span B]      [Span C]   (ChildOf: Span C is a child of Span A)
     |             |
 [Span D]      +---+-------+
               |           |
           [Span E]    [Span F] >>> [Span G] >>> [Span H]
                                       ^
                                       |
                         (FollowsFrom: Span G follows Span F)

同じトレースをタイムラインとして表示したものです。

Time relationships among spans in a single trace


--|-------|-------|-------|-------|-------|-------|-------|-> time

 [Span A..........................................................]
   [Span B...................................................]
      [Span D................................................]
    [Span C...............................................]
         [Span E.......]        [Span F..] [Span G..] [Span H..]

スパンの作成

StartSpan メソッドを使用して、新しいスパンを作成および開始します。このメソッドは、指定された操作名とオプションを持つスパンを返します。

// Method signature:
// StartSpan(operationName string, opts ...StartSpanOption) Span

// Create a root span (no parent).
sp := tracer.StartSpan("GetFeed")

// Create a child span.
sp := tracer.StartSpan(
    "GetFeed",
    opentracing.ChildOf(parentSpan.Context()),
)

サービス間でのコンテキストの伝播

サービス間でトレースコンテキストを渡すために、Tracer は 2 つの補完的なメソッドを提供します。

1. Inject: SpanContext (トレース ID、スパン ID、およびバゲージ項目を含む) を、別のサービスにリクエストを送信する前に、キャリア (HTTP ヘッダーなど) にシリアル化します。

      // Method signature:
      // Inject(sm SpanContext, format interface{}, carrier interface{}) error
   
      carrier := opentracing.HTTPHeadersCarrier(httpReq.Header)
      err := tracer.Inject(
          span.Context(),
          opentracing.HTTPHeaders,
          carrier,
      )

2. Extract: 別のサービスからリクエストを受信したときに、キャリアから SpanContext (トレース ID、スパン ID、およびバゲージ項目を含む) を逆シリアル化します。

      // Method signature:
      // Extract(format interface{}, carrier interface{}) (SpanContext, error)
   
      carrier := opentracing.HTTPHeadersCarrier(httpReq.Header)
      clientContext, err := tracer.Extract(
          opentracing.HTTPHeaders,
          carrier,
      )

Inject と Extract は連携して、プロセスおよびネットワーク境界を越えたエンドツーエンドのトレーシングを可能にします。

直接レポート

アプリケーションは、ミドルウェアなしでトレースデータをトレーシングバックエンドに直接送信します。

エージェントを介したレポート

アプリケーションは、トレースデータをローカルエージェント (Jaeger Agent など) に送信し、ローカルエージェントがデータをトレーシングバックエンドに転送します。