3.8 KiB
3.8 KiB
title, source_type, status, related_branches, related_projects, tags, created, status_label, target_audience, inspiration_url, archive_url
| title | source_type | status | related_branches | related_projects | tags | created | status_label | target_audience | inspiration_url | archive_url | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| blog-topic / w3c-traceparent-fork-activated-seam | blog-topic | raw |
|
|
|
2026-07-02 | ready-for-canonical | backend-engineer |
blog-topic: w3c-traceparent-fork-activated-seam
Layer:
raw/blog-topics/— 작업 중 나온 블로그 글감 원석. 최종 블로그는 canonical 정제 후wiki/blog/에서 작성한다.
Parent / 부모
- raw/branch-notes/feature-distributed-tracing-contract — OTel SDK 미배선 상태에서 W3C traceparent contract를 먼저 둔 결정에서 나온 글감.
트리거 / Trigger
- 트리거 유형:
branch-work - 트리거 날짜: 2026-07-02
- 트리거 연결 노트: raw/branch-notes/feature-distributed-tracing-contract
글감 / Topic seed
- 한 문장 요지: OTel SDK를 붙이기 전에 W3C traceparent 계약을 먼저 두면 어떤 seam과 landmine이 생기는지 정리한다.
- 예상 제목 후보:
- OTel 없이 traceparent 계약부터 두면 생기는 일
- distributed tracing을 나중에 붙이기 위한 seam 설계
핵심 주장 후보 / Claim candidates
- 사실 후보:
- branch가 W3C traceparent 계약 타입, baggage allowlist, disabled fallback, fork-activated tracing seam, OTel SDK 미배선 경계를 정리한다 — 근거 후보: raw/branch-notes/feature-distributed-tracing-contract section+line
:106-112,:254-262,:319-322.
- branch가 W3C traceparent 계약 타입, baggage allowlist, disabled fallback, fork-activated tracing seam, OTel SDK 미배선 경계를 정리한다 — 근거 후보: raw/branch-notes/feature-distributed-tracing-contract section+line
- 경험 후보:
- 기존 async MDC 글감과 달리, 이 글감은 OTel SDK composition 전 sampled flag/meta traceId 불일치 같은 seam failure를 다룬다.
- 의견/해석 후보:
- tracing은 라이브러리를 붙이는 일이 아니라 trace context contract를 먼저 정하는 일일 수 있다.
Outline seed
- traceparent contract를 먼저 두는 이유 — propagation surface와 domain/application dependency를 분리한다.
- disabled fallback의 의미 — tracing이 꺼져도 contract가 사라지지 않게 한다.
- fork-activated seam의 landmine — OTel SDK가 들어올 때 sampled flag, baggage, meta traceId 정합을 다시 봐야 한다.
Canonical 전환 후보 / Canonical extraction candidates
wiki/projects/ca-tmpl/observability-log-metric-trace-runbook.md후보:- ca-tmpl tracing contract decision.
wiki/concepts/distributed-tracing-context-propagation.md후보:- W3C trace context와 baggage propagation 일반 개념.
- 필요한 추가 검증:
- W3C Trace Context official claim, OTel SDK integration 전후 behavior.
Sources / 근거 후보
- raw/branch-notes/feature-distributed-tracing-contract — tracing seam decision 근거.
- raw/blog-topics/spring-async-taskdecorator-bounded-executor-saturation-shutdown-2026-06-13 — 인접한 async/MDC context topic.
미해결 / Unknown
- 아직 확인해야 할 사실: OTel SDK가 실제로 배선된 이후의 behavior.
- 과장하면 안 되는 부분: end-to-end distributed tracing 구현 완료처럼 쓰지 않는다. seam과 contract 중심으로 제한한다.
- 블로그로 쓰기 전에 필요한 canonical 정제: W3C/OTel raw source claim 연결.
Decision / 처리 결정
- 액션:
promote-to-canonical - 이유:
wiki/projects/ca-tmpl/observability-log-metric-trace-runbook.md에 W3C traceparent seam 글감으로 반영했다. - 다음 단계: source canonical이
verified상태이므로 이후blogify대상으로 삼을 수 있다. 단 end-to-end distributed tracing 구현 완료처럼 쓰지 않는다.
Related / 관련
- 관련 branch: raw/branch-notes/feature-distributed-tracing-contract
- 관련 error:
- 관련 interview prep:
- derived blog: 생성 전. 생성 시
wiki/blog/w3c-traceparent-fork-activated-seam-YYYY-MM-DD.md후보