コンテンツにスキップ

クイックスタート

この記事では、Flutter RUM SDK の最短導入パスを提供し、最小限の手順で検証可能なデータ送信を完了できるようにします。

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

前提条件

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

  1. リアルユーザーモニタリング(RUM) で Android 用と iOS 用のアプリをそれぞれ作成し、対応する appId を取得します
  2. 送信先アドレスと認証方式を確認します:
  3. ローカル環境デプロイ:datakitUrl を準備します
  4. パブリックネットワーク DataWay:datawayUrl と cliToken を準備します
  5. プロジェクトで SDK のインストールが完了していることを確認します

導入手順

  1. ft_mobile_agent_flutter をインストールします
  2. アプリ起動時に FTMobileFlutter.sdkConfig を呼び出します
  3. FTRUMManager().setConfig(...) を初期化し、Flutter 例外の自動収集を有効にします
  4. MaterialApp.navigatorObservers に FTRouteObserver() を追加します
  5. ログと分散型トレーシングが必要な場合は、さらに FTLogger と FTTracer を初期化します
  6. コンソールでデータが正常に送信されたことを確認します

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,
);

導入が成功したかの確認

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

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

次のステップ

フィードバック

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