콘텐츠로 이동

빠른 시작

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

추가적인 문제 해결이 필요한 경우 문제 해결을 참고하세요.

다음 단계

문서 평가

이 페이지가 도움이 되었나요?