추적 문맥 전파는 서비스가 다음 서비스에 요청을 보낼 때 추적 ID와 부모 스팬 정보를 함께 넘기는 과정입니다. 이 연결이 있어야 각 서비스가 기록한 스팬을 하나의 요청으로 묶을 수 있습니다.
데모에서는 같은 ID가 게이트웨이, API, DB를 차례로 통과합니다. 중간 프록시나 비동기 작업에서 문맥이 빠지면 추적이 여러 조각으로 끊어집니다.
언제 쓰나
서비스 간 호출이 하나의 분산 추적으로 이어지도록 계측할 때 사용합니다.
추적 문맥 전파
Trace context propagation
서비스 경계를 넘어 같은 추적 ID와 부모 정보를 전달합니다.
···
<div class="demo"><div class="title">TRACE ID: 7F3A</div><div class="scene"><div class="nodes"><div>gateway</div><span>→</span><div>api</div><span>→</span><div>database</div></div><div class="packet">7F3A</div></div></div>.demo{width:min(94vw,690px);height:min(88vh,320px);box-sizing:border-box;padding:clamp(9px,2.5vmin,18px);border:1px solid var(--line);border-radius:14px;background:var(--surface);color:var(--fg);font:600 clamp(12px,2.4vmin,16px)/1.25 var(--font-sans,"Pretendard Variable",Pretendard,-apple-system,BlinkMacSystemFont,sans-serif);display:flex;flex-direction:column;gap:clamp(7px,2vmin,14px);overflow:hidden}.title{color:var(--accent);font:700 clamp(12px,2.4vmin,16px)/1.2 var(--font-sans,"Pretendard Variable",Pretendard,-apple-system,BlinkMacSystemFont,sans-serif);letter-spacing:.04em}.scene{flex:1;min-height:0;position:relative;display:flex;align-items:center;justify-content:center;overflow:hidden}.nodes{width:100%;display:flex;justify-content:space-around;align-items:center;gap:3px}.nodes div{border:1px solid var(--line);border-radius:7px;padding:9px 5px;text-align:center;min-width:0;flex:1}.nodes span{color:var(--accent)}.packet{position:absolute;top:62%;left:4%;background:var(--accent);color:var(--bg);border-radius:5px;padding:4px 8px;font:700 clamp(12px,2.4vmin,15px)/1 ui-monospace,monospace;animation:travel 3s linear infinite}@keyframes travel{0%{left:4%;opacity:0}10%,85%{opacity:1}100%{left:78%;opacity:0}}