トラブルシューティング¶
SDK 初期化の異常チェック¶
Logcat で、ログレベルが Error で、Tag が [FT-SDK] で始まるログが出力されていないか確認します。
SDK 内部ではアサーションを使用して複数の設定項目の正しさをチェックしており、設定に誤りがあるとプログラムがクラッシュし、関連する警告が出力されます。ただし、デフォルトでは Debug 環境でのみ有効です。オフラインのビルドプロジェクトを使用してカスタムデバッグベースを作成し、Release 環境でも同様に有効にすることをお勧めします。
project -> target -> Build Settings をクリックし、検索ボックスで ENABLE_NS_ASSERTIONS を検索して、Release の対応する値を Yes に変更します。
デバッグベースでのみ設定することをお勧めします。通常のパッケージリリース時はデフォルト設定を使用してください。
上記の設定を行わない場合は、Debug デバッグを有効にする ことで、「コンソール」のデバッグログを確認し、ログの内容から SDK が正常に初期化されたかどうかを判断することもできます。
Debug デバッグを有効にする¶
以下の設定で、SDK のデバッグ機能を有効にすることができます。
var ftMobileSDK = uni.requireNativePlugin("GCUniPlugin-MobileAgent");
ftMobileSDK.sdkConfig({
'serverUrl': SDKConst.SERVER_URL,
'debug': true,
});
バージョンリリース時には、この設定を無効にすることをお勧めします。
Tag が [FT-SDK] で始まる Logcat のログを確認します。
Mac の「コンソール」で SDK のデバッグログを確認します。
「コンソール」の使用方法：
操作 を選択し、概要情報を含める、デバッグ情報を含める にチェックを入れます。
デバッグするデバイスを選択し、開始 ボタンをクリックします。右側の検索条件ボックスに検索条件 [FTLog] を入力します。これで SDK のデバッグログを確認できます。
Android Logcat および iOS Xcode Console のログサンプル
SDK は正常に動作しているがデータがない¶
-
SDK のアップロード先アドレス
serverUrlが正しく設定され、正しく初期化されていることを確認します。デバッグモードで、Android Logcat または iOS Xcode Console の同期ログを確認します。 -
datakit が対応するワークスペースにデータをアップロードしているか、オフライン状態になっていないかを確認します。これは、Guance にログインし、「インフラストラクチャー」を確認することで判断できます。
データ欠落¶
データの一部欠落¶
-
RUM の特定の Session データや Log、Trace 内の数件のデータが欠落している場合は、まず RUM 設定、Log 設定、Trace 設定 で
samplerate < 1が設定されていないか確認してください。 -
収集した RUM データが不完全で、Resource や Action データがない？
Resource データと Action データは View にバインドされています。そのため、- startView 操作が実行されていることを確認する必要があります。View イベントの収集方法については、RUM-View のドキュメントを参照してください。
-
データをアップロードするデバイスのネットワーク、および datakit がインストールされているデバイスのネットワークと負荷の問題を確認します。