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 リモート設定フィールド を参照してください。