dpdpdndn 블로그

FE-03-trace-join-verification

NEW2 min read

[FE-03] web↔BE trace 합류 E2E 검증

작업 내용 (설계 의도)

변경 사항

근거: design-fe-web.md “Testing Plan” · PRD Success Metrics(연결율 99%, 10건 중 9건+). FR-10.

web에서 시작한 요청이 BE와 하나의 trace로 합류하는지 실증한다.

  • 검증 스크립트/문서(web/scripts/ 또는 e2e): 임의 web 요청 10건 → Collector→Tempo에서 web span(service.name=sports-web) + BE span(sports-application)이 동일 trace_id로 조회되는지 확인. 9/10 이상 합류.
  • 장애 격리 확인: Collector 정지 상태에서도 web 요청이 정상 응답(export best-effort).
  • 결과를 design-fe-web.md 또는 검증 리포트에 기록(연결율·env 태그 일관성).

롤백: 검증 전용, 프로덕션 코드 무변경.

의존

  • FE-01 (OTel 등록), FE-02 (traceparent 전파)

다이어그램

처리 흐름

sequenceDiagram
    participant T as 테스트
    participant W as Next BFF
    participant Tempo as Tempo
    T->>W: 요청 10건
    W->>Tempo: web+BE span export
    T->>Tempo: trace_id 조회
    Tempo-->>T: 동일 trace 9건+ 확인

테스트 케이스

  • 임의 web 요청 10건 중 9건 이상이 web+BE span을 동일 trace로 포함한다(연결율 99% 기준).
  • Collector 정지 상태에서 web 요청이 정상 응답한다(장애 격리).
  • web span과 BE span이 동일 deployment.environment(env) 태그를 가진다.
  • traceparent 전파를 끄면(회귀) trace가 분리됨을 감지한다.

그래프 뷰