콘텐츠로 이동

RUM 설정

RUM 초기화 설정

await FTRUMManager().setConfig(
  androidAppId: appAndroidId,
  iOSAppId: appIOSId,
  sessionSamplingRate: 100.0,
);

필드 유형 필수 설명
androidAppId String Android 필수 Android 플랫폼의 app_id로, 애플리케이션 접속 모니터링 콘솔에서 신청합니다. Android 런타임에서만 읽습니다.
iOSAppId String iOS 필수 iOS 플랫폼의 app_id로, 애플리케이션 접속 모니터링 콘솔에서 신청합니다. iOS 런타임에서만 읽습니다.
sessionSamplingRate double 아니요 RUM 세션 샘플링 비율, 범위 [0,100], 소수점 지원, 기본값 100. 0.1은 0.1%, 1은 1%를 의미합니다. 동일 세션의 RUM 데이터에 적용됩니다. SDK 0.5.8부터 지원.
sampleRate double 아니요 이전 확률 설정, 호환성 유지. RUM 세션 샘플링 비율, 범위 [0,1], 기본값 1. 0.1은 10%, 1은 100%를 의미합니다. sessionSamplingRate 사용을 권장합니다.
sessionOnErrorSamplingRate double 아니요 정상 세션 샘플링에 포함되지 않았을 때의 오류 보충 샘플링 백분율, 범위 [0,100], 소수점 지원, 기본값 0. 오류 발생 시 오류 발생 전 1분 범위의 RUM 데이터를 보충 수집할 수 있으며 동일 세션에 적용됩니다. SDK 0.5.8부터 지원.
sessionOnErrorSampleRate double 아니요 이전 확률 설정, 호환성 유지. 오류 보충 샘플링 확률, 범위 [0,1], 기본값 0. sessionOnErrorSamplingRate 사용을 권장합니다.
enableUserResource bool 아니요 Flutter http Resource 자동 수집 활성화 여부, 기본값 false. HttpOverrides.global 수정으로 구현되며, 프로젝트에 사용자 정의 요구 사항이 있으면 FTHttpOverrides를 상속해야 합니다
enableWebSocketResource bool 아니요 Dart WebSocket 연결 수립 핸드셰이크 수집 여부, 기본값 false, enableUserResource도 함께 활성화해야 합니다. 핸드셰이크만 수집하며 메시지 프레임이나 연결 유지 시간은 수집하지 않습니다. SDK 0.5.8부터 지원, 자세한 내용은 WebSocket 핸드셰이크 수집 참고
enableNativeUserAction bool 아니요 네이티브 측 Action 자동 추적 여부, Android/iOS 네이티브 컨트롤 클릭 및 앱 시작 이벤트 포함, 기본값 false. Android는 ft-plugin을 구성해야 하며, 시작 이벤트를 수집하려면 Application도 사용자 정의해야 합니다
enableNativeUserView bool 아니요 네이티브 페이지 자동 수집 여부, Android는 Activity, iOS는 UIViewController 수집, 기본값 false
enableNativeUserViewLoadingTime bool 아니요 iOS 네이티브 UIKit / SwiftUI View 자동 로딩 시간 수집 스위치, 기본값 true, enableNativeUserView를 활성화해야 합니다. 끄더라도 View 추적에는 영향을 주지 않습니다. Android는 무시하며 Flutter 라우트 소요 시간에는 영향을 주지 않습니다. SDK 0.5.8부터 지원, 자세한 내용은 iOS 네이티브 View 로딩 시간 참고
nativeViewLoadingTimeClassNameExcludes List<String> 아니요 iOS 네이티브 View 로딩 시간 제외 목록, 기본값 비어 있음. 컨트롤러의 전체 런타임 클래스 이름으로 정확히 일치시키며 대소문자를 구분합니다. Android는 무시합니다. SDK 0.5.8부터 지원
launchPrewarmInterval int 아니요 iOS 시작 프리웜 소요 시간 추론 임계값, 단위 밀리초, 기본값 0은 소요 시간 추론 비활성화를 의미합니다. 양수는 임계값을 설정하며, 음수 및 9223372036854보다 큰 값은 네이티브 SDK에서 무시됩니다. enableNativeUserAction을 활성화해야 하며 Android는 무시합니다. SDK 0.5.8부터 지원, 자세한 내용은 iOS 시작 프리웜 참고
enableNativeSwiftUIUserView bool 아니요 iOS: 네이티브 SwiftUI View 자동 추적 활성화 여부. enableNativeUserView도 함께 활성화해야 합니다
enableNativeUserViewInFragment bool 아니요 Android Fragment 페이지 자동 수집 여부, ft-plugin 구성 필요, 기본값 false, Android만 지원
enableNativeUserResource bool 아니요 네이티브 네트워크 Resource 자동 수집 활성화 여부, Android는 OkHttp 요청 자동 수집, iOS는 네이티브 네트워크 요청 자동 수집, 기본값 false. SDK 0.5.8부터 네이티브 SDK가 모니터링할 수 있는 WebSocket 연결 수립 핸드셰이크도 지원합니다. 이 파라미터는 Dart WebSocket을 수집하지 않습니다. 이 파라미터와 Flutter HttpClient 요청을 수집하는 enableUserResource는 두 가지 독립적인 기능입니다
enableNativeAppUIBlock bool 아니요 네이티브 메인 스레드 블로킹(UI Block/Freeze) 자동 감지 활성화 여부, 기본값 false
nativeUiBlockDurationMS int 아니요 네이티브 메인 스레드 블로킹 감지 임계값, 단위 밀리초, enableNativeAppUIBlock 활성화 시에만 적용, 값 범위 [100, ). iOS 기본값 250ms, Android 기본값 1000ms
enableLongTask bool 아니요 Flutter Dart 메인 Isolate 긴 작업 자동 감지 활성화 여부, 기본값 false
dartLongTaskThreshold double 아니요 Flutter Dart 긴 작업 감지 임계값, 단위 초, 기본값 0.1
enableTrackNativeAppANR bool 아니요 네이티브 ANR 모니터링 활성화 여부, 기본값 false. ANR은 앱이 지속적으로 응답하지 않는 상태를 감지하는 데 사용되며, enableNativeAppUIBlock이 수집하는 단일 메인 스레드 블로킹과 다릅니다. iOS는 메인 스레드 RunLoop를 통해 무응답을 감지합니다
enableTrackNativeCrash bool 아니요 네이티브 크래시 모니터링 활성화 여부, 기본값 false. Android는 Java Crash 및 Native C/C++ Crash를 수집하고, iOS는 Crash를 수집하며 iosCrashMonitoringType으로 모니터링 유형을 구성할 수 있습니다
errorMonitorType int 아니요 RUM Error 데이터에 추가할 보조 모니터링 정보를 설정합니다. ErrorMonitorType.battery, memory, cpu, all을 지원하며 호출 시 해당 .value를 전달합니다. 예: ErrorMonitorType.all.value. 기본값은 비활성화입니다
deviceMetricsMonitorType int 아니요 RUM View 데이터에 추가할 성능 모니터링 정보를 설정합니다. DeviceMetricsMonitorType.battery, memory, cpu, fps, all을 지원하며 호출 시 해당 .value를 전달합니다. 예: DeviceMetricsMonitorType.all.value. 기본값은 비활성화입니다
detectFrequency enum DetectFrequency 아니요 View 성능 모니터링 샘플링 주기: DetectFrequency.normal은 500ms, frequent는 100ms, rare는 1000ms, 기본값 normal; deviceMetricsMonitorType을 구성한 경우에만 의미가 있습니다
globalContext Map 아니요 사용자 정의 전역 파라미터. 추가 규칙은 충돌 필드 설명을 참고하세요
rumCacheDiscard enum 아니요 폐기 정책: FTRUMCacheDiscard.discard는 새 데이터 폐기(기본값), FTRUMCacheDiscard.discardOldest는 오래된 데이터 폐기
rumCacheLimitCount int 아니요 로컬 캐시 최대 RUM 항목 수 제한 [10_000, ), 기본값 100_000
isInTakeUrl bool Function(String url) 아니요 Flutter http Resource URL 필터 콜백. true 반환 시 필터링하여 수집하지 않고, false 반환 시 수집합니다. 사용 방법은 데이터 수집 사용자 정의 규칙을 참고하세요
enableTraceWebView bool 아니요 네이티브 SDK를 통해 WebView 데이터를 수집할지 여부, Android/iOS 지원, 기본값 true
allowWebViewHost List<String> 아니요 이전 RUM Host 설정과 호환됩니다. SDK 0.5.8부터는 FTMobileFlutter.sdkConfig(allowWebViewHost: ...)에서 통합 설정하여 RUM과 Log가 공유하는 것을 권장합니다. 원격 구성이 기본 구성보다 우선하며, 기본 구성이 이 진입점보다 우선합니다
enableResourceHostIP bool 아니요 네이티브 Resource 요청의 Host IP 수집 여부, 기본값 false. enableNativeUserResource의 네이티브 네트워크 자동 수집에만 영향을 주며, enableUserResource가 수집하는 Flutter HttpClient Resource에는 적용되지 않습니다. iOS는 13 이상이 필요합니다
iosCrashMonitoringType enum IOSCrashMonitoringType 아니요 iOS 크래시 모니터링 유형, iOS에서만 적용, enableTrackNativeCrash를 활성화해야 합니다. machException, signal, cppException, nsException, system, applicationState, all, highCompatibility를 선택할 수 있으며 기본값은 IOSCrashMonitoringType.highCompatibility입니다

백분율 샘플링 설정

SDK 0.5.8부터 지원.

샘플링 비율 파라미터 이름

SDK 0.5.8부터 sessionSamplingRate와 sessionOnErrorSamplingRate 사용을 권장합니다. 값은 0~100의 백분율이며 소수점을 지원합니다. 0은 샘플링 안 함, 100은 전체 샘플링을 의미합니다. 범위를 벗어난 값, NaN 또는 무한대 등의 유효하지 않은 값은 ArgumentError를 발생시킵니다.

기존 sampleRate와 sessionOnErrorSampleRate는 호환성을 위해 계속 유지되며 값은 0~1의 확률입니다. 예를 들어 기존 필드의 0.1은 10%, 새 필드의 0.1은 0.1%를 의미합니다. 동일 항목에 새 필드와 기존 필드를 동시에 설정하면 명시적 0을 포함해 새 백분율 필드가 우선합니다.

원격 샘플링 필드의 단위와 우선순위는 Flutter 원격 구성 필드를 참고하세요.

예를 들어 12.5% RUM 샘플링을 다음과 같이 마이그레이션합니다:

 await FTRUMManager().setConfig(
   androidAppId: appAndroidId,
   iOSAppId: appIOSId,
-  sampleRate: 0.125,
-  sessionOnErrorSampleRate: 0.0,
+  sessionSamplingRate: 12.5,
+  sessionOnErrorSamplingRate: 0.0,
 );

Log, Trace 및 Session Replay에서도 해당 백분율 파라미터를 제공합니다.

iOS 네이티브 View 로딩 시간

SDK 0.5.8부터 지원.

FTRUMManager().setConfig()를 처음 호출할 때 설정합니다. enableNativeUserViewLoadingTime은 네이티브 UIKit / SwiftUI View의 자동 로딩 시간 수집만 제어하며 enableNativeUserView를 동시에 활성화해야 합니다. 네이티브 SwiftUI View는 enableNativeSwiftUIUserView도 활성화해야 합니다. 이러한 설정은 Flutter 라우트의 로딩 시간을 계산하지 않으며, Flutter 페이지는 현재 View 로딩 시간 업데이트를 사용해 직접 보고할 수 있습니다.

await FTRUMManager().setConfig(
  androidAppId: appAndroidId,
  iOSAppId: appIOSId,
  enableNativeUserView: true,
  enableNativeUserViewLoadingTime: true,
  nativeViewLoadingTimeClassNameExcludes: [
    'MyApp.ContainerViewController',
  ],
);

두 로딩 시간 파라미터를 전달하지 않으면 네이티브 기본값을 따릅니다: 수집 활성화, 제외 목록 비어 있음. 제외 목록은 컨트롤러의 전체 런타임 클래스 이름을 사용하며, Swift 클래스 이름은 일반적으로 모듈 이름 접두사를 포함합니다. 대소문자를 구분해 정확히 일치시키며, 상위 클래스, 정규식 또는 사용자 정의 view_name과는 일치시키지 않습니다. 특정 컨트롤러의 로딩 시간 수집을 전역적으로 끄거나 제외해도 해당 페이지의 View 추적은 꺼지지 않습니다. Android는 이 두 파라미터를 무시합니다.

iOS 시작 프리웜

SDK 0.5.8부터 지원.

launchPrewarmInterval은 iOS 네이티브 시작 프리웜의 소요 시간 추론 임계값을 설정하는 데 사용되며 단위는 밀리초이고 네이티브 자동 Action 수집을 활성화해야 합니다. RUM 초기화 시 설정합니다. 예:

await FTRUMManager().setConfig(
  androidAppId: appAndroidId,
  iOSAppId: appIOSId,
  enableNativeUserAction: true,
  launchPrewarmInterval: 1500,
);

전달하지 않거나 0을 전달하면 소요 시간 추론을 끄지만, 네이티브 SDK의 시스템 프리웜 마커 처리는 유지됩니다. 양수는 추론 임계값을 설정하며, 소요 시간이 길다고 해서 시스템 프리웜이 반드시 발생했다는 의미는 아닙니다. 음수 및 9223372036854보다 큰 값은 네이티브 SDK에서 무시됩니다. Android는 이 파라미터를 무시합니다. 두 가지 초기 프리웜 감지 메서드는 여전히 iOS 네이티브 시작 진입점에서 호출해야 하며, Flutter는 대응하는 Dart 메서드를 제공하지 않습니다. iOS 시작 프리웜 설정을 참고하세요.

RUM 사용자 데이터 추적

Action

startAction과 addAction의 사용 차이
  • startAction은 내부적으로 Action 소요 시간을 자동 계산하며, 계산 기간에 주변에서 발생한 Resource, LongTask, Error 데이터와 최대한 연관시키고 100 ms 빈번한 트리거 보호 기능이 있습니다. 사용자 작업 유형 데이터에 사용하는 것을 권장합니다.
  • 빈번하게 호출해야 하는 경우 addAction을 사용하세요. addAction으로 보고한 Action은 startAction과 충돌하지 않으며 현재 Resource, LongTask, Error 데이터와도 연관되지 않습니다.

사용 방법

/// action 추가
/// [actionName] action 이름
/// [actionType] action 유형
/// [property] 추가 속성 파라미터(선택 사항)
Future<void> startAction(String actionName, String actionType,
  {Map<String, Object?>? property})

/// 빈번한 action 추가, 현재 Resource, LongTask, Error 이벤트와 연관되지 않음
Future<void> addAction(String actionName, String actionType,
  {Map<String, Object?>? property})

코드 예시

FTRUMManager().startAction("action name", "action type");

FTRUMManager().addAction("action name", "action type");

View

자동 수집

MaterialApp.navigatorObservers에 FTRouteObserver를 추가하면 SDK가 Flutter 페이지 전환을 자동 수집할 수 있습니다. 페이지 이름(view_name)은 다음 방법으로 설정할 수 있습니다.

방법 1: routes를 통한 수집

MaterialApp.routes에 이동할 페이지를 설정하며, routes의 key가 페이지 이름(view_name)이 됩니다.

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: HomeRoute(),
      navigatorObservers: [
        FTRouteObserver(),
      ],
      routes: <String, WidgetBuilder>{
        'logging': (BuildContext context) => Logging(),
        'rum': (BuildContext context) => RUM(),
        'tracing_custom': (BuildContext context) => CustomTracing(),
        'tracing_auto': (BuildContext context) => AutoTracing(),
      },
    );
  }
}

Navigator.pushNamed(context, "logging");
방법 2: FTMaterialPageRoute를 통한 수집

사용자 정의 FTMaterialPageRoute를 통해 위젯의 runtimeType에서 페이지 이름을 파싱하며, widget 클래스 이름이 페이지 이름(view_name)이 됩니다.

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: HomeRoute(),
      navigatorObservers: [
        FTRouteObserver(),
      ],
    );
  }
}

Navigator.of(context).push(
  FTMaterialPageRoute(builder: (context) => new NoRouteNamePage()),
);

예시는 여기를 참고하세요.

방법 3: RouteSettings.name을 통한 수집

Route 유형 페이지에서 RouteSettings.name을 사용자 정의하면 FTRouteObserver가 해당 값을 우선 가져옵니다. 이 방법은 showDialog(), showTimePicker() 등 Dialog 유형 페이지에도 적용됩니다.

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: HomeRoute(),
      navigatorObservers: [
        FTRouteObserver(),
      ],
    );
  }
}

Navigator.of(context).push(
  MaterialPageRoute(
    builder: (context) => new NoRouteNamePage(),
    settings: RouteSettings(name: "RouteSettingName"),
  ),
);

위 세 가지 방법은 한 프로젝트에서 함께 사용할 수 있습니다.

절전 및 깨우기 이벤트 수집

0.5.1-pre.1 미만 버전에서 앱의 절전 및 깨우기 동작을 수집하려면 다음 코드를 추가해야 합니다:

class _HomeState extends State<HomeRoute> {
  @override
  void initState() {
    FTLifeRecycleHandler().initObserver();
  }

  @override
  void dispose() {
    FTLifeRecycleHandler().removeObserver();
  }
}

자동 수집 필터 규칙은 데이터 수집 사용자 정의 규칙을 참고하세요.

사용자 정의 View

사용 방법
/// view 생성, 이 메서드는 [starView] 전에 호출해야 합니다
/// [viewName] 화면 이름
/// [duration] 페이지 로딩 시간
Future<void> createView(String viewName, int duration)

/// view 시작
/// [viewName] 화면 이름
/// [viewReferer] 이전 화면 이름
/// [property] 추가 속성 파라미터(선택 사항)
Future<void> starView(String viewName, {Map<String, String>? property})

/// view 종료
/// [property] 추가 속성 파라미터(선택 사항)
Future<void> stopView({Map<String, String>? property})
코드 예시
FTRUMManager().createView("Current Page Name", 100000000);

FTRUMManager().starView("Current Page Name");

FTRUMManager().stopView();

자동 페이지 수집, 라우트 필터링, 절전/깨우기 리스닝 등의 규칙은 데이터 수집 사용자 정의 규칙을 참고하세요.

현재 View 로딩 시간 업데이트

SDK 0.5.8부터 지원.

현재 View가 시작되었고 아직 종료되지 않은 상태에서 FTRUMManager().updateViewLoadingTime(int duration)를 호출하면 Future<void>를 반환합니다. duration은 비즈니스에서 직접 측정한 페이지 로딩 시간이며 단위는 나노초이고 0 이상이어야 합니다. 음수이면 ArgumentError가 발생합니다. SDK는 이 메서드로 비즈니스 로딩 완료 시간을 자동으로 판단하지 않습니다.

final loadingWatch = Stopwatch()..start();
await FTRUMManager().starView('ProductDetail');
// 현재 페이지에 필요한 비즈니스 데이터 또는 콘텐츠 로딩 완료 대기
await loadProductDetail();
loadingWatch.stop();
await FTRUMManager().updateViewLoadingTime(
  loadingWatch.elapsedMicroseconds * 1000,
);
// 페이지를 떠날 때 현재 View 종료
await FTRUMManager().stopView();

Flutter 자동 라우트 수집은 페이지 체류 시간을 기록하며 비즈니스 로딩 시간을 자동으로 측정하지 않습니다. 자동 라우트 수집을 사용할 때는 현재 라우트에 해당하는 View가 시작된 후에 업데이트해야 하며, 동일 페이지에 대해 starView를 반복 호출하지 마세요. 기존 createView는 수동 starView 전에 여전히 사용할 수 있으며, 해당 duration도 나노초 단위입니다.

Error

자동 수집

void main() async {
  runZonedGuarded(() async {
    WidgetsFlutterBinding.ensureInitialized();
    await FTMobileFlutter.sdkConfig(
      datakitUrl: serverUrl,
      debug: true,
    );
    await FTRUMManager().setConfig(
      androidAppId: appAndroidId,
      iOSAppId: appIOSId,
    );

    // Flutter 예외 캡처
    FlutterError.onError = FTRUMManager().addFlutterError;
    runApp(MyApp());
  }, (Object error, StackTrace stack) {
    // Error 데이터 추가
    FTRUMManager().addError(error, stack);
  });
}

사용자 정의 Error

사용 방법
/// 사용자 정의 오류 추가
/// [stack] 스택 로그
/// [message] 오류 메시지
/// [appState] 앱 상태
/// [errorType] 사용자 정의 errorType
/// [property] 추가 속성 파라미터(선택 사항)
Future<void> addCustomError(String stack, String message,
  {Map<String, String>? property, String? errorType})
코드 예시
FTRUMManager().addCustomError("error stack", "error message");

LongTask

자동 수집

FTRUMManager().setConfig에서 enableLongTask를 활성화하면 SDK가 Flutter Dart 메인 Isolate에서 임계값을 초과하는 블로킹 작업이 발생하는지 감지하고 LongTask 데이터를 생성합니다. 기본 임계값은 0.1초이며 dartLongTaskThreshold로 조정할 수 있습니다.

await FTRUMManager().setConfig(
  androidAppId: appAndroidId,
  iOSAppId: appIOSId,
  enableLongTask: true,
  dartLongTaskThreshold: 0.1,
);

사용자 정의 LongTask

사용 방법
/// LongTask 보고, duration 단위는 나노초
Future<void> addLongTask(String stack, int duration,
  {Map<String, String>? property})
코드 예시
FTRUMManager().addLongTask(
  "flutter_manual_long_task",
  250000000,
  property: {"long_task_source": "manual_report"},
);

자동 감지된 LongTask는 Dart 메인 Isolate 이벤트 루프 지연을 식별하기 위한 것이며, 수집되는 값은 블로킹 지속 시간입니다. 블로킹을 일으킨 비즈니스 코드 스택을 반드시 얻을 수 있다는 의미는 아닙니다.

Resource

자동 수집

FTRUMManager().setConfig에서 enableUserResource를 활성화하여 구현합니다.

WebSocket 핸드셰이크 수집

SDK 0.5.8부터 지원.

await FTRUMManager().setConfig(
  androidAppId: appAndroidId,
  iOSAppId: appIOSId,
  enableUserResource: true,
  enableWebSocketResource: true,
);

final socket = await FTWebSocket.connect('wss://example.com/socket');

FTWebSocket은 package:ft_mobile_agent_flutter/ft_mobile_agent_flutter.dart에서 가져올 수 있습니다. connect는 Future<WebSocket>을 반환하며 파라미터는 Dart WebSocket.connect와 대응합니다: 필수 String url, 그리고 선택 사항인 Iterable<String>? protocols, Map<String, dynamic>? headers, CompressionOptions compression(기본값 CompressionOptions.compressionDefault) 및 HttpClient? customClient.

표준 WebSocket.connect의 자동 수집은 첫 연결 전에 위 설정을 활성화해야 합니다. 직접 생성한 HttpClient를 사용할 때는 요청이 SDK 수집을 거치도록 해야 합니다. 하위 프로토콜이나 압축 검증 등 핸드셰이크 실패 시나리오를 처리해야 하는 경우 FTWebSocket.connect를 사용하세요. SDK는 연결 수립 핸드셰이크 결과만 수집하며 이후 메시지 프레임, 메시지 내용 또는 연결 유지 시간은 수집하지 않습니다. URL 필터링은 여전히 isInTakeUrl을 따릅니다.

사용자 정의 Resource

사용 방법
/// 리소스 요청 시작
/// [key] 고유 id
/// [property] 추가 속성 파라미터(선택 사항)
Future<void> startResource(String key, {Map<String, String>? property})

/// 리소스 요청 종료
/// [key] 고유 id
/// [property] 추가 속성 파라미터(선택 사항)
Future<void> stopResource(String key, {Map<String, String>? property})

/// 리소스 데이터 메트릭 전송
Future<void> addResource({
  required String key,
  required String url,
  required String httpMethod,
  required Map<String, dynamic> requestHeader,
  Map<String, dynamic>? responseHeader,
  String? responseBody = "",
  int? resourceStatus,
  int? resourceSize,
  String? resourceType,
  bool webSocketHandshake = false,
  String? webSocketHandshakeState,
  String? errorMessage,
  String? errorStack,
  bool forceNetworkError = false,
  FTRUMResourceMetrics? metrics,
})
필드 유형 설명
resourceSize int 응답 본문 크기, 단위 byte
resourceType String 리소스 유형, 예: native, image, media, font, css, js
webSocketHandshake bool WebSocket 연결 수립 핸드셰이크 여부, 기본값 false. SDK 0.5.8부터 지원
webSocketHandshakeState String 핸드셰이크 결과: success, rejected 또는 failed, webSocketHandshake: true와 함께 사용합니다. SDK 0.5.8부터 지원
errorMessage String Resource 오류 설명. SDK 0.5.8부터 지원
errorStack String Resource 오류 스택. SDK 0.5.8부터 지원
forceNetworkError bool 네트워크 오류로 보고할지 여부, 기본값 false. SDK 0.5.8부터 지원
metrics.requestSize num 요청 크기, 요청 헤더와 요청 본문 포함, 단위 byte
metrics.resourceHttpProtocol String Resource에서 사용하는 HTTP 프로토콜, 예: http/1.1
metrics.reusedConnection bool 연결 재사용 여부

enableUserResource 자동 수집을 활성화하면 SDK가 요청 메서드, 응답 헤더 및 연결 상태에 따라 resourceType, requestSize, resourceHttpProtocol, reusedConnection 등의 필드를 자동으로 보완합니다.

코드 예시
void httpClientGetHttp(String url) async {
  var httpClient = HttpClient();
  String key = Uuid().v4();
  HttpClientResponse? response;
  HttpClientRequest? request;
  try {
    request = await httpClient
        .getUrl(Uri.parse(url))
        .timeout(Duration(seconds: 10));
    FTRUMManager().startResource(key);
    response = await request.close();
  } finally {
    Map<String, dynamic> requestHeader = {};
    Map<String, dynamic> responseHeader = {};

    request!.headers.forEach((name, values) {
      requestHeader[name] = values;
    });
    var responseBody = "";
    if (response != null) {
      response.headers.forEach((name, values) {
        responseHeader[name] = values;
      });
      responseBody = await response.transform(Utf8Decoder()).join();
    }
    FTRUMManager().stopResource(key);
    FTRUMManager().addResource(
      key: key,
      url: request.uri.toString(),
      requestHeader: requestHeader,
      httpMethod: request.method,
      responseHeader: responseHeader,
      resourceStatus: response?.statusCode,
      responseBody: responseBody,
    );
  }
}

http 라이브러리와 dio 라이브러리 사용 예시는 example을 참고하세요.

문서 평가

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