クイックスタート¶
このドキュメントでは、Flutter RUM SDK を最短で導入し、最小限の手順で検証可能なデータ送信を完了する方法を説明します。
前提条件¶
開始前に、以下の準備を完了してください。
- リアルユーザーモニタリング（RUM） で Android と iOS のアプリをそれぞれ作成し、対応する
appIdを取得します。 - データ送信先のURLと認証方法を確認します。
- ローカル環境デプロイ：
datakitUrlを準備 - パブリックネットワーク DataWay：
datawayUrlとcliTokenを準備 - プロジェクトで SDK のインストールが完了していることを確認します。
導入手順¶
ft_mobile_agent_flutterをインストールします。- アプリ起動時に
FTMobileFlutter.sdkConfigを呼び出します。 FTRUMManager().setConfig(...)を初期化し、Flutter の自動例外収集を有効にします。MaterialApp.navigatorObserversにFTRouteObserver()を追加します。- ログと分散型トレーシングが必要な場合は、
FTLoggerとFTTracerを初期化します。 - コンソールでデータが正常に送信されたことを確認します。
SDK のインストール¶
インストール方法は アプリ導入 を参照してください。
最小初期化例¶
void main() async {
runZonedGuarded(() async {
WidgetsFlutterBinding.ensureInitialized();
// ローカル環境デプロイでは datakitUrl を使用
await FTMobileFlutter.sdkConfig(
datawayUrl: datawayUrl,
cliToken: cliToken,
debug: true,
);
await FTRUMManager().setConfig(
androidAppId: appAndroidId,
iOSAppId: appIOSId,
enableUserResource: true,
);
// Flutter の自動例外収集
FlutterError.onError = FTRUMManager().addFlutterError;
runApp(const MyApp());
}, (Object error, StackTrace stack) {
FTRUMManager().addError(error, stack);
});
}
class MyApp extends StatelessWidget {
const MyApp({super.key});
@override
Widget build(BuildContext context) {
return MaterialApp(
navigatorObservers: [
// 自動ページ遷移収集
FTRouteObserver(),
],
home: const HomePage(),
);
}
}
class HomePage extends StatelessWidget {
const HomePage({super.key});
@override
Widget build(BuildContext context) {
return const Placeholder();
}
}
ローカル環境デプロイを使用する場合は、
datawayUrlとcliTokenをdatakitUrlに置き換えてください。名前付きルートを使用した View の自動収集が必要な場合は、
MaterialApp.routesにルートテーブルを設定してください。詳細は データ収集カスタムルール を参照してください。
オプション：Log と Trace の初期化¶
ログ収集や分散型トレーシングも必要な場合は、以下の初期化を追加できます。
await FTLogger().logConfig(
enableCustomLog: true,
enableLinkRumData: true,
);
await FTTracer().setConfig(
enableAutoTrace: true,
enableLinkRUMData: true,
);
導入の確認¶
debug: trueを有効にしたままアプリを実行します。- ページを開く、ルート遷移を実行する、またはネットワークリクエストを1回実行します。
- Flutter、Android Studio、Xcode のコンソールで、SDK の初期化とデータ同期に関するログが表示されることを確認します。
- Guance コンソールに戻り、アプリに対応する RUM データが表示されていることを確認します。
さらに調査が必要な場合は、トラブルシューティング を参照してください。
次のステップ¶
- 完全なインストールと初期化の説明は、アプリ導入 を参照してください。
- すべての初期化パラメータの説明は、SDK 初期化 を参照してください。
- RUM、Log、Trace の詳細な設定は、RUM 設定、Log 設定、Trace 設定 を参照してください。
- Session Replay を導入する場合は、Flutter Session Replay を参照してください。
- Flutter で H5 ページモニタリングを導入する場合は、WebView データモニタリング を参照してください。
- プロジェクトがネイティブと Flutter のハイブリッド開発の場合は、ネイティブと Flutter のハイブリッド開発 を参照してください。