분산 추적 데이터 수집¶
Guance의 분산 추적 데이터 수집은 현재 Opentracing 프로토콜 기반 수집기를 지원합니다. DataKit에서 분산 추적 데이터 수신 서비스를 활성화한 후 코드에 수집기 계측을 완료하면 DataKit가 자동으로 데이터 형식 변환과 수집을 수행하고, 최종적으로 Guance에 보고합니다.
데이터 수집¶
DataKit는 현재 DDTrace, Apache Jaeger, OpenTelemetry, Skywalking, Zipkin 등 타사 Tracing 데이터 수집을 지원합니다.
새로운 APM 연동에는 Beacon 사용을 우선 권장합니다. DataKit의 OpenTelemetry 수집기를 통해 분산 추적 데이터를 수신할 수 있습니다.
수집 사전 요구 사항¶
-
모든 분산 추적 데이터 수집 관련 수집기를 설정합니다.
수집기 설정¶
필드 설명¶
DataKit는 수집기에 따라 보고된 데이터를 Guance 분산 추적 데이터 형식으로 변환하며 태그와 메트릭을 유지합니다. 다음은 자주 사용되는 필드에 대한 설명입니다:
| 필드명 | 설명 |
|---|---|
host |
호스트 이름, 기본값은 글로벌 태그 |
source |
분산 추적의 출처입니다. Zipkin으로 수집한 경우 값은 zipkin, Jaeger로 수집한 경우 값은 jaeger가 되며, 이와 같은 방식으로 계속됩니다. |
service |
서비스 이름입니다. 이 태그를 통해 해당 분산 추적 데이터를 생성하는 비즈니스 시스템의 이름을 지정하는 것을 권장합니다. |
parent_id |
현재 span의 이전 span ID |
operation |
현재 span의 작업 이름이며, Span 이름으로 이해할 수도 있습니다. |
span_id |
현재 span의 고유 ID |
trace_id |
현재 분산 추적의 고유 ID를 나타냅니다. |
span_type |
Span 유형입니다. 현재 지원되는 유형: entry, local, exit, unknowentry span은 서비스 진입 시 생성되는 span으로, 해당 서비스가 다른 서비스에 호출 요청을 제공하는 엔드포인트입니다. 대부분의 span은 entry span이어야 합니다. span이 entry 유형인 호출만 독립적인 요청입니다.local span은 원격 호출과 관계가 없는 span으로, 로컬 메서드 호출 시 생성됩니다. 예를 들어 일반적인 Java 메서드가 있습니다.exit span은 서비스를 떠날 때 생성되는 span입니다. 예를 들어 원격 호출을 시작하거나 메시지 큐에서 메시지를 생성할 때입니다.unknow span은 알 수 없는 Span을 의미합니다. |
endpoint |
요청 대상 주소입니다. 클라이언트가 대상 서비스를 액세스하는 데 사용하는 네트워크 주소로, 예: 127.0.0.1:8080, 기본값: null |
message |
분산 추적 변환 전에 수집된 원시 데이터 |
duration |
현재 분산 추적 span의 지속 시간 |
status |
분산 추적 상태입니다. info: 정보, warning: 경고, error: 오류, critical: 심각, ok: 성공 |
env |
분산 추적이 속한 환경입니다. 예를 들어 dev는 개발 환경, prod는 프로덕션 환경을 나타낼 수 있으며, 사용자가 직접 정의할 수 있습니다. |
더 많은 필드 목록은 DataKit Tracing 데이터 구조를 참조하세요.