위키득계정 ↗
기술

W3C Trace Context

W3C Trace Context기술
표준화 조직
W3C
전달 수단
HTTP 헤더
공통 추적 정보
traceparent
확장 정보
tracestate
W3C Trace Context는 여러 서비스를 거치는 요청의 추적 문맥을 HTTP 헤더로 전달하는 규격이다. 서로 다른 추적 도구를 쓰더라도 같은 요청의 실행 관계를 이어서 파악할 수 있도록 공통 표현을 정한다.

서비스 경계를 넘는 추적

하나의 요청이 다른 서비스를 호출하면 실행 기록도 여러 곳에 나뉜다. 호출과 함께 추적 식별 정보를 전달하면 각 서비스에서 남긴 기록을 같은 흐름에 연결할 수 있다.

두 헤더의 역할

traceparent는 추적 안에서 들어오는 요청의 위치를 나타내는 공통 정보를 담는다. tracestate는 추적 제공자별 추가 정보를 전달하는 선택적인 이름과 값의 목록이다. 공통 형식과 제공자별 확장을 나누어 도구 사이의 연계를 지원한다.

전달과 참여

서비스는 받은 추적 문맥을 다음 호출로 전달하거나 자신의 실행에 맞게 갱신하며 추적에 참여한다. 중간 서비스에서 문맥이 끊기면 앞뒤 실행을 연결하기 어려워지므로 두 헤더를 함께 처리하는 것이 중요하다.

관련 문서

OpenTelemetry / Jaeger 분산 추적 / Dapper 분산 추적 / HTTP / gRPC / W3C Baggage