WebView 데이터 모니터링¶
App 측 설정¶
먼저 SDK 초기화를 완료합니다. WebView RUM을 수집하려면 RUM 설정도 완료해야 하며, FTRUMManager().setConfig(enableTraceWebView: true)를 통해 수집을 제어합니다. 기본값은 true입니다.
Android 측에서는 ft-plugin 연동에 따라 WebView 계측 설정을 완료해야 합니다.
WebView 호스트 설정¶
SDK 0.5.8부터 기본 설정 진입점을 지원합니다.
FTMobileFlutter.sdkConfig()에서 allowWebViewHost를 사용하여 WebView RUM 및 로그 수집을 허용할 호스트를 일괄 설정합니다. 이전 RUM 설정 진입점은 호환성을 위해 유지되며, 다음과 같이 마이그레이션할 것을 권장합니다.
await FTMobileFlutter.sdkConfig(
datawayUrl: datawayUrl,
cliToken: cliToken,
+ allowWebViewHost: ['example.com'],
);
await FTRUMManager().setConfig(
androidAppId: appAndroidId,
iOSAppId: appIOSId,
enableTraceWebView: true,
- allowWebViewHost: ['example.com'],
);
기본 설정을 지정하지 않은 경우 이전 RUM의 allowWebViewHost를 사용합니다. 두 곳 모두 설정하지 않으면 모든 호스트를 허용합니다. 빈 목록 []을 명시적으로 전달하면 어떤 호스트도 허용하지 않음을 의미합니다. 우선순위는 원격 rumAllowWebViewHost > 기본 설정 allowWebViewHost > 이전 RUM 설정 순입니다.
Web 페이지 초기화¶
App 측 설정을 완료한 후 이어서 페이지 초기화를 진행하고, WebView 데이터 검증에 따라 데이터 전송을 확인합니다.
Flutter 뷰의 세션 리플레이 설정 및 WebView 지원 범위는 Flutter 세션 리플레이를 참고하세요.
WebView 로그 수집¶
SDK 0.5.8부터 지원합니다.
Web 페이지에는 Browser Logs SDK를 통합하고 초기화해야 합니다. Flutter 측에서는 FTLogger().logConfig(enableWebViewLog: true)를 통해 WebView 로그 수신을 활성화하며, App SDK가 이를 처리하고 업로드합니다. 기본값은 비활성화입니다.
await FTLogger().logConfig(
enableWebViewLog: true,
logSamplingRate: 100.0,
enableLinkRumData: true, // 필요 시 RUM 연결
);
enableWebViewLog는 사용자 지정 로그 스위치 enableCustomLog 및 WebView RUM 스위치 enableTraceWebView와 독립적이며, WebView 호스트 설정의 제한을 받습니다. RUM을 연결해야 하는 경우 먼저 RUM을 초기화하고 유효한 View를 생성해야 합니다. 로그 샘플링, 레벨 필터링 및 캐시 설정은 Log 설정을 참고하세요.
원격 설정을 활성화한 후에는 logEnableWebViewLog를 통해 로컬 스위치를 재정의할 수 있습니다. 지원되는 필드 및 적용 방식은 Flutter 원격 설정 필드를 참고하세요.