トラブルシューティング¶

SDK 初期化エラー¶

通常の uni-app¶

1. GC-JSPlugin と GC-UniPlugin の両方が 0.3.0 以上であり、バージョン番号が一致し、同じリリースパッケージから取得されていることを確認します。
2. アプリケーションのエントリポイントで、JS コレクターを初めて使用する前に GC-UniPlugin/setup.js が読み込まれていることを確認します。
3. SDK API は GC-UniPlugin からインポートし、JS コレクターは GC-JSPlugin からインポートしていることを確認します。
4. プロジェクト内に古い nativeplugins/GCUniPlugin とそれに対応する manifest.json の設定が存在しないことを確認します。
5. datakitUrl または datawayUrl + clientToken の設定が有効であることを確認します。

uni ミニプログラム¶

1. uni ミニプログラムのプロジェクトには GC-JSPlugin のみをインストールし、GC-UniPlugin や setup.js はインポートしないでください。
2. ホスト App は uni ミニプログラムを開く前に Native SDK の初期化を完了させます。
3. ホストは GCUniPlugin-MobileAgent、GCUniPlugin-RUM、GCUniPlugin-Logger、GCUniPlugin-Tracer を登録しています。
4. 通常のデバッグベースにホストモジュールがない場合、パブリック API は安全に空操作にダウングレードされるため、ネイティブデータは報告されません。実際のホスト App で結合テストを実施してください。

Debug デバッグを有効にする¶

通常の uni-app：

import { mobileAgent } from '@/uni_modules/GC-UniPlugin';

mobileAgent.sdkConfig({
    datakitUrl: 'YOUR_DATAKIT_URL',
    debug: true
});

uni ミニプログラムでは、ホスト App が Native SDK の Debug 設定を有効にし、JS 側で sdkConfig() を重複して呼び出さないでください。

正式リリース前には Debug を無効にすることを推奨します。

SDK は正常に動作しているがデータがない¶

• Datakit のトラブルシューティング で正常に動作しているか確認します。
• SDK のアップロード先アドレスが正しく設定されていることを確認し、Debug ログの同期結果を確認します。
• RUM の初期化に現在のプラットフォームに対応する App ID が使用されていることを確認します。
• 現在のネットワークが Datakit または DataWay にアクセスできることを確認します。
• uni ミニプログラムのシナリオでは、ホスト App の初期化が完了してから uni ミニプログラムを開くことを確認します。

データ欠落¶

• RUM、Log、Trace で sampleRate < 1 が設定されていないか確認します。
• Resource と Action には有効な View が関連付けられている必要があります。自動または手動で startView が呼び出されていることを確認します。
• iOS で enableNativeUserResource を有効にする場合、gcResourceTracking.startTracking({ enableIOS: false }) と設定し、同じリクエストの重複収集を避けます。
• gcViewTracking と旧バージョンの View mixin を同時に有効にして同じページを収集しないでください。
• デバイスのネットワーク、Datakit の負荷、ローカルキャッシュの制限を確認します。

関連情報¶

• Android トラブルシューティング
• iOS トラブルシューティング