コンテンツにスキップ

トラブルシューティング

Debug モードを有効にする

以下の設定で SDK の Debug 機能を有効にできます。有効にすると、Android では Flutter のビルドツール上で出力された Debug ログを直接確認できます。iOS では、Xcode でビルドして実行するか、Xcode でビルドするか、macOS のコンソールアプリで確認する必要があります。

FTMobileFlutter.sdkConfig(
      datakitUrl: serverUrl,
      debug: true, // debug モードを有効にする
  );

注意: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 ディレクトリに移動し、次のコマンドを実行します:

pod install --repo-update

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 をインストールしたデバイスのネットワークと負荷の問題を確認してください。

関連資料

フィードバック

このページは役に立ちましたか?