클라이언트 성능 모니터링의 slow/frozen frame 판정과 알림 정책

2026-048 minunitymonitoringandroid-vitalsframe-timememory

문제

클라이언트 모니터링 시스템을 배포한 뒤, 성능 알림 이벤트가 과도하게 수집됐다. 기존 이벤트명(alert_low_fps)으로 쌓인 데이터는 이미 판단에 쓸 수 없는 상태였다.

FPS 측정과 알림을 Android Vitals와 비슷한 기준인 프레임 시간 기반 slow/frozen frame 비율로 바꾼다. 메모리를 포함한 전체 모니터링은 씬 단위 단계별 최초 1회 로깅으로 통일한다.

Android Vitals 기준은 다음과 같다.

구분	키	기본값	비고
제거	`monitor.fps_log_cooldown`	-	단계별 1회 로깅으로 불필요
제거	`monitor.memory_log_cooldown`	-	단계별 1회 로깅으로 불필요
추가	`monitor.slow_frame_warning_ratio`	0.2	slow frame warning 비율 (20%)
추가	`monitor.slow_frame_severe_ratio`	0.5	slow frame severe 비율 (50%)
추가	`monitor.frozen_frame_threshold_ms`	700	frozen frame 임계값 (ms)
유지	`monitor.enable`	true	모니터링 전체 ON/OFF
유지	`monitor.sampling_rate`	1.0	샘플링 비율
유지	`monitor.memory_warning_ratio`	0.3	메모리 warning 비율
유지	`monitor.memory_critical_ratio`	0.5	메모리 critical 비율
유지	`monitor.fps_scene_grace_period`	5	씬 로드 후 측정 제외 (초)
유지	`monitor.fps_fg_grace_period`	3	포그라운드 복귀 후 측정 제외 (초)
유지	`monitor.warmstart_enable`	false	웜 스타트 측정

쿨다운 반복 방식에서는 같은 씬에 머무는 시간에 비례해 알림이 계속 쌓였다. 바뀐 방식에서는 씬당 알림 수에 아래 표의 상한이 생긴다.

alert_low_fps와 alert_game_low_fps는 더 이상 발생하지 않는다.

같은 작업에서 마케팅 성과 분석용 데이터 경로도 정리했다.

마케팅 성과 분석을 위해 AppsFlyer의 전환 데이터(media_source 등)를 이벤트 수집 SDK로 넘겨야 한다. 기존 AppEventLogger는 URL·딥링크에서 파라미터를 하나씩 파싱해 보냈고, 일부 경우에 값이 누락됐다.

AppsFlyer SDK 콜백 데이터를 AppsFlyerSystem에 저장해 두고, 로그인이 끝난 시점에 이벤트 수집 SDK로 한 번에 보낸다.

수집 경로(SDK 콜백 → 저장):

OnRequestResponse: SDK 요청 응답(statusCode)
OnDeepLinkReceived: 딥링크 수신(DeepLinkEventsArgs)
AppsFlyerConversionHandler.onConversionDataSuccess/Fail → SetConversionData(): 전환 데이터

전송 시점은 로그인 성공 후 로그인 처리 클래스가 호출하는 OnLogin()이다.

이벤트명	조건	파라미터
`af_request_success`	SDK 요청 성공 (status 200)	`af_id`
`af_request_fail`	SDK 요청 실패 (status ≠ 200)	`status`, `desc`
`af_deep_link_found`	딥링크 수신 성공	`af_id`, `is_deferred`, `deep_link`
`af_deep_link_error`	딥링크 수신 실패	`af_id`, `error`
`af_conversion_data_success`	전환 데이터 수신 성공	`af_id`, `media_source`, `campaign`, `adset`, `af_channel`, `af_ad`, `af_status`, `data` (JSON 원본)
`af_conversion_data_fail`	전환 데이터 수신 실패	`af_id`, `error`

전환 데이터 원본(JSON)을 직접 보내므로, AppEventLogger에서 URL·딥링크를 개별 파싱하던 media_source 로직은 중복이 되어 지웠다.

CollectMediaSourceFromUrl(), StoreMediaSourceFromDeepLink(), TryFlushMediaSourceLog()
MediaSourceParamKeys, BuildMediaSourceParams(), GetMediaSourceParamKeys()
hasLoggedMediaSource, pendingMediaSourceParams 필드

호출부는 한 줄만 바뀐다.

1
// Before
2
AppEventLogger.TryFlushMediaSourceLog();
3

4
// After
5
AppsFlyerSystem.OnLogin(msg);