[Observability] JOKA 로그 파이프라인 & Sentry 수집 전략 통합 설계

[mindaaaa]

기능 설명

• JOKA 전반의 로그 수집 전략을 통합 설계하고,
  Sentry 기반의 이벤트 필터링 / 계층 분리 / 환경별 정책 / 자동 분석 연계를 하나의 파이프라인으로 정리한다.

• 이 이슈는 단일 기능 구현이 아니라,
  아래 세부 이슈들을 묶는 상위 설계 이슈이다.

설계 범위

1) Logger 계층 정의 (expected / business / operational / bug)
2) Sentry 초기화 및 beforeSend 필터 전략
3) DEV / STAGING / PROD 환경별 전송 정책
4) Media 상태 전이 기반 핵심 품질 지표 로그
5) UX 품질(Business Impact) 로그
6) ErrorBoundary 및 전역 예외 연결
7) 5분 쿨다운 디듀프 전략
8) n8n → OpenAI 자동 분석을 위한 표준 이벤트 포맷

핵심 목표

- 무료 플랜 이벤트 한도 내에서 운영 가능
- 업로드 흐름(DRAFT → PREPARING → COMPLETE)을 핵심 품질 지표로 추적
- 400번대 개발 노이즈는 전송하지 않음
- 진짜 버그는 무조건 수집
- 자동화 가능한 구조로 설계

로그 계층 요약

expected

- 사용자 입력 오류, 400/401/403 등
- Sentry 전송 금지
- console만 사용

business

- UX 품질 저하 (2초 이상 지연 등)
- 10% 샘플링

operational

- 비즈니스 프로세스 단절
- allowlist 기반 전송

bug

- 상태 전이 위반, 계약 위반, unhandled exception
- 무조건 전송

환경별 최종 정책

DEV

- expected: 전송 금지
- business: 전송 금지
- operational: 전송 금지
- bug: 전송 금지 (기본)
  → 필요 시 bug만 허용 가능

PROD

- expected: 금지
- business: 10%
- operational: allowlist
- bug: 전송

완료 조건

• 위 세부 이슈들이 모두 완료되고 이 이슈에 연결되어 있다.
• layer 기반 필터 전략이 코드 레벨에서 적용되어 있다.
• DEV/STAGING/PROD 정책이 명확히 정의되어 있다.
• 업로드 상태 전이 관련 로그가 operational/bug로 구분되어 전송된다.
• 400번대 오류는 Sentry에 전송되지 않는다.
• 자동 분석을 위한 표준 payload 구조가 확정되어 있다.