위키득계정 ↗
기술

W3C Baggage

W3C Baggage기술
표준화 조직
W3C
전달 헤더
baggage
자료 형태
응용이 정의한 이름과 값
추적 규격과의 관계
독립적으로 사용 가능
W3C Baggage는 분산 요청이나 작업 흐름에 연결한 응용 프로그램의 속성을 전달하는 규격이다. baggage 헤더에 이름과 값으로 문맥을 담으며, 분산 추적의 사용 여부와 독립적으로 적용할 수 있다.

요청과 함께 이동하는 속성

서비스 하나에서 정한 요청 관련 문맥을 이후 호출에서도 활용해야 할 수 있다. Baggage는 이런 속성을 서비스 사이에서 전달할 공통 표현을 제공한다. 속성의 의미는 이를 사용하는 응용이 정한다.

추적 식별자와의 구분

Trace Context가 추적의 식별과 실행 관계를 이어 주는 데 초점을 둔다면 Baggage는 응용이 선택한 부가 문맥을 운반한다. 두 규격을 함께 사용할 수도 있지만 Baggage를 사용하기 위해 분산 추적이 반드시 필요한 것은 아니다.

전달 범위와 값의 관리

받은 속성을 다음 서비스로 전달할 때 값을 추가하거나 변경할 수 있다. 어떤 속성을 유지하고 어느 경계까지 보낼지는 서비스가 결정해야 한다. 같은 이름을 사용해도 의미가 저절로 통일되는 것은 아니므로 참여 서비스 사이의 약속이 필요하다.

관련 문서

W3C Trace Context / OpenTelemetry / Jaeger 분산 추적 / HTTP / CloudEvents / API