PPI-1398 · FEATURE / PERFORMANCE · 2026-10-20 · KST
4개 세션의 탭 부하와
카드별 영상 처리를 구분합니다.
마지막 업데이트 2026-10-26
목표는 4:1 모니터 진행자웹의 CPU·메모리 부하를 줄일 근거를 확보하는 것입니다. 성능 진단 로그를 구현했고, 현재 Chrome 탭에서 작업 관리자와 영상 카운터를 직접 읽었습니다. 절감안 적용이나 개선율을 검증한 작업은 아닙니다.
애플리케이션: ppi / PPI-1398 / cf8ce700 · 대상: ppi-1398-dev.dubuhealth.in/monitor-dashboard/{group}?mode=test · 세션·활동 전환은 사용자 조작
1. 확인한 구조와 구현 범위
아동 카메라 → 단일 레이어 인코딩 → Mediasoup → 카드의 video 요소. 현재 기본 송신 설정은 300kbps 상한·가로/세로 1/2 축소이며, 네트워크 적응 시 해상도·FPS가 더 낮아집니다.
게스트의 화면 상태 → 진행자에서 같은 리소스를 다운로드 → 진행자 브라우저에서 직접 재생. 카메라 수신과 별개의 영상 처리·캐시 비용입니다.
브랜치 분석 당시 카드뷰에는 이미 forceLowResolutionVideo가 적용돼 있었습니다. 서버가 480p 변환본을 가진 영상만 480p로 선택하며, 없으면 일반 변환본/원본을 반환합니다. 카메라는 단일 레이어라 수신 선호 레이어를 2→0으로 바꾸는 것만으로 새 저해상도 스트림이 만들어지지 않습니다.
이번 커밋15초 주기 진단 수집을 추가했습니다. 페이지 공통 값은 카드 수와 관계없이 한 번, 카드별 미디어와 방별 카메라는 별도로 수집하도록 구현했습니다. 종료·미지원 API·통계 실패는 수업 재생에 전파하지 않도록 처리했습니다.
| 코드 경로 — ppi 기준 | 책임 |
|---|---|
apps/web/lib/monitor-performance.ts | 단일 타이머·Long Task 관측, JS 힙, 영상 프레임 델타, 카메라 통계 델타·종료 경합 처리 |
apps/web/hooks/use-monitor-performance.ts | 모니터 DOM 대상과 카메라 통계 조회 함수를 React 수명에 연결, 기존 logger 사용 |
apps/web/hooks/use-resource-cache.ts | Blob URL/Response 개수, 알려진 파일 바이트 합계, 진행 중 다운로드 집계. 집계를 위해 Response 본문을 추가로 읽지 않음 |
apps/web/hooks/mediasoup/use-mediasoup-consumer.ts | 열려 있는 video consumer의 getStats 읽기 경계 |
apps/web/shared/ui/monitor-media-display.tsxapps/web/shared/ui/meet-avatar.tsxapps/web/shared/ui/meet-video.tsx | 측정할 DOM 루트와 카메라/idle/talking/콘텐츠/대기 영상 구분 |
apps/web/features/session/ui/session-card.tsxapps/web/app/monitor-dashboard/[group]/[roomId]/page.tsx | 카드뷰·확대뷰의 방 식별자를 측정 경로에 전달 |
2. Chrome 작업 관리자에서 읽은 CPU·메모리
4세션이 한 탭·렌더러를 공유합니다. 아래 DUBU 값은 수업 카드와 공통 페이지 처리를 합친 값입니다. 카드별 CPU%·메모리를 직접 분리한 결과가 아니며, 4로 나눠 세션별 점유량으로 사용하면 안 됩니다.
| 기록 시각 KST | 연결 수 | DUBU CPU | DUBU 메모리 | 근거 |
|---|---|---|---|---|
| 15:17:10 기록 | 2 | 23.6% | 326MB | 직전 작업 관리자 읽기 + 뒤이은 DOM 2카메라 확인. 원자적 동시 표본 아님 |
| 15:17:47 | 사용자 보고 2 | 29.6% | 308MB | 작업 관리자. 같은 표본의 DOM 연결 수는 미수집 |
| 15:18:17 | 3 | 36.2% | 355MB | 작업 관리자 + DOM 3카메라 |
| 15:18:50 | 4 | 33.8% | 517MB | 작업 관리자 + DOM 4카메라 |
| 15:19:34 | 4 | 32.4% | 517MB | 작업 관리자 + DOM 4카메라 |
| 15:20:05 | 4 | 31.8% | 566MB | 사용자 제공 스크린샷 |
1세션 구간에서는 실제 CPU·탭 메모리를 확보하지 못했습니다. 당시 JS 힙 약 54MiB만 읽었습니다. 연결 수 증가와 활동·로딩 상태가 함께 달라졌으므로 세션당 증가량, 평균 CPU, 최대 부하, 개선율을 계산할 수 없습니다.
DevTools는 별도 프로세스입니다
스크린샷에서 DUBU: 31.8% / 566MB / PID 54324, DevTools: 20.7% / 783MB / PID 60685입니다. DevTools 행은 네 세션의 합계가 아닙니다. DUBU 행에도 별도 GPU·브라우저·네트워크 공통 프로세스 비용이 모두 포함되는 것은 아닙니다.
DevTools가 열려 있는 환경의 측정입니다. 517→566MB 증가는 관측 사실이지만, 캐시·활동 전환·GC 영향이 분리되지 않아 누수로 확정하지 않습니다.
3. 카드별로 실제 분리해 확인한 항목
2026-10-20 15:31:46.794~15:32:23.330 KST, 실제 간격 36.536초. 위 작업 관리자 구간보다 약 12분 뒤의 별도 관측입니다. viewport는 1197×997, 탭은 visible이었습니다. 카드 1~4는 DOM 순서이며 실제 아동·방 ID에 연결하지 않았습니다.
| 카드 | 카메라 | 관측 구간 총 프레임 / 드롭 | 끝 시점의 아바타·콘텐츠 | 화면 위치 |
|---|---|---|---|---|
| 1 | 320×180 약 10.0fps | 365 / 33 드롭 9.0% | idle·talking·콘텐츠 요소는 있으나 paused=true, 해상도 0×0. 해당 소스가 교체돼 리소스 델타는 미산출 | 카메라는 viewport 안 |
| 2 | 320×180 약 10.0fps | 364 / 10 드롭 2.7% | idle·talking 854×480, paused=false. 대기 영상 854×480 약 30.0fps, CSS 0×0 | 카메라·아바타는 viewport 안 |
| 3 | 320×180 약 10.0fps | 366 / 366 드롭 100% | idle·talking 854×480, paused=false. 대기 영상 약 29.9fps, CSS 0×0 | 카메라·아바타는 viewport 밖 |
| 4 | 320×180 약 10.1fps | 368 / 368 드롭 100% | idle·talking 854×480, paused=false. 대기 영상 약 29.8fps, CSS 0×0 | 카메라·아바타는 viewport 밖 |
이 시점에는 영상 요소 16개가 있었고 13개가 paused=false였습니다. 영상 요소가 있다는 것, paused=false라는 것, 실제로 보인다는 것은 서로 다릅니다. 아바타 소스가 관측 사이에 바뀐 경우 FPS/드롭을 임의 계산하지 않았습니다.
카메라 FPS는 getVideoPlaybackQuality().totalVideoFrames의 초당 증가량으로, 드롭된 프레임도 포함합니다. 네트워크 수신 FPS나 패킷 손실률이 아닙니다. 특히 카드 3·4는 viewport 밖이므로 100% 드롭을 CPU 과부하로 해석할 수 없습니다. 모든 카드가 보이는 조건으로 다시 측정해야 합니다.
메모리의 세션별 구분 한계
같은 DOM 관측 구간의 JS 힙은 약 73.2→220.2MiB였습니다. 전체 탭 메모리와 다른 지표이고, 앞선 566MB 스크린샷과 같은 시각이 아닙니다. 이 증가를 특정 카드의 캐시·디코더·전사에 배분할 근거는 없습니다.
| 자원 | 카드별로 구분 가능한 것 | 현재 정확한 CPU/MB 배분 |
|---|---|---|
| 카메라 | 해상도·재생 상태·요소 프레임 카운터. 구현상 consumer 통계도 대상 | 불가 — 실제 방별 디코딩 로그는 아직 미수신 |
| 아바타·콘텐츠 | idle/talking/자료/대기 종류, 크기, 소스 유지·교체, 프레임 처리 | 불가 — 디코더·그래픽 버퍼의 카드별 메모리 미측정 |
| 오디오·전사·React | 코드상 카드별 경로는 존재 | 불가 — 이번에 경로별 CPU·보관량을 측정하지 않음 |
| 리소스 캐시·공통 페이지 | 전역 Map과 공통 JS 힙. 구현상 캐시 개수·파일 바이트 수집 대상 | 불가 — 파일 공유·공통 상태가 있어 4등분할 수 없음 |
4. 확인된 현상과 병목 후보
카드 2·3·4의 content-placeholder는 CSS 0×0인데 36.536초 동안 각각 1,096 / 1,094 / 1,087프레임이 증가했습니다. 화면에 보이지 않는 약 30fps 영상 처리의 유지 비용을 조사할 근거입니다.
854×480 idle/talking 영상이 각각 유지됩니다. 일부 표시 폭은 39 CSS px였습니다. 두 소스의 동시 유지·재생과 숨김 상태의 자원 해제를 검토할 수 있습니다. 정확한 절감량은 아직 모릅니다.
- 측정 경로 정상화: 주기 로그가 실제로 나오지 않은 원인을 먼저 확인하고 캐시·카메라 디코딩 지표를 확보합니다.
- 숨은 대기 영상 처리: 미표시 시 pause/소스 해제를 비교합니다. 전환·복귀 지연과 오디오·준비 화면 동작을 회귀 검증해야 합니다.
- 캐시 수명: 현재 전역 Response/Blob URL 보관 경로에 자동 퇴출 한도가 없습니다. 참조 중인 파일을 보호하며 미사용 캐시 해제·선로딩 축소를 검토합니다.
- 480p·15fps 비교: 리소스 파일의 실제 재인코딩이 필요합니다. 현재 관측한 카메라는 이미 약 10fps였으므로 같은 논리를 그대로 적용하지 않습니다.
위 항목은 후속 후보입니다. 이번 커밋에서 재생·해상도·FPS·캐시 해제 정책을 변경하지 않았으며, 인과관계나 개선율을 입증하지 않았습니다.
5. 구현한 로그와 실제 수집 상태
| 이벤트 / 주기 15초 | 구현한 지표 | 해석 |
|---|---|---|
page_sample | JS 힙·증가량, Long Task 횟수/시간, 타이머 지연, visibility, 캐시 개수·파일 바이트·진행 중 다운로드 | CPU%나 프로세스 RSS가 아님. Blob/Response의 논리적 파일 바이트를 합쳐 실제 메모리로 해석하지 않음 |
media_sample | 카드/확대뷰, 영상 종류·해상도·CSS 크기·상태·프레임/드롭 델타 | 총 프레임 증가량은 드롭 포함. 소스 교체/리셋 시 델타 재기준화 |
camera_sample | consumer 해상도, 수신 비트레이트, 디코딩 FPS, 프레임당 디코딩 시간, 손실·지터 | 브라우저 제공 필드 기준. 미지원은 null, 실패는 status로 구분 |
코드 검증과 브라우저 실제 수신은 구분합니다. 콘솔 임시 수집기는 probe 한 건을 정상 수집했지만, 실제 MONITOR_PERFORMANCE 주기 이벤트는 0건이었습니다. 로그가 없다는 이유로 부하가 낮다고 판단할 수 없습니다. 이번 실측 표는 주기 로그가 아닌 작업 관리자와 DOM에서 읽은 대체 관측입니다.
기존 S3 경로와 조건 — 코드상 확인
createLogger("MONITOR_PERFORMANCE")
→ 브라우저 Console + 기존 lessonLogSink
→ 카드별 LessonLogHub lane
→ 주기 업로드 / 종료 flush
→ s3://ppi/{stage}/lesson-logs/{userId}/lesson-{회차}/parts/{YYYYMMDD}/
monitor-nosession-{instanceId}-{순번}.jsonl[.gz]
업로드 활성화와 info 포함 수집 레벨이 필요합니다. roomId가 있는 카드/카메라 로그는 해당 lane, 방 식별자가 없는 페이지 공통 로그는 활성 lane에 들어갑니다. 페이지 공통 값은 sampleAt으로 중복 제거합니다. 이번에는 S3 파일을 읽지 않았고 실제 성능 로그 업로드 성공도 확인하지 않았습니다.
6. 검증 결과와 남은 범위
- 커밋 전 관련 소스 테스트 4파일·29건 통과. 집계 계산, 4개 대상의 중복 방지, 마지막 해제, 비동기 종료 경합, 실패 복구, 미지원 API, 카운터 리셋, 캐시·다운로드 실패 경로를 검증했습니다.
- 변경 파일·의존성 범위 TypeScript 검사 통과. 기존 파일의 ESLint 오류 34개는 HEAD에도 같았으며 신규 오류는 없습니다.
- 변경 경로를 지정한 mutation 테스트 실행. 최종 측정 모듈은 162개 탐지·76개 생존·4개 미커버. UI 통합 커버리지는 제한적입니다. 확대뷰 페이지 단독 실행은 관련 테스트가 없어
No tests were executed로 종료됐습니다. - guardian-gate 코드 검토에서 P0/P1 미발견. 잔여 P2는 기존 린트와 UI 통합 커버리지 부족입니다. UI 외형·상호작용 변경이 없어 Storybook 변경/빌드는 수행하지 않았습니다.
- 실기동 한계: 주기 성능 로그 미수신, 실제 S3 수신 미검증, 카드별 CPU·메모리 미분리, 1세션 CPU/전체 메모리 미확보, DevTools 영향, 일부 카드 viewport 밖, A/B 및 장시간 누수 검증 미수행.
다음 측정 조건
주기 로그 작동을 확인한 뒤, 네 카드를 모두 보이게 하고 DevTools 표시 여부를 고정합니다. 동일 콘텐츠·세션 수·창 크기로 안정화 구간 이후 일정 시간 비교하고, 함수별 CPU는 Chrome Performance trace, 객체 보관은 heap snapshot으로 확인합니다. 카드별 점유량이 필요하면 통제된 단일 세션 실험 또는 프로파일링 설계가 추가로 필요합니다.
7. 원본 증거와 인계
다운로드 폴더에는 PPI-1398-monitor-performance-2026-10-20 폴더와 동일 이름의 ZIP을 저장합니다. 아래 파일은 문서 저장소에도 같은 내용으로 보관합니다.
- 증거 설명과 측정 한계
- CPU·메모리 표본 CSV · 작업 관리자·DOM 원본 JSONL
- 카드별 시작 표본 · 종료 표본 · 계산 결과
- 주기 로그 0건 상태 · 파일 SHA-256 목록
관련 문서: 이전 모니터 카드 재생 병목 분석 · 모니터 카드 녹화 구현안
LLM용 인계 맥락
문서 상태: 구현·일부 실측 확인 / 성능 주기 로그 실기동 미확인. 애플리케이션 저장소와 문서 저장소는 별도이며, 이 문서 추가 자체로 배포·성능 개선이 완료되는 것은 아닙니다.