Skip to content

⚙️[기능추가][Debug] 테스트 빌드용 SSE 서버 로그 스트리밍 엔드포인트 추가 #607

@Cassiiopeia

Description

@Cassiiopeia

📝 현재 문제점

  • 테스트 빌드(APK/TestFlight)에서 서버 로그를 확인하려면 별도로 서버에 접속해야 함
  • 앱 내에서 실시간 서버 로그를 바로 확인할 수 없어 디버깅 효율이 떨어짐
  • 프론트에서 테스트 빌드 시 플로팅 디버그 버튼을 통해 서버 로그를 실시간으로 확인하고자 함

🛠️ 해결 방안 / 제안 기능

  • SSE(Server-Sent Events) 기반의 서버 로그 실시간 스트리밍 API 엔드포인트 추가
  • @SecuredApi (HMAC-SHA256 + Timestamp) 보안 검증 적용 — 기존 버전 동기화 API와 동일한 방식
  • 전체 애플리케이션 로그(DEBUG/INFO/WARN/ERROR) 스트리밍
  • 5분 자동 타임아웃 (클라이언트 미종료 시 서버 리소스 보호)
  • 클라이언트 연결 종료 시 즉시 정리

⚙️ 작업 내용

  • Logback 커스텀 Appender 구현 (로그 이벤트를 SSE 구독자에게 발행)
  • SSE 구독자 관리 및 5분 타임아웃 처리
  • GET /api/app/debug/log-stream 엔드포인트 생성
  • @SecuredApi 적용 및 SecurityUrls.SECURED_API_URLS에 등록
  • Swagger 문서화 (DebugControllerDocs)

🙋‍♂️ 담당자

Metadata

Metadata

Assignees

Labels

작업전작업 시작 전 준비 상태

Type

No type

Projects

Status

작업전

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions