クイックスタート¶
この記事では、Flutter RUM SDK の最短導入パスを提供し、最小限の手順で検証可能なデータ送信を完了できるようにします。
アプリは Agent 自動導入 と 手動導入 をサポートしています。以下の手順では、手動導入の最小構成を説明します。
前提条件¶
開始前に、以下の準備を完了してください:
- リアルユーザーモニタリング(RUM) で Android 用と iOS 用のアプリをそれぞれ作成し、対応する
appIdを取得します - 送信先アドレスと認証方式を確認します:
- ローカル環境デプロイ:
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 回実行する、またはネットワークリクエストを 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 のハイブリッド開発 を読んでください