83 lines
3.8 KiB
Markdown
83 lines
3.8 KiB
Markdown
---
|
|
title: blog-topic / w3c-traceparent-fork-activated-seam
|
|
source_type: blog-topic
|
|
status: raw
|
|
related_branches: [feature-distributed-tracing-contract]
|
|
related_projects: [ca-tmpl]
|
|
tags: [blog-topic, ca-tmpl, observability, opentelemetry, trace-status, span-event]
|
|
created: 2026-07-02
|
|
status_label: ready-for-canonical
|
|
target_audience: backend-engineer
|
|
inspiration_url:
|
|
archive_url:
|
|
---
|
|
|
|
# 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`.
|
|
- 경험 후보:
|
|
- 기존 async MDC 글감과 달리, 이 글감은 OTel SDK composition 전 sampled flag/meta traceId 불일치 같은 seam failure를 다룬다.
|
|
- 의견/해석 후보:
|
|
- tracing은 라이브러리를 붙이는 일이 아니라 trace context contract를 먼저 정하는 일일 수 있다.
|
|
|
|
## Outline seed
|
|
|
|
1. traceparent contract를 먼저 두는 이유 — propagation surface와 domain/application dependency를 분리한다.
|
|
2. disabled fallback의 의미 — tracing이 꺼져도 contract가 사라지지 않게 한다.
|
|
3. 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` 후보
|