콘텐츠로 이동

빠른 시작

이 문서는 React Native RUM SDK의 가장 간단한 연동 경로를 제공하여 최소한의 단계로 검증 가능한 데이터 보고를 완료할 수 있도록 지원합니다.

앱은 Agent 자동 연동 및 수동 연동을 지원합니다. 다음 단계에서는 수동 연동의 최소 구성을 설명합니다.

사전 준비

시작하기 전에 다음 준비를 완료하세요.

  1. 실제 사용자 모니터링(RUM)에서 React Native Android 및 React Native iOS 앱을 각각 생성하고 해당 App ID를 가져옵니다.
  2. 보고 주소와 인증 방식을 확인합니다.
  3. 로컬 환경 배포: datakitUrl 준비
  4. 퍼블릭 DataWay: datawayUrl 및 clientToken 준비

  5. 프로젝트에 @cloudcare/react-native-mobile 설치

  6. Android 네이티브 시작, 네트워크 요청 또는 WebView 데이터를 수집해야 하는 경우 Android ft-plugin도 함께 구성하세요.

연동 단계

  1. React Native SDK 설치
  2. 앱 시작 시 FTMobileConfig 초기화
  3. FTRUMConfig를 초기화하고 Android 및 iOS의 App ID를 전달
  4. 선택 사항: FTLogConfig 및 FTTraceConfig 초기화
  5. 디버그 로그를 활성화하고 앱을 실행한 뒤 페이지 열기, 클릭 또는 네트워크 요청을 한 번 트리거
  6. 콘솔과 Guance 플랫폼에서 데이터가 성공적으로 보고되었는지 확인

SDK 설치

설치 방법은 애플리케이션 연동을 참고하세요.

최소 초기화 예시

import {
  FTMobileReactNative,
  FTReactNativeRUM,
  FTMobileConfig,
  FTRUMConfig,
  ErrorMonitorType,
  DeviceMetricsMonitorType,
  DetectFrequency,
} from '@cloudcare/react-native-mobile';
async function sdkInit() {
  // 로컬 환경 배포 시 { datakitUrl: 'http://10.0.0.1:9529' } 사용
  const config: FTMobileConfig = {
    datawayUrl: 'https://open.dataway.url',
    clientToken: 'client_token',
    debug: true,
  };
  await FTMobileReactNative.sdkConfig(config);

  const rumConfig: FTRUMConfig = {
    androidAppId: 'android_app_id',
    iOSAppId: 'ios_app_id',
    enableAutoTrackUserAction: true,
    enableAutoTrackError: true,
    enableNativeUserResource: true,
  };
  await FTReactNativeRUM.setConfig(rumConfig);
}

최상위 index.js에서 App을 등록하기 전에 SDK 초기화를 완료하여, SDK의 다른 메서드를 호출하기 전에 초기화가 완료되도록 하세요.

import App from './App';

async function initSDK() {
  await sdkInit();
}

initSDK();
AppRegistry.registerComponent('main', () => App);

선택 사항: Log 및 Trace 초기화

import {
  FTReactNativeLog,
  FTReactNativeTrace,
  FTLogConfig,
  FTTraceConfig,
} from '@cloudcare/react-native-mobile';
async function setupExtraModules() {
  const logConfig: FTLogConfig = {
    enableCustomLog: true,
    enableLinkRumData: true,
  };
  await FTReactNativeLog.logConfig(logConfig);

  const traceConfig: FTTraceConfig = {
    enableNativeAutoTrace: true,
  };
  await FTReactNativeTrace.setConfig(traceConfig);
}

연동 성공 여부 확인

  1. debug: true를 활성화한 상태로 앱을 실행합니다
  2. 페이지를 열고 버튼을 클릭하거나 네트워크 요청을 한 번 발생시킵니다
  3. 디버그 로그를 확인하여 SDK 초기화 및 데이터 동기화가 정상적으로 수행되었는지 확인합니다
  4. Guance 콘솔로 돌아가 앱에 해당 RUM 데이터가 표시되는지 확인합니다

추가로 문제를 해결해야 하는 경우 문제 해결을 참고하세요.

다음 단계

문서 평가

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