DataKit トレースのデータ構造

概要¶

この記事は、主流の Telemetry プラットフォームのデータ構造と、DataKit プラットフォームのデータ構造とのマッピング関係を説明するために使用されます。 現在サポートされているデータ構造: DataDog/Jaeger/OpenTelemetry/SkyWalking/Zipkin/PinPoint

データ変換手順:

1. 外部トレース データ アクセス。複数のデータ プロトコルを通じてデータを受信した後、データを逆シリアル化します。
2. 逆シリアル化されたオブジェクトは、Line Protocol (ラインプロトコル形式) に変換されます。
3. スパンデータ操作には、サンプリング、フィルタリング、特定のタグの追加、その他の操作が含まれます。

DataKit Point Protocol のデータ構造¶

• Tags

• Field

span_type は、トレース内の現在のスパンの相対位置です。その値は次のように説明されます。

• entry: 現在の API は入り口であり、トレースがサービスに入った後の最初の呼び出しです。
• local: 現在の API は、開始後終了前の API です。
• exit: 現在の API は、トレースに対するサービスの最後の呼び出しです
• unknown: 現在の API の相対位置ステータスが不明です

priority クライアントの優先順位ルールの例:

• PRIORITY_USER_REJECT = -1 ユーザーは報告を拒否することを選択しました
• PRIORITY_AUTO_REJECT = 0 クライアント サンプラーはレポートの拒否を選択しました
• PRIORITY_AUTO_KEEP = 1 クライアント サンプラー選択レポート
• PRIORITY_USER_KEEP = 2 ユーザーがレポートを選択しました

OpenTelemetry Tracing のデータ構造¶

DataKit が OpenTelemetry Exporter (OTLP) から送信されたデータを収集すると、単純な生データが次のように JSON を通じてシリアル化されます。

resource_spans:{
    resource:{
        attributes:{key:"message.type"  value:{string_value:"message-name"}}
        attributes:{key:"service.name"  value:{string_value:"test-name"}}
    }
    instrumentation_library_spans:{instrumentation_library:{name:"test-tracer"}
    spans:{
        trace_id:"\x94<\xdf\x00zx\x82\xe7Wy\xfe\x93\xab\x19\x95a"
        span_id:".\xbd\x06c\x10ɫ*"
        parent_span_id:"\xa7*\x80Z#\xbeL\xf6"
        name:"Sample-0"
        kind:SPAN_KIND_INTERNAL
        start_time_unix_nano:1644312397453313100
        end_time_unix_nano:1644312398464865900
        status:{}
    }
    spans:{
           ...
        }
}

OpenTelemetry における resource_spans と DKProto の対応関係は次のとおりです。

OpenTelemetry には独自のフィールドがいくつかありますが、DKProto にはそれらに対応するフィールドがないため、ラベルに配置されます。これらの値は、次のように 0 以外の場合にのみ表示されます。

Jaeger Tracing のデータ構造¶

Jaeger Thrift Protocol の Batch データ構造¶

Jaeger Thrift Protocol の Span データ構造¶

SkyWalking Tracing Data のデータ構造¶

Segment Object Generated By Protobuf Protocol V3¶

Segment Object 内の SkyWalking Span Object のデータ構造¶

Zipkin Tracing Data のデータ構造¶

Zipkin Thrift Protocol の Span V1 データ構造¶

Zipkin Span V2 のデータ構造¶