DataKit 추적 데이터 구조

개요¶

이 기사는 주류 Telemetry 플랫폼 데이터 구조와 DataKit 플랫폼 데이터 구조와의 매핑 관계를 설명하는 데 사용됩니다. 현재 지원되는 데이터 구조: DataDog/Jaeger/OpenTelemetry/SkyWalking/Zipkin/PinPoint

데이터 변환 단계:

1. 외부 추적 데이터 액세스는 여러 데이터 프로토콜을 통해 데이터를 수신한 후 데이터를 역직렬화합니다.
2. 역직렬화된 개체는 Line Protocol(라인 프로토콜 형식)로 변환됩니다.
3. 스팬 데이터 작업에는 샘플링, 필터링, 특정 태그 추가 및 기타 작업이 포함됩니다.

DataKit Point Protocol 데이터 구조¶

• Tags

• Field

span_type는 Trace에서 현재 Span의 상대 위치입니다. 그 값은 다음과 같이 설명됩니다.

• 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이 OTLP(OpenTelemetry Importer)에서 전송된 데이터를 수집할 때 간단한 원시 데이터는 다음과 같이 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 데이터 구조¶