2026-11-13 수업 로그 기술이슈 확인 대상

마지막 업데이트 2026-11-13

S3 수업 세션 로그 기반 · 테스트/내부 계정 및 force kick, 네트워크 경고, TURN_ANALYSIS, 진단성 미디어 경고 제외

0분석 세션
0기술이슈 후보
0정상
force kick / 네트워크 / TURN_ANALYSIS / 진단성 미디어 경고제외 기준
0긴급
0확인
목표는 원인 설명을 길게 쓰는 것이 아니라, 운영자가 바로 확인해야 할 아동 세션을 고르는 것입니다. 아래 목록은 아동명, 회기, 핵심 이슈, 원본 시그니처를 함께 보여줍니다.

당일 반영된 PPI 변경사항

git log origin/develop fallback 기준 · 총 1건. 병합 시각만으로 배포 완료를 단정하지 않습니다.

#1298 [PPI-1392] feat: 녹취를 Go recorder로 옮긴다

bulbanggae (러셀) · 2026-11-13 17:40:14 KST

변경 기능
수업 진행/완료/저장 · LiveKit/WebRTC · 배포/인프라 — mediasoup socket의 녹취 부하를 별도 Go recorder로 분리하고 UDP RTP 수신, gRPC 제어, active-active 처리, S3 산출물·원본 업로드, 로그 outbox를 추가
영향받을 수 있는 사용자 흐름
아동·AI 음성 producer 생성 → socket이 PlainTransport/RTP와 녹취 ID를 구성 → recorder 2대가 수신하고 한 노드가 finalize → mp3·captions·원본을 S3에 저장 → 웹 목록·삭제 API가 recorder 원본까지 정리하는 흐름
개선 기대
socket의 ffmpeg·녹취 부하를 분리해 수업 signaling 안정성과 장애 격리를 높이고, 노드 이중화·재허락·재입장 인계 및 roomId/recordingId 연계 로그로 복구와 추적을 개선할 것으로 기대
회귀 위험
recorder/SSM/UDP/gRPC 연결 또는 active-active finalizer 선택 실패 시 녹취 시작·종료·업로드 누락 가능. ffmpeg 5.1 타임라인 보정, Redis outbox, 재접속 인계, 웹 원본 삭제가 새 회귀 지점이며 prod 전환은 운영 설정과 별도 배포에 의존
확인할 로그·지표
recording start/stop/finalize 결과, roomId+recordingId 로그, recorder gRPC 상태, REC_* 오류 코드, outbox backlog·sweeper, RTP packet/drop·disk 지표, mp3/captions/source S3 생성률과 녹취 삭제 실패율
관련 테스트
recorder Go unit/integration/e2e·race/vet, socket recorder/legacy/shadow·HA fault·outbox·reentry 테스트, web session-log 삭제 테스트, 배포/환경 계약 테스트. PR 설명상 scripts 100개·Python 23개·Terraform 19개와 dev 실제 업로드·삭제 확인
당일 이슈 관련 가능성
당일 finalize 아카이브가 0건이고 미병합 272건이지만, 수업 로그 자체가 없어 이 PR과 직접 일치하는 logger prefix·이벤트·상태 전이를 대조할 수 없음. 병합 시각만으로 원인 연결 금지
배포 상태
미배포 가능성 — 17:40 KST develop 병합만 확인. prod recorder는 release workflow, SSM 키·IAM·노드 rollout 및 RECORDING_MODE 설정이 필요하므로 당일 이슈 원인으로 연결 금지

주요 변경 파일: apps/recorder/internal/session/manager.go · apps/socket/src/recording/recorderBackend.ts · apps/socket/src/recording/recordingService.ts · apps/web/app/api/session-logs/route.ts · .github/workflows/deploy-recorder-prod.yml · 외 274개