クイックスタート¶
この記事では、React Native RUM SDK の最短の導入手順を紹介し、最小限の手順で検証可能なデータ送信を 1 回完了できるようにします。
アプリは Agent 自動導入と手動導入をサポートしています。以下の手順では、手動導入の最小構成について説明します。
事前準備¶
開始前に、以下の準備を完了してください:
- リアルユーザーモニタリング(RUM)で React Native Android と React Native iOS のアプリをそれぞれ作成し、対応する
App IDを取得してください。 - 送信先アドレスと認証方式を確認してください:
- ローカル環境デプロイ:
datakitUrlを準備してください -
パブリック DataWay:
datawayUrlとclientTokenを準備してください -
プロジェクトに
@cloudcare/react-native-mobileをインストールしてください -
Android ネイティブの起動、ネットワークリクエスト、または WebView データを収集する必要がある場合は、Android
ft-pluginも設定してください。
導入手順¶
- React Native SDK をインストールします
- アプリ起動時に
FTMobileConfigを初期化します FTRUMConfigを初期化し、Android と iOS のApp IDを渡します- 任意:
FTLogConfigとFTTraceConfigを初期化します - デバッグログを有効にし、アプリを実行して、ページを開く、クリックする、またはネットワークリクエストを送信する操作を 1 回実行します
- コンソールと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);
}
導入が成功したかの確認¶
debug: trueを有効にしたまま、アプリを実行します- ページを開く、ボタンをクリックする、またはネットワークリクエストを 1 回送信します
- デバッグログを確認し、SDK の初期化とデータ同期が正常に実行されたことを確認します
- Guance コンソールに戻り、アプリに対応する RUM データが表示されていることを確認します
さらに調査が必要な場合は、トラブルシューティング を参照してください。
次のステップ¶
- 完全なインストールと導入手順については、アプリの導入 を引き続きお読みください
- すべての初期化パラメータの説明については、SDK の初期化 をお読みください
- RUM、Log、Trace の詳細設定については、RUM 設定、Log 設定、Trace 設定 をお読みください
- WebView モニタリングを導入する必要がある場合は、WebView データモニタリング をお読みください
- Session Replay を導入する必要がある場合は、Session Replay をお読みください
- プロジェクトがネイティブと React Native のハイブリッド開発である場合は、ネイティブと React Native のハイブリッド開発 をお読みください