분산 추적 데이터 수집¶
Guance의 분산 추적 데이터 수집은 현재 Opentracing 프로토콜을 사용하는 수집기를 지원합니다. DataKit에서 분산 추적 데이터 수신 서비스를 활성화한 후, 코드 내 수집기 계측을 완료하면 DataKit이 자동으로 데이터 형식 변환 및 수집을 수행하여 최종적으로 Guance에 보고합니다.
데이터 수집¶
DataKit은 현재 DDTrace, Apache Jaeger, OpenTelemetry, Skywalking, Zipkin 등 타사 Tracing 데이터 수집을 지원합니다.
수집 전제 조건¶
-
모든 분산 추적 데이터 수집 관련 수집기 구성
수집기 구성¶
필드 설명¶
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이 원격 호출과 관련이 없으며, 로컬 메서드 호출 시 생성된 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 데이터 구조를 참조하십시오.