시작하기¶

이 문서는 Flutter RUM SDK의 가장 짧은 연동 경로를 제공하여 최소한의 단계로 검증 가능한 데이터 전송을 완료할 수 있도록 돕습니다.

사전 준비¶

시작하기 전에 다음 준비를 완료합니다.

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. 페이지를 열거나, 라우트 전환을 수행하거나, 네트워크 요청을 실행합니다.
3. Flutter, Android Studio, Xcode의 콘솔에서 SDK 초기화 및 데이터 동기화 관련 로그가 나타나는지 확인합니다.
4. Guance 콘솔로 돌아가 앱에 해당 RUM 데이터가 나타나는지 확인합니다.

추가 문제 해결이 필요한 경우 문제 해결을 참조합니다.

다음 단계¶

• 전체 설치 및 초기화 설명은 앱 연동을 참조합니다.
• 모든 초기화 매개변수 설명은 SDK 초기화를 참조합니다.
• RUM, Log, Trace의 상세 구성은 RUM 구성, Log 구성, Trace 구성을 참조합니다.
• Session Replay 연동이 필요한 경우 Flutter Session Replay를 참조합니다.
• Flutter에서 H5 페이지 모니터링을 연동해야 하는 경우 WebView 데이터 모니터링을 참조합니다.
• 프로젝트가 네이티브와 Flutter 혼합 개발인 경우 네이티브와 Flutter 혼합 개발을 참조합니다.