トラブルシューティング¶
Debug モードを有効にする¶
以下の設定で SDK の Debug 機能を有効にできます。有効にすると、Android では Flutter のビルドツール上で出力された Debug ログを直接確認できます。iOS では、Xcode でビルドして実行するか、Xcode でビルドするか、macOS のコンソールアプリで確認する必要があります。
注意:Release バージョンをリリースする際は、この設定を無効にすることを推奨します。
Android Logcat および iOS Xcode Console のログ例
SDK は正常に動作しているがデータがない¶
-
Datakit のトラブルシューティング で、正常に動作しているか確認します。
-
SDK のアップロード先
datakitUrlまたはdatawayUrlが正しく設定され、正しく初期化されていることを確認します。debug モードでは、Android Logcat または iOS Xcode Console の同期ログを確認します。 -
Datakit が対応するワークスペースにデータをアップロードしているか、オフライン状態になっていないかを確認します。これは Guance にログインし、「インフラストラクチャ」を表示して確認できます。
コンパイル時に pod エラーが発生する¶
SDK 0.5.8 以降、iOS のネイティブ依存は
GuanceSDKに変更され、最低 iOS バージョンは 15.0 です。アップグレード時は、Core と Replay の互換バージョン、Deployment Target、依存関係ロックファイルを揃え、旧FTMobileSDKを同時にリンクしないようにしてください。導入手順は iOS 統合 を参照してください。以下のFTMobileSDKエラー例は旧バージョンの依存関係に適用されます。
CocoaPods could not find compatible versions for pod "FTMobileSDK/FTMobileAgent"¶
[!] CocoaPods could not find compatible versions for pod "FTMobileSDK/FTMobileAgent":
In snapshot (Podfile.lock):
FTMobileSDK/FTMobileAgent (= 1.3.9-alpha.14)
In Podfile:
ft_mobile_agent_flutter (from `.symlinks/plugins/ft_mobile_agent_flutter/ios`) was resolved to 0.0.2, which depends on
FTMobileSDK/FTMobileAgent (= 1.3.10-beta.2)
You have either:
* out-of-date source repos which you can update with `pod repo update` or with `pod install --repo-update`.
* changed the constraints of dependency `FTMobileSDK/FTMobileAgent` inside your development pod `ft_mobile_agent_flutter`.
You should run `pod update FTMobileSDK/FTMobileAgent` to apply changes you've made.
iOS アプリのコンパイル時にバージョンのインポートに関するこのような問題が発生した場合は、ターミナルで Flutter プロジェクトの ios ディレクトリに移動し、次のコマンドを実行します:
The Swift pod ft_mobile_agent_flutter depends upon FTMobileSDK, which does not define modules¶
ft_mobile_agent_flutter ≤ 0.5.6 では、CocoaPods の設定で use_module_headers! または use_frameworks! を明示的に指定していない場合、pod install を実行すると次のエラーが発生します:
[!] The following Swift pods cannot yet be integrated as static libraries:
The Swift pod `ft_mobile_agent_flutter` depends upon `FTMobileSDK`, which does not define modules. To opt into those targets generating module maps (which is necessary to import them from Swift when building as static libraries), you may set `use_modular_headers!` globally in your Podfile, or specify `:modular_headers => true` for particular dependencies.
問題の原因:ft_mobile_agent_flutter(Swift で開発)は Objective-C ライブラリ FTMobileSDK に依存していますが、FTMobileSDK.podspec に DEFINES_MODULE = YES の設定がないため、iOS の静的ライブラリのコンパイル時に module が見つからないというエラーが発生します。
解決方法:プロジェクトの Podfile の target 'Runner' do ブロック内に次の設定を追加します:
target 'Runner' do
flutter_install_all_ios_pods File.dirname(File.realpath(__FILE__))
pod 'FTMobileSDK', :modular_headers => true
end
注意::modular_headers => true を追加するのはコンパイル設定を補足するためだけであり、SDK を重複して導入するものではありません。
データの欠落¶
一部のデータが欠落する¶
- RUM のいずれかの Session データ、または Log、Trace の数件のデータが欠落している場合は、まず RUM、Log、Trace のサンプリング設定を確認してください。SDK 0.5.8 以降で推奨されるパーセントフィールドはそれぞれ
sessionSamplingRate、logSamplingRate、traceSamplingRateで、100未満の場合は割合に応じてサンプリングされます。旧sampleRateは引き続き [0,1] の確率を使用します。新しいフィールドは旧フィールドより優先されるため、リモート設定がローカル値を上書きしていないかも確認してください。 -
収集した RUM データが不完全で、Resource または Action データがない場合は?
Resource と Action のデータは View にバインドされています。
FTRouteObserverまたは手動のstarViewで View を開始するようにしてください。View イベントの収集を実装するには、RUM View ドキュメントを参照してください。 -
データをアップロードするデバイスのネットワーク、および Datakit をインストールしたデバイスのネットワークと負荷の問題を確認してください。
