수업 중 게스트 카메라·마이크·소리 끊김 진단 로깅 추가 가이드

공통 mediaDiagnosticLogger 유틸 추가

브라우저 로그는 현재 human-readable이라 LogRocket에서 검색은 가능하지만 구조화 분석이 어렵다. logger.info("MEDIA_DIAG", payload) 형태를 표준화하고, payload는 JSON-safe flat schema로 통일한다.

{
  event: "producer_stats",
  roomId, peerId, socketId,
  role: "guest" | "host",
  streamType: "camera-video" | "mic-audio" | "ai-audio",
  transportId, producerId, consumerId,
  connectionState, iceConnectionState,
  ts: Date.now(),
  seq
}

게스트 Producer outbound stats

use-mediasoup-producer.ts의 기존 1초 guest-transport-state 루프에 producer별 stats delta를 추가한다. video는 framesEncoded, qualityLimitationReason, audio는 audioLevel/totalAudioEnergy/bytesSent/packetsSent를 수집한다.

판정 예:
- mic track live + packetsSent 증가 + host inbound 0 → SFU/Consumer 경로 의심
- mic track muted/onended + packetsSent 정체 → 장치/브라우저 track 문제
- RTT/packetLoss 악화 + all streams 정체 → 네트워크 후보

진행자 Consumer inbound stats

use-mediasoup-consumer.ts에서 consumer 생성 직후 consumer.id, producerId, streamType을 저장하고, 1~2초 주기로 inbound stats를 streamType별로 남긴다.

audio: packetsReceived, bytesReceived, packetsLost, jitter,
       audioLevel, totalAudioEnergy, concealedSamples
video: framesDecoded, framesDropped, freezeCount,
       totalFreezesDuration, frameWidth/Height

서버 SFU lifecycle 구조화

ProducerManager/ConsumerManager/TransportManager 로그에 appData.type, producerPeerId, direction, close reason, dtls/ice selected tuple을 추가한다. 현재는 created/closed 중심이라 원인 분류가 어렵다.

logger.info("SFU_MEDIA_LIFECYCLE", {
  action: "producer_created", roomId, peerId,
  transportId, producerId, kind, streamType: appData?.type
});

AI audio element 재생 검증

use-ai-session.ts:1117-1133의 audioEl.play().catch(() => {})는 실제 무음 원인을 숨긴다. play promise resolve/reject, currentTime 증가, playing/waiting/stalled/error, sinkId 지원 여부를 남긴다.

event: "ai_audio_playback_probe"
fields: playResolved, playErrorName, currentTime,
        paused, muted, volume, sinkIdSupported,
        requestedOutputDeviceId, visibilityState

게스트 장치/권한/트랙 이벤트

use-guest-media-manager.ts:333-367와 V2 로컬 미디어 hook에 getUserMedia 전후 로그를 추가한다. 장치 라벨은 권한 후에만 보일 수 있으므로 permission state 변화와 함께 남긴다.

device_snapshot: audioInputs/videoInputs count,
selectedDeviceId hash, groupId hash, label hash,
constraints, track.getSettings(), permission state,
track.onmute/onunmute/onended timestamp

Socket.io 연결 원인 세분화

socketSfu.ts:31-74에 이미 reconnect 로그가 있으나 room/peer 맥락이 없다. join 이후에는 socket wrapper가 roomId, peerId, role을 보유해 disconnect/reconnect/connect_error에 같이 찍히도록 한다.

disconnect reason, transport name, previous transport,
reconnect attempt, ping latency, navigator.onLine,
effectiveType/downlink/rtt(지원 브라우저만)

호스트 UI element playback probe

Consumer track이 도착한 뒤 video/audio element가 실제 렌더링·가청 상태인지 남긴다. 진행자가 “소리 안 들림”을 신고할 때 Consumer stats는 정상인데 element만 muted/paused일 수 있다.

video: readyState, paused, videoWidth/Height,
       requestVideoFrameCallback delta
host audio: HTMLAudioElement 상태 또는 WebAudio RMS,
            output device/sink 상태

클라이언트 LogRocket용

MEDIA_DIAG device_snapshot
MEDIA_DIAG get_user_media_result
MEDIA_DIAG track_state_change
MEDIA_DIAG sfu_transport_state
MEDIA_DIAG producer_lifecycle
MEDIA_DIAG producer_stats
MEDIA_DIAG consumer_lifecycle
MEDIA_DIAG consumer_stats
MEDIA_DIAG element_playback_state
MEDIA_DIAG ai_realtime_state
MEDIA_DIAG socket_connection_state

서버 Grafana/Loki용

SFU_MEDIA_LIFECYCLE transport_created|connected|closed|dtls_failed
SFU_MEDIA_LIFECYCLE producer_created|closed|score
SFU_MEDIA_LIFECYCLE consumer_created|resumed|closed|producer_closed|score
SFU_ROOM_LIFECYCLE join|leave|duplicate_cleanup|disconnect_cleanup