콘텐츠로 이동

분산 추적 데이터 수집


Guance의 분산 추적 데이터 수집은 현재 Opentracing 프로토콜 기반 수집기를 지원합니다. DataKit에서 분산 추적 데이터 수신 서비스를 활성화한 후 코드에 수집기 계측을 완료하면 DataKit가 자동으로 데이터 형식 변환과 수집을 수행하고, 최종적으로 Guance에 보고합니다.

데이터 수집

DataKit는 현재 DDTrace, Apache Jaeger, OpenTelemetry, Skywalking, Zipkin 등 타사 Tracing 데이터 수집을 지원합니다.

새로운 APM 연동에는 Beacon 사용을 우선 권장합니다. DataKit의 OpenTelemetry 수집기를 통해 분산 추적 데이터를 수신할 수 있습니다.

수집 사전 요구 사항

  1. DataKit 설치;

  2. 모든 분산 추적 데이터 수집 관련 수집기를 설정합니다.

수집기 설정

필드 설명

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, unknow
  • entry 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 데이터 구조를 참조하세요.

    문서 평가

    이 페이지가 도움이 되었나요?