React Native アプリケーションの接続¶
React Native アプリケーションのメトリクスデータを収集し、アプリケーションパフォーマンスを可視化して分析します。
参照ガイド¶
- 初めて接続する場合:まず接続方式の選択を参照してください。手動接続の場合はクイックスタートを参照してください
- 完全な接続:本記事を引き続きお読みください
- パラメータの詳細:SDK 初期化、RUM 設定、Log 設定、Trace 設定を参照してください
- カスタマイズ機能:カスタムタグの使用、データ収集のカスタムルール、データ収集のマスキングを参照してください
- 高度なシナリオ:「高度なシナリオ」グループ内の専用ページを参照してください
- 問題の調査:トラブルシューティングを参照してください
前提条件¶
注意
RUM Headless サービスを開通済みの場合、前提条件は自動的に設定されているため、アプリケーションを直接接続できます。
ローカル環境にデプロイする場合は、以下のデータ受信側の設定を完了する必要があります。パブリック DataWay を使用する場合は、DataKit を自身でデプロイする必要はありません。
- DataKitをインストールします。
- RUM コレクターを設定します。
- DataKit をパブリックアクセス可能にし、IP 地理位置情報データベースをインストールします。
アプリケーションの接続¶
注意
現在の React Native バージョンは Android と iOS プラットフォームのみをサポートしています。
- RUM > アプリを作成 > React Native に移動します。
- React Native Android と React Native iOS 用にそれぞれアプリケーションを作成し、Android と iOS プラットフォームからの RUM データを別々に受信できるようにします。
- 各プラットフォームのアプリケーションに、対応するアプリケーション名とアプリケーション ID を入力します。
- 「接続方式の選択」で Agent による自動接続または手動接続を選択し、「接続設定」を完了します。
接続方式の選択¶
アプリケーション設定ページで「Agent による自動接続」または「手動接続」を選択し、「接続設定」を完了します。既存のアプリケーションの場合は、設定ページに直接移動して接続を続行できます。
| 接続方式 | ユースケース | 操作入口 |
|---|---|---|
| Agent による自動接続 | プログラミングアシスタントにプロジェクトを分析させて SDK の接続を完了したい場合 | コンソールが生成したプロンプトをコピーし、アプリケーションのコードリポジトリでプログラミングアシスタントに渡して実行します |
| 手動接続 | SDK を自身でインストールしてパラメータを設定したい場合 | データ送信方式を確認し、本記事とクイックスタートに従って設定を完了します |
Agent による自動接続¶
- 現在のアプリケーションの設定ページで「Agent による自動接続」を選択します。
- 「接続設定」内のプロンプト全体をコピーし、現在のアプリケーションの接続情報が使用されることを確認します。
- アプリケーションのコードリポジトリでプログラミングアシスタントを開き、プロンプトを貼り付けます。Agent が接続ガイドに従ってプロジェクトを分析し、SDK の設定を完了します。
- アプリケーションをビルドして実行し、ページビューなどの操作をトリガーして、現在のアプリケーションのエクスプローラーでデータが受信されていることを確認します。
クロスプラットフォームフレームワークを使用する場合は、Agent にフレームワークと対象プラットフォームを伝え、各プラットフォームに対応するアプリケーション情報を個別に提供してください。
ページに個人用 API Key または一時認証コードが未準備である旨が表示された場合は、案内に従って補完したうえでプロンプトを再度コピーしてください。
手動接続¶
アプリケーション設定ページで「手動接続」を選択し、データ送信方式を確認します。
- パブリック DataWay:RUM データを直接受信します。DataKit コレクターをインストールする必要はありません。
- ローカル環境へのデプロイ:前提条件を満たしたうえで RUM データを受信します。
後述のインストールとクイックスタートに従って、SDK のインストール、初期化、検証を完了します。既存の SDK 設定がある場合は、まず確認して再利用し、重複した初期化を避けてください。
インストール¶
ソースコード:https://github.com/GuanceCloud/datakit-react-native
Demo:https://github.com/GuanceCloud/datakit-react-native/example
プロジェクトのパスで、ターミナルから次のコマンドを実行します。
これにより、パッケージの package.json に次の依存関係が追加されます。
Android 統合の追加設定:
-
Gradle Plugin ft-plugin を設定し、アプリの起動イベントとネットワークリクエストデータ、および Android Native ネイティブ関連のイベント(ページ遷移、クリックイベント、Native ネットワークリクエスト、WebView データ)を収集します。
-
Gradle に Guance の Android Maven リポジトリ URL も設定する必要があります。Plugin と AAR の両方が必要です。設定の詳細は example 内の build.gradle を参照してください。
初期化について¶
最小構成の初期化例についてはクイックスタートを参照してください。
FTMobileConfig のパラメータの完全な説明については SDK 初期化を参照してください。
詳細設定の参照先¶
高度なシナリオ¶
- カスタムタグの使用
- データ収集のカスタムルール
- データ収集のマスキング
- 動的設定
- シンボルファイルのアップロード
- ホットアップデート SourceMap のバージョンマッチング
- WebView データモニタリング
- 訪問者識別子 Visitor ID
- ネイティブと React Native の混合開発
- Android Resource の手動設定