빠른 시작¶
이 문서는 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를 켠 상태로 앱을 실행합니다.- 페이지를 열거나, 라우트 이동을 한 번 수행하거나, 네트워크 요청을 한 번 발생시킵니다.
- Flutter, Android Studio, Xcode의 콘솔에서 SDK 초기화 및 데이터 동기화 관련 로그가 표시되는지 확인합니다.
- Guance 콘솔로 돌아가 앱에 해당 RUM 데이터가 표시되는지 확인합니다.
추가적인 문제 해결이 필요한 경우 문제 해결을 참고하세요.
다음 단계¶
- 전체 설치 및 초기화 설명은 앱 연동을 계속 읽어보세요.
- 모든 초기화 파라미터 설명은 SDK 초기화를 참고하세요.
- RUM, Log, Trace의 상세 구성은 RUM 구성, Log 구성, Trace 구성을 참고하세요.
- Session Replay를 연동해야 하는 경우 Flutter Session Replay를 참고하세요.
- Flutter에서 H5 페이지 모니터링을 연동해야 하는 경우 WebView 데이터 모니터링을 계속 읽어보세요.
- 프로젝트가 네이티브와 Flutter 하이브리드 개발인 경우 네이티브와 Flutter 하이브리드 개발을 계속 읽어보세요.