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

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

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

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

당일 반영된 PPI 변경사항

GitHub develop merged PR 기준 · 총 3건. 병합 시각만으로 배포 완료를 단정하지 않습니다.

#1310 [PPI-1451] fix: 장치 획득 대기 중 네트워크 끊김 오탐 방지

charles-na · 2026-11-12 15:18 KST

변경 기능
아동 입장/재접속 · 진행자 모니터링 — 장치 획득 대기 상태를 네트워크 레벨 판정에 전달하고, 진행자 카메라는 최초 수신 전 영상 단절 오탐을 보류
영향받을 수 있는 사용자 흐름
게스트 입장 직후 카메라·마이크 권한/장치 준비, 진행자 모니터링에서 카메라 스트림 최초 수신 전 구간
개선 기대
장치 준비 중 스트림이 없다는 이유로 위험 네트워크 경고가 뜨는 오탐 감소; 소켓 장애 감지는 유지
회귀 위험
장치 대기 상태가 잘못 유지되면 실제 영상·음성 단절 경고가 늦어질 수 있고, 진행자 화면의 최초 수신 지연이 실제 장애와 구분되지 않을 수 있음
확인할 로그·지표
게스트/진행자 네트워크 위험 경고율, 장치 획득 실패 후 8초 내 위험 전환, 대기 중 소켓 장애 탐지
관련 테스트
network-alert.test.tsx 18개 통과(PR 기재); 실기기 검증은 확인 필요
당일 이슈 관련 가능성
당일 finalize 수업 로그가 0건이라 직접 대조 불가. 네트워크 경고는 본 보고서 기술이슈 후보 제외 기준이며 원인 연결 금지
배포 상태
병합 시각은 확인했으나 운영 배포 시각 확인 필요 — 미배포 가능성, 당일 이슈 원인으로 연결 금지

주요 변경 파일: apps/web/entities/guest-page-session/model/use-guest-page-session.ts · apps/web/hooks/network-alert.test.tsx · apps/web/hooks/use-guest-network-alert.ts · apps/web/hooks/use-monitor-network-level.ts

#1311 [PPI-1421] feat: 핑퐁 응답 중 조각 발화 차단(HC)과 VP 관측 재적용

bulbanggae · 2026-11-12 17:12 KST

변경 기능
AI 세션/음성 인식 · LiveKit/WebRTC — HC 응답 중 무음 처리된 조각 발화의 중복 응답을 차단하고 VP는 관측 로그만 기록; 안전한 대화 맥락 정리 추가
영향받을 수 있는 사용자 흐름
아동이 핑퐁 응답 재생 중 말해 조각 턴이 생기는 대화, Realtime provider 맥락 동기화, voice_pipeline 발화 판정
개선 기대
짧게 들린 조각 발화에 핑퐁이 두 번 답하는 현상 억제; 진행 중 응답이나 다음 발화를 provider 맥락에서 잘못 삭제하는 위험 완화
회귀 위험
가드 오판 시 유효한 아동 발화 응답이 차단될 수 있고, 정리 대기/lock 또는 provider 맥락 검사 실패 시 맥락 정리가 건너뛰어질 수 있음
확인할 로그·지표
response_overlap_decision 사유·pipeline_mode, dropped_response_overlap_muted 빈도, response_overlap_cleanup outcome(skipped_unsafe_resync/skipped_session_closed), 다음 응답 자연스러움
관련 테스트
livekit-agent pytest 694개, env/runtime 38개 통과(PR 기재); 수정된 cleanup의 staging 배포 후 확인 필요
당일 이슈 관련 가능성
당일 finalize 수업 로그가 0건이라 logger 이벤트와 직접 대조 불가. 코드상 response_overlap_decision/dropped_response_overlap_muted/response_overlap_cleanup이 직접 관측 포인트
배포 상태
일부 선행 코드의 staging 검증은 PR에 기재됐으나 cleanup 수정과 운영 배포 시각은 확인 필요 — 미배포 가능성, 당일 이슈 원인으로 연결 금지

주요 변경 파일: apps/livekit-agent/agent.py · apps/livekit-agent/lifecycle_trace.py · apps/livekit-agent/response_overlap_guard.py · apps/livekit-agent/tests/test_response_overlap_guard.py · apps/livekit-agent/tests/test_response_overlap_integration.py · 외 3개

#1312 [PPI-1421] feat: 핑퐁 겹침 판정 로그에 턴 길이·들린 길이 추가

bulbanggae · 2026-11-12 17:39 KST

변경 기능
AI 세션/음성 인식 — response_overlap_decision 운영 로그에 turn_ms와 heard_ms를 추가하고 허용 목록·변이 테스트를 보강
영향받을 수 있는 사용자 흐름
HC/VP 발화 겹침 판정의 운영 관측과 사후 분석; 응답 차단·정리 동작 자체는 변경 없음
개선 기대
무음 구간 사이 실제로 들린 발화 길이와 전체 턴 길이를 확인해 겹침 판정의 타당성을 정량 검증 가능
회귀 위험
동작 회귀 위험은 낮지만 필드 계산 또는 로그 허용 목록 오류 시 지표가 누락·왜곡될 수 있음
확인할 로그·지표
CloudWatch response_overlap_decision의 정수 turn_ms/heard_ms, HC block에서 heard_ms < 1000 및 muted_ms >= heard_ms 조건
관련 테스트
livekit-agent pytest 699개, env/runtime 38개, 관련 mutation test 통과(PR 기재)
당일 이슈 관련 가능성
당일 finalize 수업 로그가 0건이라 직접 대조 불가. 코드 logger prefix response_overlap_decision과 신규 필드가 직접 일치하는 관측 지점
배포 상태
운영 배포 시각 확인 필요 — 미배포 가능성, 당일 이슈 원인으로 연결 금지

주요 변경 파일: apps/livekit-agent/lifecycle_trace.py · apps/livekit-agent/response_overlap_guard.py · apps/livekit-agent/tests/test_lifecycle_trace.py · apps/livekit-agent/tests/test_response_overlap_guard.py · apps/livekit-agent/tests/test_response_overlap_mutes.py · 외 3개