게스트측 네트워크 이슈 5주 분류
복구 로직 현황과 개선 방안
마지막 업데이트 2026-11-02
1. 결론
"게스트 네트워크 불안정" 경고에는 네트워크와 무관한 오탐이 대량으로 섞여 있다. 이를 빼면 실제 네트워크 신호는 회기의 39.9%, 수업이 실제로 끊긴 연결 단절은 8.6%다.
8,087회기 (아동 1,737명)
39.9%실제 네트워크 신호
8.6%연결 단절
70~90%끊김 중 2~3초 내 자동 복구
- 자동 재연결은 대부분 작동한다. 다만 재시도가 짧게 끝나고(소켓 5회, 송신 3회), 수신 경로와 AI 세션은 끊기면 복구 장치가 없다.
- 끊김 안내가 재진입을 키운다. 7초 끊기면 "나갔다 다시 들어와 주세요"와 새로고침 버튼을 띄워, 자동 복구 중에도 재진입을 유도한다.
- 우리 쪽 결함 2건: 진입 직후 오탐 경고(회기 20.3%), 활동 전환마다 송신 연결 재생성(회기 19%).
- 진행자 기록과 어긋난다. 진행자 "접속 이슈" 기록 302건 중 31%는 네트워크 신호가 없고, 로그상 실제 끊김 736회기 중 57%는 기록이 없다.
데이터: S3 prod/lesson-logs 게스트 세션로그 538,026파트. 회기 = (아동, 회차, KST 날짜), 페이지 로드 = 파일명의 instanceId.
2. 5주 분류 결과 (회기 기준)
한 회기가 여러 유형에 해당할 수 있다. 노란 행은 네트워크와 무관한 오탐이다.
| 유형 | 회기 | 비율 |
|---|---|---|
| X1 진입 직후 카메라 미확보로 "인터넷이 끊겼어요" 경고 | 1,642 | 20.3% |
X2 진입 직후 서버 응답 지연 (guest-step-update ack 미도달) | 4,637 | 57.3% |
| X3 대역폭 추정치만 낮음 (RTT·손실 정상) | 1,106 | 13.7% |
| A 연결 단절 (소켓·송신·AI 음성 끊김) | 698 | 8.6% |
| E 가정 인터넷 전체 다운 (외부·서버 모두 실패) | 256 | 3.2% |
| B 회선 품질 저하 (RTT ≥400ms 또는 손실 ≥5%) | 1,767 | 21.8% |
| D 수업 중 송신 정체 | 1,656 | 20.5% |
| F 우리 서버만 실패 (외부 정상) | 284 | 3.5% |
새로고침이 있었던 1,162회기 중 46%는 실제 네트워크 신호가 없었다. CX 리포트의 "고객 측 92%"는 X1 오탐이 섞인 경고 기준이라 근거로 쓰기 어렵다.
X2·D는 후속 분석에서 송신 정체가 아니라 서버 ack 무응답으로 재해석했다(527건 문서).
3. 자동 복구 현황
| 층 | 현재 동작 | 5주 복구율 | 한계 |
|---|---|---|---|
소켓 (socketSfu.ts) | 재연결 5회, 3~10초 간격 | 69% · 중앙 2.0초 | 5회 실패 후 복구 없음 |
영상 송신 (use-mediasoup-producer.ts) | transport 재생성 최대 3회 | 92% · 중앙 3.0초 | 3회 실패 시 새로고침 안내 |
AI 음성 (livekit-client-session.ts) | SDK 기본 재연결 | 68% · 중앙 2.4초 | 완전히 끊기면 AI 세션 재시작 없음 |
영상 수신 (use-mediasoup-consumer.ts) | transport not found일 때만 재생성 | — | 끊김 상태 변화에는 복구 없음 |
재진입까지 간 실제 끊김 273회기의 근거는 가정 회선 42% · 우리 서버 13% · 근거 없음 45%다. 복구 실패가 곧 가정 회선 탓은 아니다.
4. 우리 쪽 결함 2건
진입 직후 오탐 경고 (회기 20.3%)
페이지 진입 → 카메라·마이크 스트림 아직 null
→ 끊김으로 판정 use-guest-network-alert.ts:168
→ 7초 후 "인터넷이 끊겼어요" + 진행자 화면에 critical 경고
→ 스트림 획득 후 해소
카메라 critical 경고의 88%가 진입 15초 이내였다.
활동 전환마다 송신 연결 재생성 (회기 19%)
활동 전환 → AI 세션용 마이크 교체
→ 송신 연결 초기화 effect 재실행 → 기존 transport close
→ Failed to produce mic audio: AwaitQueueStoppedError use-mediasoup-producer.ts:881
→ 0.3~1.5초 뒤 재생성
진행자 쪽에서 아이 영상·음성이 매번 잠깐 끊긴다. effect를 다시 실행시키는 의존값은 특정하지 못했다(후보: socket.connected·joinGeneration·rtpCapabilities).
5. 진행자 기록 대조
- 진행자 "접속 + 이슈" 기록 302건: 실제 끊김 37%, 네트워크 신호 없음 31%. 75%가 재진입 수업이다.
- 로그상 실제 끊김 736회기: 57%는 연결 이슈 기록이 없다. 짧게 끊기고 자동 복구된 경우로 보인다.
진행자 노트 원문 기준 527건 대조는 527건 문서에 있다.
6. 개선 우선순위
- 진입 직후 오탐 제거: 스트림 미획득은 끊김에서 제외, 입장 확인 전 ack 미판정 (
use-guest-network-alert.ts:168) - 활동 전환 송신 연결 재생성 수정 (
use-mediasoup-producer.ts초기화 effect) - 순단 자동 복구 강화: 끊김 안내를 새로고침 대신 제자리 재연결로, 소켓 재시도 상한 제거, 수신 경로 복구 추가, AI 세션 자동 재시작
- 회선 불량 시 품질 하향: 카메라 일시 중지·음성 우선
- 서버 경로 조사: 같은 시각 여러 아동의 서버 실패 대조, TCP·TURN(443) 폴백 확인
가정 회선 자체는 우리가 고칠 수 없다. 목표는 끊김을 없애는 게 아니라 짧은 끊김을 사람 개입 없이 복구하는 것이다.
7. 한계
- 외부·서버 접속 확인 주기가 10초라, 끊김 원인 구간을 일부 회기만 판정할 수 있다.
- 복구 로그 없는 끊김이 끝내 복구되지 않은 것인지, 복구 중 아이가 나간 것인지는 구분되지 않는다.
- 진행자 측·서버(Loki)·LogRocket 로그와는 교차하지 않았다.