コンテンツにスキップ

クイックスタート

この記事では、React Native RUM SDK の最短の導入手順を紹介し、最小限の手順で検証可能なデータ送信を 1 回完了できるようにします。

アプリは Agent 自動導入と手動導入をサポートしています。以下の手順では、手動導入の最小構成について説明します。

事前準備

開始前に、以下の準備を完了してください:

  1. リアルユーザーモニタリング(RUM)で React Native Android と React Native iOS のアプリをそれぞれ作成し、対応する App ID を取得してください。
  2. 送信先アドレスと認証方式を確認してください:
  3. ローカル環境デプロイ:datakitUrl を準備してください
  4. パブリック DataWay:datawayUrl と clientToken を準備してください

  5. プロジェクトに @cloudcare/react-native-mobile をインストールしてください

  6. Android ネイティブの起動、ネットワークリクエスト、または WebView データを収集する必要がある場合は、Android ft-plugin も設定してください。

導入手順

  1. React Native SDK をインストールします
  2. アプリ起動時に FTMobileConfig を初期化します
  3. FTRUMConfig を初期化し、Android と iOS の App ID を渡します
  4. 任意:FTLogConfig と FTTraceConfig を初期化します
  5. デバッグログを有効にし、アプリを実行して、ページを開く、クリックする、またはネットワークリクエストを送信する操作を 1 回実行します
  6. コンソールとGuanceプラットフォームで、データが正常に送信されたことを確認します

SDK のインストール

インストール方法は アプリの導入 を直接参照してください。

最小初期化の例

import {
  FTMobileReactNative,
  FTReactNativeRUM,
  FTMobileConfig,
  FTRUMConfig,
  ErrorMonitorType,
  DeviceMetricsMonitorType,
  DetectFrequency,
} from '@cloudcare/react-native-mobile';
async function sdkInit() {
  // ローカル環境デプロイでは { datakitUrl: 'http://10.0.0.1:9529' } を使用します
  const config: FTMobileConfig = {
    datawayUrl: 'https://open.dataway.url',
    clientToken: 'client_token',
    debug: true,
  };
  await FTMobileReactNative.sdkConfig(config);

  const rumConfig: FTRUMConfig = {
    androidAppId: 'android_app_id',
    iOSAppId: 'ios_app_id',
    enableAutoTrackUserAction: true,
    enableAutoTrackError: true,
    enableNativeUserResource: true,
  };
  await FTReactNativeRUM.setConfig(rumConfig);
}

トップレベルの index.js で App を登録する前に SDK の初期化を完了してください。SDK の他のメソッドを呼び出す前に、初期化が完了していることを確認してください。

import App from './App';

async function initSDK() {
  await sdkInit();
}

initSDK();
AppRegistry.registerComponent('main', () => App);

任意:Log と Trace の初期化

import {
  FTReactNativeLog,
  FTReactNativeTrace,
  FTLogConfig,
  FTTraceConfig,
} from '@cloudcare/react-native-mobile';
async function setupExtraModules() {
  const logConfig: FTLogConfig = {
    enableCustomLog: true,
    enableLinkRumData: true,
  };
  await FTReactNativeLog.logConfig(logConfig);

  const traceConfig: FTTraceConfig = {
    enableNativeAutoTrace: true,
  };
  await FTReactNativeTrace.setConfig(traceConfig);
}

導入が成功したかの確認

  1. debug: true を有効にしたまま、アプリを実行します
  2. ページを開く、ボタンをクリックする、またはネットワークリクエストを 1 回送信します
  3. デバッグログを確認し、SDK の初期化とデータ同期が正常に実行されたことを確認します
  4. Guance コンソールに戻り、アプリに対応する RUM データが表示されていることを確認します

さらに調査が必要な場合は、トラブルシューティング を参照してください。

次のステップ

フィードバック

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