WebView モニタリング¶

WebView データモニタリング¶

WebView データモニタリングは、WebView でアクセスするページに Web モニタリング SDK を統合する必要があります。

デスクトップブラウザの Web アプリケーション収集も同時にサポートする必要がある場合は、デスクトップアプリケーションの推奨設定に従って接続することをお勧めします。

収集シナリオがアプリ内の WebView に限定され、デスクトップブラウザの Web アプリケーションをサポートする必要がない場合は、Web SDK の基本接続設定を完了した後、任意の applicationId を使用して初期化できます。

正常に初期化されると、アプリ内の WebView の収集データはデフォルトでアプリ側が一元的に管理します。

WebView 収集を無効にするか、host で収集範囲をフィルタリングする必要がある場合は、以下の設定を参照してください。

• FTRUMConfig.setEnableTraceWebView
• FTSDKConfig.setAllowWebViewHost

FTRUMConfig.setAllowWebViewHost は非推奨です。アップグレード後は FTSDKConfig.setAllowWebViewHost を使用して WebView RUM と Log の host 範囲を統一的に制御してください。

WebView ログ収集¶

ft-sdk >= 1.7.5 では、FTWebViewJavascriptBridge を介して WebView 内の Browser SDK によって生成されたログを受信し、Android SDK にログレベルのフィルタリング、サンプリング、キャッシュ、アップロードを実行させることができます。

この機能を有効にする前に、WebView ページに Web モニタリング SDK を統合し、Android Log を初期化する必要があります。

FTSdk.initLogWithConfig(new FTLoggerConfig()
    .setEnableWebViewLog(true)
    .setEnableLinkRumData(true));

FTSdk.initLogWithConfig(
    FTLoggerConfig()
        .setEnableWebViewLog(true)
        .setEnableLinkRumData(true)
)

• setEnableWebViewLog(true) は Browser SDK のログ収集のみを有効にし、ネイティブログの setEnableCustomLog や setEnableConsoleLog には依存しません。
• setEnableLinkRumData(true) を有効にすると、WebView ログが Android RUM の Application、Session などのコンテキストに関連付けられます。無効にすると、RUM 関連フィールドが削除されます。
• FTSDKConfig.setAllowWebViewHost は、WebView RUM と Log の host 範囲を統一制限するために使用されます。null はすべての host を許可、空の配列は Bridge を自動使用しないことを意味し、設定された host はそのサブドメインも一致します。この設定は Bridge の選択に使用され、ページソースのセキュリティ検証メカニズムとして使用すべきではありません。
• WebView ログも同様に、FTLoggerConfig.setSamplingRate、setLogLevelFilters、およびログキャッシュポリシーによって制御され、リモート設定による動的な有効化/無効化をサポートします。

よくあるトラブルシューティング¶

• カスタム WebView の自動収集が有効にならない場合は、トラブルシューティング を参照してください。
• カスタム WebView を手動で識別する必要がある場合は、アプリケーションの接続 の knownWebViewClasses 設定の説明を参照してください。